@etus/seven-skill 0.1.0-beta.3 → 0.1.0-beta.4

package/cli/engine/registry/seven-antipatterns.mjs

@@ -41,7 +41,7 @@ const ANTIPATTERNS = [
     category: 'quality',
     name: 'Raw Tailwind palette color',
     description:
-      'A Tailwind default-palette color utility (bg-green-500, text-neutral-900, border-red-200, ring-blue-500). The palette paints a color that bypasses @etus/tokens exactly as a hex literal does. Use a Seven color token via bg-[color:var(--*)] or the equivalent utility.',
+      'A Tailwind default-palette color utility (bg-green-500, text-neutral-900, border-red-200, ring-blue-500). The palette paints a color that bypasses @etus/tokens exactly as a hex literal does. Use a Seven color token through a typed arbitrary-value utility or its semantic equivalent.',
     skillReference: 'reference/color-and-contrast.md',
   },
   {
@@ -57,7 +57,7 @@ const ANTIPATTERNS = [
     category: 'quality',
     name: 'Missing Tailwind v4 length type hint',
     description:
-      'A Tailwind v4 text-[var(--*)] arbitrary value resolving to a length is missing the length: hint. Lightning CSS drops the unhinted value silently.',
+      'A Tailwind v4 arbitrary text utility backed by a CSS variable that resolves to a length is missing the length type hint. Lightning CSS drops the unhinted value silently.',
     skillReference: 'reference/color-and-contrast.md',
   },
   {
@@ -65,7 +65,7 @@ const ANTIPATTERNS = [
     category: 'quality',
     name: 'leading-none with arbitrary length var',
     description:
-      'leading-none combined with text-[length:var(--*)] zeroes line-height in Tailwind v4. Use leading-tight, leading-snug, a literal leading-[1.1], or inline style.',
+      'leading-none combined with a typed length-variable text utility zeroes line-height in Tailwind v4. Use leading-tight, leading-snug, an explicit line-height, or inline style.',
     skillReference: 'reference/typography.md',
   },
   {
@@ -92,6 +92,102 @@ const ANTIPATTERNS = [
       'Pure #000 or #fff. Seven uses tinted neutrals from the OKLCH ramp; pure black and white read as harsh and unrefined.',
     skillReference: 'reference/color-and-contrast.md',
   },
+  {
+    id: 'broken-image',
+    category: 'quality',
+    name: 'Broken or placeholder image',
+    description:
+      'An image has no usable source, still points to a placeholder, or fails to load at runtime. Use a real asset with dimensions and useful alternative text, provide a fallback, or remove it.',
+    skillReference: 'reference/audit.md',
+  },
+  {
+    id: 'script-error',
+    category: 'quality',
+    name: 'Uncaught script error',
+    description:
+      'JavaScript threw while the page loaded. Broken scripts can disable interactions, data, and reveal logic; fix the runtime error before evaluating the interface.',
+    skillReference: 'reference/audit.md',
+  },
+  {
+    id: 'content-hidden-at-rest',
+    category: 'quality',
+    name: 'Content invisible at rest',
+    description:
+      'A material share of product content remains at opacity zero or hidden after reveal handlers had an opportunity to run. Content must exist visibly by default and animation may enhance it.',
+    skillReference: 'reference/audit.md',
+  },
+  {
+    id: 'edge-flush-cards',
+    category: 'quality',
+    name: 'Cards flush against a scroller edge',
+    description:
+      'A rounded card inside a horizontal scroller loses its inset and is clipped against the viewport edge. Preserve a consistent gutter on both sides.',
+    skillReference: 'reference/spatial-design.md',
+  },
+  {
+    id: 'text-occlusion',
+    category: 'quality',
+    name: 'Text occluded by another layer',
+    description:
+      'Readable text is painted under an unrelated opaque element. Reserve layout space for overlapping layers or move the text outside the overlap.',
+    skillReference: 'reference/audit.md',
+  },
+  {
+    id: 'heading-rhythm',
+    category: 'quality',
+    name: 'Heading bound to the previous block',
+    description:
+      'A heading has no stronger separation from the previous content than from the content it introduces. Increase the space above while keeping the heading grouped with its section.',
+    skillReference: 'reference/typography.md',
+  },
+  {
+    id: 'text-overflow',
+    category: 'quality',
+    name: 'Text overflowing its container',
+    description:
+      'Rendered text exceeds its available box without an intentional scroll region. Let it wrap, constrain it with a supported pattern, or provide an explicit overflow affordance.',
+    skillReference: 'reference/audit.md',
+  },
+  {
+    id: 'clipped-overflow-container',
+    category: 'quality',
+    name: 'Positioned child clipped by overflow',
+    description:
+      'An overflow-hidden or clipped container cuts off a positioned non-decorative child such as a menu, tooltip, or popover. Move the layer to a portal or remove the unintended clip.',
+    skillReference: 'reference/audit.md',
+  },
+  {
+    id: 'design-system-font',
+    category: 'quality',
+    name: 'Font outside Seven',
+    description:
+      'Rendered or authored UI uses a font outside the exact installed Seven typography catalog. Use Inter for product text and JetBrains Mono for code/data.',
+    skillReference: 'reference/typography.md',
+  },
+  {
+    id: 'design-system-color',
+    category: 'quality',
+    name: 'Color outside Seven',
+    description:
+      'A rendered or authored UI color does not resolve to the exact installed Seven color catalog. Use an @etus/tokens CSS variable; do not create a consumer visual palette.',
+    skillReference: 'reference/color-and-contrast.md',
+  },
+  {
+    id: 'design-system-radius',
+    category: 'quality',
+    name: 'Radius outside Seven',
+    description:
+      'A rendered or authored radius is outside the exact installed Seven component, surface, and pill scales.',
+    skillReference: 'reference/spatial-design.md',
+  },
+  {
+    id: 'design-system-font-size',
+    category: 'quality',
+    name: 'Font size outside Seven',
+    description:
+      'A rendered or authored font size is outside the exact installed Seven typography ramp.',
+    skillReference: 'reference/typography.md',
+  },
 
   // ── Inverted / retuned for Seven ─────────────────────────────────────────
   {
@@ -306,6 +402,178 @@ const ANTIPATTERNS = [
       'An em-dash or en-dash in user-facing copy. Seven copy uses a comma, a colon, or a sentence break; the long dash reads as machine-generated prose.',
     skillReference: 'reference/ux-writing.md',
   },
+
+  // ── Current Impeccable signals, constrained to Seven ────────────────────
+  // These rules preserve useful cross-product quality signals from the pinned
+  // upstream release. They never authorize a visual value outside Seven.
+  {
+    id: 'pulsing-dot',
+    category: 'slop',
+    name: 'Decorative pulsing status dot',
+    description:
+      'A small round indicator pulses without representing genuinely changing live data. Use the Seven status component in a static state unless the product state is actually live.',
+    skillReference: 'reference/motion-design.md',
+  },
+  {
+    id: 'blinking-cursor',
+    category: 'slop',
+    name: 'Decorative blinking cursor',
+    description:
+      'A fake caret or prompt cursor blinks outside an editable control. Real inputs own their caret; decorative typing chrome adds distraction without product meaning.',
+    skillReference: 'reference/motion-design.md',
+  },
+  {
+    id: 'shape-assembled-illustration',
+    category: 'slop',
+    name: 'Shape-assembled illustration',
+    description:
+      'A large pictorial inline SVG is assembled from many primitive shapes as placeholder artwork. Use a real approved asset; keep inline SVG for Lucide icons, logos, and data graphics.',
+    skillReference: 'reference/brand.md',
+  },
+  {
+    id: 'radial-halo',
+    category: 'slop',
+    name: 'Decorative radial halo',
+    description:
+      'A chromatic radial gradient fades to transparent as a decorative background glow. Seven surfaces use declared solid tokens and intentional imagery, not synthetic glow washes.',
+    skillReference: 'reference/color-and-contrast.md',
+  },
+  {
+    id: 'marquee',
+    category: 'slop',
+    name: 'Auto-scrolling marquee',
+    description:
+      'Content scrolls continuously without user control. Let users read at their own pace and reserve motion for state changes or explicit interaction.',
+    skillReference: 'reference/motion-design.md',
+  },
+  {
+    id: 'icon-tile-stack',
+    category: 'slop',
+    name: 'Icon tile stacked above heading',
+    description:
+      'A rounded-square icon tile is repeated directly above a heading as generic feature-card scaffolding. Compose Seven icons and text according to the product hierarchy instead.',
+    skillReference: 'reference/spatial-design.md',
+  },
+  {
+    id: 'numbered-section-labels',
+    category: 'slop',
+    name: 'Tiny numbered section labels',
+    description:
+      'Several sections repeat tiny numeric labels next to their headings instead of relying on meaningful hierarchy. Use numbered structure only when sequence is product information.',
+    skillReference: 'reference/typography.md',
+  },
+  {
+    id: 'marketing-buzzword',
+    category: 'slop',
+    name: 'Generic marketing buzzword',
+    description:
+      'Generic claims such as streamline, empower, world-class, enterprise-grade, and next-generation replace specific product meaning. State the concrete job and outcome in pt-BR.',
+    skillReference: 'reference/ux-writing.md',
+  },
+  {
+    id: 'aphoristic-cadence',
+    category: 'slop',
+    name: 'Repeated aphoristic copy cadence',
+    description:
+      'Three or more short contrast constructions such as “Não X. Y.” create generated-copy cadence. Use direct product language and vary sentence structure naturally.',
+    skillReference: 'reference/ux-writing.md',
+  },
+  {
+    id: 'oversized-h1',
+    category: 'slop',
+    name: 'Oversized long headline',
+    description:
+      'A long headline uses a display size that consumes most of the first viewport. Shorten the copy or use the appropriate Seven heading step for its length.',
+    skillReference: 'reference/typography.md',
+  },
+  {
+    id: 'extreme-negative-tracking',
+    category: 'slop',
+    name: 'Crushed letter spacing',
+    description:
+      'Letter spacing is pulled below -0.075em and damages character recognition. Use the declared Seven tracking and typography tokens.',
+    skillReference: 'reference/typography.md',
+  },
+  {
+    id: 'first-viewport-column-overflow',
+    category: 'quality',
+    name: 'Unbalanced opening columns',
+    description:
+      'One column in the opening multi-column region extends far beyond the first viewport while its sibling ends near the fold. Rebalance the composition or let long content flow below it.',
+    skillReference: 'reference/spatial-design.md',
+  },
+  {
+    id: 'undersized-ui-text',
+    category: 'quality',
+    name: 'Undersized functional text',
+    description:
+      'Interactive or content-bearing UI text renders below 11px. A token cannot legitimize unreadable functional text; use an appropriate Seven typography step.',
+    skillReference: 'reference/typography.md',
+  },
+  {
+    id: 'repeated-container-text',
+    category: 'quality',
+    name: 'Repeated text inside one container',
+    description:
+      'The same meaningful text appears three or more times in distinct positions inside one card or panel. Keep the message in the single slot where it carries the most meaning.',
+    skillReference: 'reference/ux-writing.md',
+  },
+  {
+    id: 'gpt-thin-border-wide-shadow',
+    category: 'slop',
+    name: 'Hairline border with wide shadow',
+    description:
+      'A thin edge is paired with a wide diffuse shadow. Seven uses borders for hierarchy and reserves elevation shadows for overlays; do not combine both as card decoration.',
+    skillReference: 'reference/spatial-design.md',
+  },
+  {
+    id: 'repeating-stripes-gradient',
+    category: 'slop',
+    name: 'Repeating-gradient stripes',
+    description:
+      'Repeating CSS gradients create decorative stripes without product meaning. Use a declared Seven surface or an approved brand asset.',
+    skillReference: 'reference/color-and-contrast.md',
+  },
+  {
+    id: 'codex-grid-background',
+    category: 'slop',
+    name: 'Decorative grid-line background',
+    description:
+      'Two tiled linear gradients draw a decorative grid outside a canvas, map, blueprint, or measurement surface. Use product structure or a Seven surface token instead.',
+    skillReference: 'reference/spatial-design.md',
+  },
+  {
+    id: 'theater-slop-phrase',
+    category: 'slop',
+    name: 'Theater framing copy',
+    description:
+      'Copy dismisses a feature or process as “theater” instead of explaining what it does or does not do. Replace the rhetorical framing with a concrete product statement.',
+    skillReference: 'reference/ux-writing.md',
+  },
+  {
+    id: 'image-hover-transform',
+    category: 'slop',
+    name: 'Decorative image hover transform',
+    description:
+      'An image scales or rotates on hover without an interaction requirement. Keep imagery stable unless the motion communicates an actual Seven interaction state.',
+    skillReference: 'reference/motion-design.md',
+  },
+  {
+    id: 'sidebar-topbar-shell',
+    category: 'quality',
+    name: 'Invalid Sidebar + Topbar shell',
+    description:
+      'A Seven application shell is not the canonical L-shaped composition. Sidebar and SidebarInset must be siblings under one SidebarProvider; the shell Topbar must be the first chrome child inside SidebarInset, remain borderless/shadowless, start at the sidebar edge, expose a visible SidebarTrigger on mobile unless collapsible="none", and collapse mobile chrome without overflowing TopbarLeading.',
+    skillReference: 'reference/app-shell.md',
+  },
+  {
+    id: 'sidebar-rail-behavior',
+    category: 'quality',
+    name: 'Invalid Sidebar Rail behavior',
+    description:
+      'A dual Seven Rail is missing the interaction contract. Every SidebarRailButton needs a stable label, navigation links must use asChild instead of nesting interactive elements, the Rail expands as a 64→200px overlay without moving the 216px panel, and the mobile Sheet must expose the full panel independently from desktop collapse.',
+    skillReference: 'reference/app-shell.md',
+  },
 ]
 
 /**
@@ -331,6 +599,8 @@ const TEXT_RULE_IDS = new Set([
 
 /** Element/page rules the static-html cascade can resolve. */
 const STATIC_HTML_RULE_IDS = new Set([
+  'broken-image',
+  'clipped-overflow-container',
   'side-stripe-border',
   'gradient-text-decorative',
   'shadows-not-borders',
@@ -355,6 +625,45 @@ const STATIC_HTML_RULE_IDS = new Set([
   'pill-on-button',
   'radius-mixed-scales',
   'non-lucide-icon',
+  'pulsing-dot',
+  'blinking-cursor',
+  'shape-assembled-illustration',
+  'radial-halo',
+  'marquee',
+  'icon-tile-stack',
+  'numbered-section-labels',
+  'marketing-buzzword',
+  'aphoristic-cadence',
+  'oversized-h1',
+  'extreme-negative-tracking',
+  'undersized-ui-text',
+  'repeated-container-text',
+  'gpt-thin-border-wide-shadow',
+  'repeating-stripes-gradient',
+  'codex-grid-background',
+  'theater-slop-phrase',
+  'image-hover-transform',
+  'sidebar-topbar-shell',
+  'sidebar-rail-behavior',
+])
+
+const BROWSER_RUNTIME_RULE_IDS = new Set([
+  'broken-image',
+  'script-error',
+  'content-hidden-at-rest',
+  'edge-flush-cards',
+  'text-occlusion',
+  'heading-rhythm',
+  'text-overflow',
+  'clipped-overflow-container',
+  'design-system-font',
+  'design-system-color',
+  'design-system-radius',
+  'design-system-font-size',
+  'first-viewport-column-overflow',
+  'undersized-ui-text',
+  'repeated-container-text',
+  'gpt-thin-border-wide-shadow',
 ])
 
 const RULE_ENGINE_SUPPORT = {
@@ -364,7 +673,7 @@ const RULE_ENGINE_SUPPORT = {
   'static-html': new Set([...TEXT_RULE_IDS, ...STATIC_HTML_RULE_IDS]),
   // The browser engine extracts rendered markup + stylesheet text and runs
   // the same text + static-html checks against the rendered document.
-  browser: new Set([...TEXT_RULE_IDS, ...STATIC_HTML_RULE_IDS]),
+  browser: new Set([...TEXT_RULE_IDS, ...STATIC_HTML_RULE_IDS, ...BROWSER_RUNTIME_RULE_IDS]),
 }
 
 /**
@@ -387,6 +696,18 @@ const RULE_EXEMPTIONS = {
   'fuchsia-in-ui-chrome': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: [] },
   'pt-pt-vocab': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: [] },
   'pure-black-or-white': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: TOKEN_DEFINITION_PATH_SEGMENTS },
+  'broken-image': NO_EXEMPTION,
+  'script-error': NO_EXEMPTION,
+  'content-hidden-at-rest': NO_EXEMPTION,
+  'edge-flush-cards': NO_EXEMPTION,
+  'text-occlusion': NO_EXEMPTION,
+  'heading-rhythm': NO_EXEMPTION,
+  'text-overflow': NO_EXEMPTION,
+  'clipped-overflow-container': NO_EXEMPTION,
+  'design-system-font': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: [] },
+  'design-system-color': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: TOKEN_DEFINITION_PATH_SEGMENTS },
+  'design-system-radius': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: TOKEN_DEFINITION_PATH_SEGMENTS },
+  'design-system-font-size': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: TOKEN_DEFINITION_PATH_SEGMENTS },
   // Inverted / retuned.
   'side-stripe-border': NO_EXEMPTION,
   'gradient-text-decorative': NO_EXEMPTION,
@@ -417,6 +738,27 @@ const RULE_EXEMPTIONS = {
   // Emoji and the long dash legitimately appear in audit/proposal prose.
   'emoji-in-chrome': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: DOC_PATH_SEGMENTS },
   'forbidden-em-dash': { skipPackages: new Set(), skipPathSegments: [...TOKEN_DEFINITION_PATH_SEGMENTS, ...DOC_PATH_SEGMENTS] },
+  'pulsing-dot': NO_EXEMPTION,
+  'blinking-cursor': NO_EXEMPTION,
+  'shape-assembled-illustration': NO_EXEMPTION,
+  'radial-halo': NO_EXEMPTION,
+  'marquee': NO_EXEMPTION,
+  'icon-tile-stack': NO_EXEMPTION,
+  'numbered-section-labels': NO_EXEMPTION,
+  'marketing-buzzword': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: DOC_PATH_SEGMENTS },
+  'aphoristic-cadence': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: DOC_PATH_SEGMENTS },
+  'oversized-h1': NO_EXEMPTION,
+  'extreme-negative-tracking': NO_EXEMPTION,
+  'first-viewport-column-overflow': NO_EXEMPTION,
+  'undersized-ui-text': NO_EXEMPTION,
+  'repeated-container-text': NO_EXEMPTION,
+  'gpt-thin-border-wide-shadow': NO_EXEMPTION,
+  'repeating-stripes-gradient': NO_EXEMPTION,
+  'codex-grid-background': NO_EXEMPTION,
+  'theater-slop-phrase': { skipPackages: SEVEN_INTERNAL_PACKAGES, skipPathSegments: DOC_PATH_SEGMENTS },
+  'image-hover-transform': NO_EXEMPTION,
+  'sidebar-topbar-shell': NO_EXEMPTION,
+  'sidebar-rail-behavior': NO_EXEMPTION,
 }
 
 /**
@@ -437,6 +779,10 @@ const RULE_GROUNDING = {
   'radius-mixed-scales': { grounding: 'token', reason: 'Component and surface radius tiers derived from the radius tokens.' },
   'pill-on-button': { grounding: 'token', reason: 'Pill threshold anchored on the full-radius token.' },
   'bounce-easing': { grounding: 'token', reason: 'Exempts cubic-beziers that match a sanctioned easing token.' },
+  'design-system-font': { grounding: 'token', reason: 'Allowed rendered families come from the exact Seven token snapshot.' },
+  'design-system-color': { grounding: 'token', reason: 'Allowed rendered colors resolve from the exact Seven color variables.' },
+  'design-system-radius': { grounding: 'token', reason: 'Allowed radii come from the exact Seven radius snapshot.' },
+  'design-system-font-size': { grounding: 'token', reason: 'Allowed font sizes come from the exact Seven typography snapshot.' },
   // Heuristic — no token defines the rule.
   'missing-color-type-hint': { grounding: 'heuristic', reason: 'Tailwind v4 / Lightning CSS mechanic.' },
   'missing-length-type-hint': { grounding: 'heuristic', reason: 'Tailwind v4 / Lightning CSS mechanic.' },
@@ -465,6 +811,35 @@ const RULE_GROUNDING = {
   'non-lucide-icon': { grounding: 'heuristic', reason: 'SVG attribute shape (24x24 viewBox, 2px stroke).' },
   'emoji-in-chrome': { grounding: 'heuristic', reason: 'Unicode emoji ranges in chrome text.' },
   'forbidden-em-dash': { grounding: 'heuristic', reason: 'Character rule — em-dash / en-dash in copy.' },
+  'broken-image': { grounding: 'heuristic', reason: 'Source and browser image loading state.' },
+  'script-error': { grounding: 'heuristic', reason: 'Browser pageerror events captured during page load.' },
+  'content-hidden-at-rest': { grounding: 'heuristic', reason: 'Rendered-text visibility after a bounded reveal sweep.' },
+  'edge-flush-cards': { grounding: 'heuristic', reason: 'Rendered scroller inset and rounded-child geometry.' },
+  'text-occlusion': { grounding: 'heuristic', reason: 'Paint-order sampling over rendered text geometry.' },
+  'heading-rhythm': { grounding: 'heuristic', reason: 'Rendered space above and below section headings.' },
+  'text-overflow': { grounding: 'heuristic', reason: 'Rendered scroll and client geometry for direct text owners.' },
+  'clipped-overflow-container': { grounding: 'heuristic', reason: 'Overflow clipping plus positioned-child geometry.' },
+  'pulsing-dot': { grounding: 'heuristic', reason: 'Small round element combined with an infinite pulse animation.' },
+  'blinking-cursor': { grounding: 'heuristic', reason: 'Blink animation on a caret-like non-editable element.' },
+  'shape-assembled-illustration': { grounding: 'heuristic', reason: 'Large pictorial SVG assembled from many primitive shapes.' },
+  'radial-halo': { grounding: 'heuristic', reason: 'Chromatic radial-gradient fading to transparent as decoration.' },
+  'marquee': { grounding: 'heuristic', reason: 'Legacy marquee or infinite horizontal travel animation.' },
+  'icon-tile-stack': { grounding: 'heuristic', reason: 'Repeated rounded icon tile directly preceding a heading.' },
+  'numbered-section-labels': { grounding: 'heuristic', reason: 'Repeated tiny numeric labels adjacent to section headings.' },
+  'marketing-buzzword': { grounding: 'heuristic', reason: 'Curated generic marketing phrase vocabulary.' },
+  'aphoristic-cadence': { grounding: 'heuristic', reason: 'Repeated short contrast sentence construction.' },
+  'oversized-h1': { grounding: 'heuristic', reason: 'Headline length combined with rendered or authored display size.' },
+  'extreme-negative-tracking': { grounding: 'heuristic', reason: 'Legibility threshold below -0.075em letter spacing.' },
+  'first-viewport-column-overflow': { grounding: 'heuristic', reason: 'Rendered opening-column geometry relative to the viewport.' },
+  'undersized-ui-text': { grounding: 'heuristic', reason: 'Functional-text readability floor of 11px.' },
+  'repeated-container-text': { grounding: 'heuristic', reason: 'Same meaningful text repeated in distinct slots of one container.' },
+  'gpt-thin-border-wide-shadow': { grounding: 'heuristic', reason: 'Hairline border combined with a diffuse wide shadow.' },
+  'repeating-stripes-gradient': { grounding: 'heuristic', reason: 'Repeating CSS gradient used as surface decoration.' },
+  'codex-grid-background': { grounding: 'heuristic', reason: 'Two-axis tiled hairline gradients outside grid-meaningful surfaces.' },
+  'theater-slop-phrase': { grounding: 'heuristic', reason: 'Generated-copy phrase pattern using theater as rhetorical dismissal.' },
+  'image-hover-transform': { grounding: 'heuristic', reason: 'Scale or rotate transform applied to imagery on hover.' },
+  'sidebar-topbar-shell': { grounding: 'heuristic', reason: 'Seven-specific component ancestry, mobile trigger, chrome style, and rendered L-geometry contract.' },
+  'sidebar-rail-behavior': { grounding: 'heuristic', reason: 'Seven-specific Rail labels, interactive-element composition, mobile state, and rendered overlay contract.' },
 }
 
 export function getRuleGrounding(id) {