@nurix/etna 0.19.10 → 0.19.12

package/data/harnesses/code/skills/design/design-md/library/slack.md

@@ -0,0 +1,202 @@
+---
+schema: design-md/v2
+id: slack
+tier: brand
+segments: [collaboration, messaging]
+keywords: [vibrant, rounded, aubergine, friendly, conversational]
+sourced: 2026-07-12
+sources: "design-md/v1 slack entry (2026-07-04); 2026-07-12 re-audit of slack.com public identity. Proprietary Slack display/UI faces substituted with Lato (v1-documented humanist stand-in); mono is JetBrains Mono (v1-named)."
+license: open
+---
+
+# slack — an office common room with a plum feature wall
+
+## 1 Visual Theme
+An office common room mid-morning: white walls, warm chatter, rounded furniture, and
+one deep-aubergine feature wall where the noticeboard lives. Light by default; the
+content canvas is white with hairline hierarchy, flat, with a friendlier radius than
+a terminal. The one deliberate exception to the light polarity is the brand's most
+enduring asset — the aubergine `sidebar`, a categorically dark rail carrying light
+text in both themes. Density standard, nudged a hair toward comfort.
+
+## 2 Color Roles
+Near-black `foreground` on white; a single accent — aubergine `primary` — reserved
+for the one action that matters, plus the rail. Lavender `accent` tints selected and
+hovered rows; blue is a functional inline-link color, never a chrome or CTA hue.
+Status hues (`destructive` rust, `success` green, `warning` amber) speak only status.
+The Slack logo quad (blue, green, yellow, red) lives exclusively in `chart-2..5`.
+Aubergine is a surface and CTA color, never a type color.
+
+## 3 Typography
+Lato (UI, body, headings) / JetBrains Mono (IDs, codes, timestamps). The humanist
+face carries Slack's warmth at UI sizes; heading weight, not a second family, carries
+emphasis. Body rides a relaxed 1.5 leading — legible without going airy. Register
+scope: no display face — hero-scale display stays on marketing; mono owns data.
+Numeric columns render `tabular-nums`; bump weight one step for emphasis, never size.
+
+## 4 Component Stylings
+The primary CTA is the one pill — filled aubergine `primary`, bold label; every other
+control sits on the `radius-md` workhorse. Secondary buttons take the lavender
+`secondary` fill; ghost hovers tint `accent`. Inputs hairline `border` with the
+aubergine `ring` at focus. Cards hairline on `card`, soft shadow only when lifting.
+Table rows hairline grid, `muted` hover, lavender `accent` selection. The sidebar is
+the aubergine rail: active item a `sidebar-primary` band, hover the subtler
+`sidebar-accent`. Detail opens in the side panel. Badges hairline, uppercase caption,
+status fills only.
+
+## 5 Layout
+4px base with 8px as the dominant step — Slack's relaxed rhythm; sidebar 256/56px;
+topbar 56px; side panel 420/640px; content max 1280px; forms cap comfortably; tables
+full-width.
+
+## 6 Depth
+Flat on the light canvas; the aubergine rail is a fixed dark plane, not an elevation —
+its prominence is the surface-polarity split, never shadow. Hairlines carry
+structure; overlays earn a soft aubergine-tinted shadow. Dark: the authored ladder —
+`background` 0.19 L, `surface-raised` +0.05, `surface-overlay` +0.10, hue held at
+327 — while the rail stays one step deeper than the canvas.
+
+## 7 Motion
+Friendly but businesslike — soft fades, no bounce. Named moments: `thread-open` (side
+panel, 260ms, interruptible), `row-arrive` (list content, 180ms fade), `pill-press`
+(primary action, 120ms). Physicality is granted only to onboarding and first-run
+empty states. Nothing animates in tables, message lists, or keyboard-initiated
+actions.
+
+## 8 Iconography & Charts
+Lucide, 1.5px stroke, 16/20px grid, `muted-foreground` default. Charts: hairline
+axes, no gridline fills; the categorical ramp is aubergine then the logo quad —
+blue, green, yellow, red (`chart-1..5`), the one place the quad appears; tooltips on
+`surface-overlay` with mono numerals.
+
+## 9 Voice
+A friendly colleague, not a mascot: contractions welcome, celebration restrained to
+moments the user earned. "Send to channel" · "You're all caught up — nothing new
+since 9:14" · "That channel name is taken; try adding your team's name."
+
+## 10 Do's & Don'ts
+Do keep the aubergine `sidebar` in both themes — light-on-aubergine is by design. Do
+give only the primary CTA the pill; everything else stays on the workhorse radius.
+Do scope blue to inline links. Don't promote a third accent — aubergine plus
+link-blue is exhaustive. Don't set aubergine body text. Don't bring pastel-mesh
+gradients or hero display onto an operator surface; don't pill anything but the CTA.
+
+## 11 Responsive
+375: the aubergine rail → off-canvas drawer, side panel → full sheet, list+detail
+stacks. 768: rail collapses to the icon rail; tables scroll overflow. 1024/1440:
+rail expands, two-pane queue+detail holds; forms cap, dashboards full width.
+
+## 12 Agent Prompt Guide
+Keep the rail aubergine and everything else light. Accent only the primary action;
+if two things want aubergine, one is not primary. Blue is for links, not buttons.
+The pill belongs to the CTA alone. Every numeric column tabular, every ID mono.
+Dark is authored — consult the block, never derive.
+
+```yaml design-values
+color:
+  light:
+    background: oklch(0.99 0.005 308)
+    foreground: oklch(0.23 0.006 308)
+    card: oklch(0.995 0.005 308)
+    card-foreground: oklch(0.23 0.006 308)
+    popover: oklch(0.995 0.005 308)
+    popover-foreground: oklch(0.23 0.006 308)
+    primary: oklch(0.306 0.108 327)
+    primary-foreground: oklch(0.98 0.008 327)
+    secondary: oklch(0.966 0.022 312)
+    secondary-foreground: oklch(0.3 0.1 327)
+    muted: oklch(0.965 0.006 308)
+    muted-foreground: oklch(0.5 0.012 308)
+    accent: oklch(0.966 0.022 312)
+    accent-foreground: oklch(0.3 0.1 327)
+    destructive: oklch(0.571 0.182 36)
+    destructive-foreground: oklch(0.99 0.006 36)
+    success: oklch(0.514 0.106 167)
+    warning: oklch(0.666 0.157 58)
+    border: oklch(0.925 0.005 308)
+    input: oklch(0.925 0.005 308)
+    ring: oklch(0.374 0.136 323)
+    surface-raised: oklch(0.99 0.005 308)
+    surface-overlay: oklch(0.995 0.005 308)
+    chart-1: oklch(0.306 0.108 327)
+    chart-2: oklch(0.768 0.13 223)
+    chart-3: oklch(0.691 0.142 160)
+    chart-4: oklch(0.797 0.152 83)
+    chart-5: oklch(0.588 0.222 11.5)
+    sidebar: oklch(0.306 0.108 327)
+    sidebar-foreground: oklch(0.94 0.02 327)
+    sidebar-primary: oklch(0.374 0.136 323)
+    sidebar-primary-foreground: oklch(0.97 0.015 323)
+    sidebar-accent: oklch(0.36 0.1 327)
+    sidebar-accent-foreground: oklch(0.95 0.015 327)
+    sidebar-border: oklch(0.4 0.09 327)
+    sidebar-ring: oklch(0.85 0.05 323)
+  dark:
+    background: oklch(0.19 0.012 327)
+    foreground: oklch(0.93 0.008 327)
+    card: oklch(0.23 0.012 327)
+    card-foreground: oklch(0.93 0.008 327)
+    popover: oklch(0.29 0.014 327)
+    popover-foreground: oklch(0.93 0.008 327)
+    primary: oklch(0.42 0.12 327)
+    primary-foreground: oklch(0.97 0.01 327)
+    secondary: oklch(0.27 0.014 327)
+    secondary-foreground: oklch(0.9 0.01 327)
+    muted: oklch(0.26 0.014 327)
+    muted-foreground: oklch(0.7 0.015 327)
+    accent: oklch(0.3 0.05 327)
+    accent-foreground: oklch(0.93 0.01 327)
+    destructive: oklch(0.64 0.19 33)
+    destructive-foreground: oklch(0.14 0.02 33)
+    success: oklch(0.65 0.12 167)
+    warning: oklch(0.75 0.14 60)
+    border: oklch(0.31 0.014 327)
+    input: oklch(0.31 0.014 327)
+    ring: oklch(0.75 0.1 323)
+    surface-raised: oklch(0.24 0.012 327)
+    surface-overlay: oklch(0.29 0.014 327)
+    chart-1: oklch(0.62 0.13 327)
+    chart-2: oklch(0.768 0.13 223)
+    chart-3: oklch(0.691 0.142 160)
+    chart-4: oklch(0.797 0.152 83)
+    chart-5: oklch(0.62 0.2 12)
+    sidebar: oklch(0.25 0.09 327)
+    sidebar-foreground: oklch(0.93 0.015 327)
+    sidebar-primary: oklch(0.4 0.13 323)
+    sidebar-primary-foreground: oklch(0.97 0.012 323)
+    sidebar-accent: oklch(0.32 0.1 327)
+    sidebar-accent-foreground: oklch(0.95 0.012 327)
+    sidebar-border: oklch(0.36 0.09 327)
+    sidebar-ring: oklch(0.85 0.05 323)
+typography:
+  display: { family: "Lato", fallback: "system-ui, sans-serif", weights: [700] }
+  sans: { family: "Lato", fallback: "system-ui, sans-serif", weights: [400, 700] }
+  mono: { family: "JetBrains Mono Variable", fallback: "ui-monospace, Menlo, monospace", weights: [400] }
+  ramp:
+    display: { size: 28px, line: 36px, weight: 700, family: sans }
+    h1: { size: 24px, line: 31px, weight: 700, family: sans }
+    h2: { size: 18px, line: 25px, weight: 700, family: sans }
+    body: { size: 14px, line: 21px, weight: 400, family: sans }
+    small: { size: 13px, line: 18px, weight: 400, family: sans }
+    caption: { size: 12px, line: 14px, weight: 700, family: sans, tracking: 0.08em, transform: uppercase }
+    data: { size: 13px, line: 20px, weight: 400, family: mono, features: [tnum] }
+  register-scope: { sans: [chrome, controls, body, page-title], mono: [data, ids, timestamps] }
+elevation:
+  radius: { sm: 4px, md: 8px, lg: 12px, pill: 9999px }
+  hairline: border
+  shadow:
+    overlay: "0 8px 28px oklch(0.3 0.09 327 / 0.16)"
+    popover: "0 4px 14px oklch(0.3 0.09 327 / 0.12)"
+  dark-ladder: { background: 0.19, raised: 0.24, overlay: 0.29, hue-held: 327 }
+motion:
+  duration: { press: 120ms, fade: 180ms, panel: 260ms }
+  easing: { standard: "cubic-bezier(0.2, 0, 0, 1)", exit: "cubic-bezier(0.4, 0, 1, 1)" }
+  entrance-never: ease-in
+  identity-moments: [onboarding, first-run-empty]
+iconography: { set: lucide, stroke: 1.5px, grid: [16px, 20px] }
+charts:
+  categorical: [chart-1, chart-2, chart-3, chart-4, chart-5]
+  sequential: { from: background, to: chart-1 }
+  diverging: { negative: chart-5, mid: muted, positive: chart-3 }
+layout: { base: 4px, sidebar: [256px, 56px], topbar: 56px, side-panel: [420px, 640px], content-max: 1280px }
+```

package/data/harnesses/code/skills/design/design-md/library/spacex.md

@@ -0,0 +1,206 @@
+---
+schema: design-md/v2
+id: spacex
+tier: brand
+segments: [aerospace, mission-ops, telemetry]
+keywords: [black, achromatic, uppercase, condensed, dense, dark-default]
+sourced: 2026-07-12
+sources: "design-md/v1 spacex entry (2026-07-04); 2026-07-12 re-audit of spacex.com public identity. Proprietary D-DIN substituted with Barlow Semi Condensed (closest open condensed-industrial face; v1 fallback was Arial Narrow); mono is Space Mono (v1-named derived addition)."
+license: open
+---
+
+# spacex — a launch-control room at night
+
+## 1 Visual Theme
+A launch-control room at night: matte-black consoles edge to edge, telemetry etched
+in white condensed capitals, one guarded white GO button. Categorically dark — pure
+black `background` is the load-bearing brand fact, the one entry where the
+light-default floor legitimately yields; the light theme is the opt-in shop-surface
+inversion. Flat and shadowless: cards lift off pure black by the surface step and a
+cool hairline alone. There is no chromatic accent — the accent is achromatic white.
+Density is dense: a mission console, not a brochure.
+
+## 2 Color Roles
+White `foreground` on pure black; `primary` is white — the single achromatic accent
+carrying the one action, which inverts to white-on-black. Every neutral in the
+ladder holds a faint cool tint; only the canvas itself is allowed to be absolute.
+Selection lifts the near-black `accent`, it does not colour it. `ring` is white —
+maximally visible, keyboard-first. The telemetry set — `destructive` abort-red,
+`success` nominal-green, `warning` caution-amber — speaks only status and charts.
+
+## 3 Typography
+Barlow Semi Condensed (UI) / Space Mono (telemetry, IDs, timestamps). The brand
+jumps 400 → 700 with no mid weight. Titles and eyebrows are UPPERCASE with the
+signature *positive* tracking — the one operator brand that tracks out, not in; body
+carries a faint positive tracking so the whole system reads engineered. Register
+scope: display is the condensed face at 700 in caps only; mono owns every telemetry
+figure. Numeric columns render `tabular-nums`; emphasis is weight, never size.
+
+## 4 Component Stylings
+Buttons tight `radius-sm`, white `primary` fill with black label, UPPERCASE tracked;
+the 32px ghost pill — transparent, hairline, white caps — is reserved for a lone
+hero confirm (launch, deploy), never two side by side. Inputs on `card` with
+hairline `input` edge and the white `ring` at focus. Cards lift by the surface step
+plus hairline, never shadow. Table rows hairline grid, `muted` hover, `accent`
+selection, mono telemetry columns. Detail opens in the side panel. Badges hairline,
+UPPERCASE caption, status fills only.
+
+## 5 Layout
+4px base with the corpus's signature 18px step in button padding; sidebar 240/52px;
+topbar 52px; side panel 420/640px; content max 1440px — telemetry uses the full
+width. Density dense throughout; the museum negative space stays behind.
+
+## 6 Depth
+Zero-shadow flat. Elevation is the near-black surface ladder plus cool hairlines:
+canvas at absolute black, `surface-raised` and `card` one step up, `surface-overlay`
+a second step for floating chrome — even overlays prefer the hairline to a shadow.
+The dark ladder is authored — 0.0 → 0.13 → 0.20 L, cool hue held at 285. Light
+theme: same flat discipline on the white shop surface.
+
+## 7 Motion
+Near-instant, engineered — nothing eases languidly in a control room. Named moments:
+`state-latch` (status change, 80ms), `console-fade` (page content, 120ms),
+`panel-slide` (side panel, 200ms, interruptible). Physicality is granted only to the
+lone hero confirm. Nothing animates in telemetry tables or keyboard-initiated
+actions.
+
+## 8 Iconography & Charts
+Lucide, 1.5px stroke, 16/20px grid, `muted-foreground` default. Charts: hairline
+axes, no fills, no glow; the categorical ramp leads achromatic white then the
+telemetry set — nominal-green, caution-amber, abort-red, cool gray (`chart-1..5`);
+tooltips on `surface-overlay` with mono numerals.
+
+## 9 Voice
+Mission-control terse: systems language, no first person, every figure exact.
+"INITIATE TRANSFER" · "ALL SYSTEMS NOMINAL — NEXT WINDOW 04:32 UTC" · "ABORT
+CRITERIA MET: PRESSURE OUT OF BOUNDS ON LOOP B."
+
+## 10 Do's & Don'ts
+Do keep the canvas pure black — cards lift by the surface step plus hairline, never
+shadow. Do set titles and eyebrows UPPERCASE, condensed, positively tracked. Do
+carry telemetry in mono with tabular figures. Don't introduce a chromatic brand
+accent — black, white, and the telemetry hues are the entire palette. Don't render
+titles in sentence case. Don't pill operator controls — the 32px pill is the lone
+hero CTA only. Don't reach for a serif or humanist heading.
+
+## 11 Responsive
+375: sidebar → drawer, side panel → full sheet, h1 steps down first — the display
+shrinks before the data does. 768: sidebar collapses to the icon rail; tables scroll
+overflow. 1024/1440: console + detail holds side by side; telemetry takes the full
+width.
+
+## 12 Agent Prompt Guide
+Start from pure black and earn every step up the ladder. One accent, and it is
+white — if two things want it, one is not primary. UPPERCASE positive-tracked caps on
+every title and eyebrow. Every telemetry column mono and tabular. The ghost pill
+appears once or not at all. Light is the opt-in shop surface; dark is the identity —
+consult the block, never derive.
+
+```yaml design-values
+color:
+  light:
+    background: oklch(0.99 0.005 285)
+    foreground: oklch(0.13 0.008 285)
+    card: oklch(0.995 0.005 285)
+    card-foreground: oklch(0.13 0.008 285)
+    popover: oklch(0.995 0.005 285)
+    popover-foreground: oklch(0.13 0.008 285)
+    primary: oklch(0.13 0.008 285)
+    primary-foreground: oklch(0.99 0.005 285)
+    secondary: oklch(0.96 0.006 285)
+    secondary-foreground: oklch(0.2 0.01 285)
+    muted: oklch(0.955 0.006 285)
+    muted-foreground: oklch(0.48 0.012 285)
+    accent: oklch(0.94 0.008 285)
+    accent-foreground: oklch(0.2 0.01 285)
+    destructive: oklch(0.55 0.2 28)
+    destructive-foreground: oklch(0.99 0.005 28)
+    success: oklch(0.55 0.15 148)
+    warning: oklch(0.6 0.14 67)
+    border: oklch(0.909 0.011 286)
+    input: oklch(0.909 0.011 286)
+    ring: oklch(0.13 0.008 285)
+    surface-raised: oklch(0.985 0.005 285)
+    surface-overlay: oklch(0.995 0.005 285)
+    chart-1: oklch(0.25 0.01 285)
+    chart-2: oklch(0.55 0.15 148)
+    chart-3: oklch(0.6 0.14 67)
+    chart-4: oklch(0.55 0.2 28)
+    chart-5: oklch(0.55 0.04 285)
+    sidebar: oklch(0.97 0.006 285)
+    sidebar-foreground: oklch(0.15 0.01 285)
+    sidebar-primary: oklch(0.13 0.008 285)
+    sidebar-primary-foreground: oklch(0.99 0.005 285)
+    sidebar-accent: oklch(0.93 0.008 285)
+    sidebar-accent-foreground: oklch(0.18 0.01 285)
+    sidebar-border: oklch(0.9 0.01 285)
+    sidebar-ring: oklch(0.13 0.008 285)
+  dark:
+    background: oklch(0 0 0)
+    foreground: oklch(1 0 0)
+    card: oklch(0.15 0.006 285)
+    card-foreground: oklch(1 0 0)
+    popover: oklch(0.22 0.008 285)
+    popover-foreground: oklch(1 0 0)
+    primary: oklch(1 0 0)
+    primary-foreground: oklch(0 0 0)
+    secondary: oklch(0.24 0.015 285)
+    secondary-foreground: oklch(0.9 0.01 285)
+    muted: oklch(0.19 0.006 285)
+    muted-foreground: oklch(0.64 0.012 285)
+    accent: oklch(0.239 0.015 285)
+    accent-foreground: oklch(0.93 0.01 285)
+    destructive: oklch(0.663 0.224 28)
+    destructive-foreground: oklch(0.13 0.02 28)
+    success: oklch(0.77 0.224 145)
+    warning: oklch(0.782 0.171 67)
+    border: oklch(0.35 0.009 285)
+    input: oklch(0.35 0.009 285)
+    ring: oklch(1 0 0)
+    surface-raised: oklch(0.13 0.006 285)
+    surface-overlay: oklch(0.2 0.008 285)
+    chart-1: oklch(0.92 0.005 285)
+    chart-2: oklch(0.77 0.224 145)
+    chart-3: oklch(0.782 0.171 67)
+    chart-4: oklch(0.663 0.224 28)
+    chart-5: oklch(0.6 0.012 285)
+    sidebar: oklch(0.13 0.006 285)
+    sidebar-foreground: oklch(0.9 0.008 285)
+    sidebar-primary: oklch(1 0 0)
+    sidebar-primary-foreground: oklch(0 0 0)
+    sidebar-accent: oklch(0.21 0.01 285)
+    sidebar-accent-foreground: oklch(0.93 0.008 285)
+    sidebar-border: oklch(0.28 0.008 285)
+    sidebar-ring: oklch(1 0 0)
+typography:
+  display: { family: "Barlow Semi Condensed", fallback: "Arial Narrow, sans-serif", weights: [700] }
+  sans: { family: "Barlow Semi Condensed", fallback: "Arial Narrow, sans-serif", weights: [400, 700] }
+  mono: { family: "Space Mono", fallback: "ui-monospace, monospace", weights: [400] }
+  ramp:
+    display: { size: 28px, line: 31px, weight: 700, family: sans, tracking: 0.06em, transform: uppercase }
+    h1: { size: 24px, line: 26px, weight: 700, family: sans, tracking: 0.06em, transform: uppercase }
+    h2: { size: 18px, line: 22px, weight: 700, family: sans, tracking: 0.06em, transform: uppercase }
+    body: { size: 14px, line: 21px, weight: 400, family: sans, tracking: 0.01em }
+    small: { size: 13px, line: 18px, weight: 400, family: sans }
+    caption: { size: 12px, line: 17px, weight: 400, family: sans, tracking: 0.08em, transform: uppercase }
+    data: { size: 13px, line: 18px, weight: 400, family: mono, features: [tnum] }
+  register-scope: { sans: [chrome, controls, body, page-title], mono: [data, ids, timestamps, telemetry] }
+elevation:
+  radius: { sm: 2px, md: 4px, lg: 8px, pill: 32px }
+  hairline: border
+  shadow:
+    overlay: "0 4px 16px oklch(0.1 0.008 285 / 0.5)"
+    popover: "0 2px 8px oklch(0.1 0.008 285 / 0.4)"
+  dark-ladder: { background: 0.0, raised: 0.13, overlay: 0.2, hue-held: 285 }
+motion:
+  duration: { press: 80ms, fade: 120ms, panel: 200ms }
+  easing: { standard: "cubic-bezier(0.2, 0, 0, 1)", exit: "cubic-bezier(0.4, 0, 1, 1)" }
+  entrance-never: ease-in
+  identity-moments: [hero-confirm]
+iconography: { set: lucide, stroke: 1.5px, grid: [16px, 20px] }
+charts:
+  categorical: [chart-1, chart-2, chart-3, chart-4, chart-5]
+  sequential: { from: background, to: chart-1 }
+  diverging: { negative: destructive, mid: muted, positive: success }
+layout: { base: 4px, sidebar: [240px, 52px], topbar: 52px, side-panel: [420px, 640px], content-max: 1440px }
+```

package/data/harnesses/code/skills/design/design-md/library/spotify.md

@@ -0,0 +1,206 @@
+---
+schema: design-md/v2
+id: spotify
+tier: brand
+segments: [media, entertainment, content-ops]
+keywords: [near-black, green, dark-default, immersive, rounded]
+sourced: 2026-07-12
+sources: "design-md/v1 spotify entry (2026-07-04); 2026-07-12 re-audit of spotify.com public identity. Proprietary SpotifyMixUI/Circular substituted with DM Sans (closest open geometric face; v1 named Inter as corpus-adjacent); mono derived as Fira Mono (brand ships none)."
+license: open
+---
+
+# spotify — a listening booth after close
+
+## 1 Visual Theme
+A listening booth after close: matte near-black walls that swallow the light, felt
+surfaces stepping subtly brighter toward the console, one green-lit play button
+glowing in the dark. Dark by conviction — near-black, never pure black, is the
+identity, and surfaces step up by lightness rather than by line. Depth is
+shadow-carried, inverting the flat default, because on near-black a hairline all but
+vanishes. The light theme is the opt-in artist-dashboard reading. Density dense:
+dark compression, built for scanning.
+
+## 2 Color Roles
+White `foreground` on the near-black `background`; one accent — the signature green
+`primary` — carries the one action, active nav, and play, with black
+`primary-foreground` always (never white on green). Selection is a neutral surface
+lift (`accent`), never a green wash. On the otherwise achromatic field the green and
+the status hues are the only color — scarcity is doubly load-bearing. Announcement
+blue is `chart-2`, an info hue, never a second brand accent; the deeper green
+`success` is status, distinct from the bright accent.
+
+## 3 Typography
+DM Sans (UI, headings — the geometric voice, bold/regular binary) / Fira Mono (IDs,
+timestamps, amounts). Most text is 700 or 400; hierarchy comes from weight contrast,
+not size, and type stays compact, tuned for scanning. The uppercase wide-tracked
+label voice survives on eyebrows and section labels only — never on buttons.
+Register scope: no display face; mono owns every numeric column with
+`tabular-nums`.
+
+## 4 Component Stylings
+Buttons `radius-md`, green `primary` fill with black label, sentence case; icon-only
+controls stay circular — the one piece of pill-and-circle geometry that carries;
+badges and chips take the pill. Inputs sit on the `secondary` surface with an inset
+edge, green `ring` at focus. Cards hover by lightening a surface step, not by
+drawing a border. Table rows separate by surface-lightening or a subtle `border`,
+`accent` selection, mono numerals. Detail opens in the side panel.
+
+## 5 Layout
+8px base with a fine dense low end; sidebar 256/64px; topbar 64px — the generous
+search chrome; side panel 420/640px; content max 1336px. An optional persistent
+transport/status bar may run full-width at the bottom in a media tool. Density is
+dark compression throughout.
+
+## 6 Depth
+Shadow-carried: surfaces step by lightness and elevated chrome rides heavy
+green-tinted near-black shadows — the dramatic floating-in-darkness lift; inputs
+read as inset edges, never exposed gray lines. The dark ladder is authored — 0.18 →
+0.24 → 0.28 L, hue held at 155 with a whisper of green in every neutral. Light
+theme: flat hairline discipline, the darkness stays behind.
+
+## 7 Motion
+Smooth and unhurried, like a crossfade. Named moments: `surface-lift` (card hover
+lighten, 160ms), `panel-slide` (side panel, 240ms, interruptible), `play-press`
+(primary action, 100ms). Physicality is granted only to first-run onboarding and the
+empty-library state. Nothing animates in tables or keyboard-initiated actions.
+
+## 8 Iconography & Charts
+Lucide, 1.75px stroke, 16/20px grid, `muted-foreground` default; icon-only buttons
+circular. Charts: no gridline fills, axes lightened surface steps; categorical ramp
+green, blue, orange, pink-red, violet (`chart-1..5`); tooltips on `surface-overlay`
+with mono numerals.
+
+## 9 Voice
+Direct and rhythmic, a set list not a memo: short verbs, no hype, numbers plain.
+"Add to queue" · "Library empty — import your first catalog" · "That upload exceeds
+the track limit; split the batch to continue."
+
+## 10 Do's & Don'ts
+Do anchor on near-black and carry depth through shade variation and heavy shadow.
+Do keep black text on the green `primary` — never white. Do hold the bold/regular
+binary and compact type. Don't add a second brand color — blue, orange, and pink-red
+are status/chart roles. Don't use light surfaces as primary canvases in the dark
+theme. Don't full-pill buttons or drop uppercase tracking onto every label. Don't
+expose raw gray borders where a surface lift will do.
+
+## 11 Responsive
+375: sidebar → drawer (the nav-to-bottom-bar echo), side panel → full sheet, grids
+stack. 768: sidebar collapses to the icon rail; grid 3→2; tables scroll overflow.
+1024/1440: sidebar expands, grid opens 5→3, queue+detail holds side by side.
+
+## 12 Agent Prompt Guide
+Start in near-black darkness; surfaces step by lightness, never by exposed borders.
+One green, always: THE action, active nav, black on green. Depth is heavy shadow and
+surface-lightening — the flat default is inverted here. Compact type, weight-binary
+hierarchy, tabular mono numerals. Dark is the identity; light is the opt-in
+artist-dashboard reading — consult the block, never derive.
+
+```yaml design-values
+color:
+  light:
+    background: oklch(0.985 0.005 155)
+    foreground: oklch(0.2 0.008 155)
+    card: oklch(0.995 0.005 155)
+    card-foreground: oklch(0.2 0.008 155)
+    popover: oklch(0.995 0.005 155)
+    popover-foreground: oklch(0.2 0.008 155)
+    primary: oklch(0.77 0.212 149)
+    primary-foreground: oklch(0.15 0.015 149)
+    secondary: oklch(0.955 0.006 155)
+    secondary-foreground: oklch(0.25 0.01 155)
+    muted: oklch(0.955 0.006 155)
+    muted-foreground: oklch(0.47 0.01 155)
+    accent: oklch(0.94 0.03 152)
+    accent-foreground: oklch(0.22 0.05 152)
+    destructive: oklch(0.55 0.19 18)
+    destructive-foreground: oklch(0.99 0.005 18)
+    success: oklch(0.55 0.14 152)
+    warning: oklch(0.62 0.14 67)
+    border: oklch(0.92 0.006 155)
+    input: oklch(0.9 0.007 155)
+    ring: oklch(0.55 0.15 152)
+    surface-raised: oklch(0.99 0.005 155)
+    surface-overlay: oklch(0.995 0.005 155)
+    chart-1: oklch(0.6 0.17 149)
+    chart-2: oklch(0.55 0.13 254)
+    chart-3: oklch(0.65 0.14 67)
+    chart-4: oklch(0.6 0.15 16)
+    chart-5: oklch(0.55 0.13 300)
+    sidebar: oklch(0.97 0.005 155)
+    sidebar-foreground: oklch(0.22 0.01 155)
+    sidebar-primary: oklch(0.7 0.19 149)
+    sidebar-primary-foreground: oklch(0.13 0.015 149)
+    sidebar-accent: oklch(0.93 0.02 152)
+    sidebar-accent-foreground: oklch(0.24 0.02 152)
+    sidebar-border: oklch(0.92 0.006 155)
+    sidebar-ring: oklch(0.55 0.15 152)
+  dark:
+    background: oklch(0.18 0.005 155)
+    foreground: oklch(0.97 0.005 155)
+    card: oklch(0.22 0.005 155)
+    card-foreground: oklch(0.97 0.005 155)
+    popover: oklch(0.28 0.006 155)
+    popover-foreground: oklch(0.97 0.005 155)
+    primary: oklch(0.77 0.212 149)
+    primary-foreground: oklch(0.15 0.015 149)
+    secondary: oklch(0.25 0.006 155)
+    secondary-foreground: oklch(0.93 0.005 155)
+    muted: oklch(0.24 0.005 155)
+    muted-foreground: oklch(0.77 0.008 155)
+    accent: oklch(0.28 0.006 155)
+    accent-foreground: oklch(0.95 0.005 155)
+    destructive: oklch(0.708 0.159 16)
+    destructive-foreground: oklch(0.13 0.02 16)
+    success: oklch(0.689 0.187 149)
+    warning: oklch(0.792 0.163 67)
+    border: oklch(0.285 0.005 155)
+    input: oklch(0.32 0.006 155)
+    ring: oklch(0.77 0.212 149)
+    surface-raised: oklch(0.24 0.005 155)
+    surface-overlay: oklch(0.28 0.006 155)
+    chart-1: oklch(0.77 0.212 149)
+    chart-2: oklch(0.688 0.15 254)
+    chart-3: oklch(0.792 0.163 67)
+    chart-4: oklch(0.708 0.159 16)
+    chart-5: oklch(0.65 0.15 300)
+    sidebar: oklch(0.18 0.005 155)
+    sidebar-foreground: oklch(0.77 0.008 155)
+    sidebar-primary: oklch(0.77 0.212 149)
+    sidebar-primary-foreground: oklch(0.15 0.015 149)
+    sidebar-accent: oklch(0.24 0.005 155)
+    sidebar-accent-foreground: oklch(0.97 0.005 155)
+    sidebar-border: oklch(0.26 0.005 155)
+    sidebar-ring: oklch(0.77 0.212 149)
+typography:
+  display: { family: "DM Sans Variable", fallback: "system-ui, sans-serif", weights: [700] }
+  sans: { family: "DM Sans Variable", fallback: "system-ui, sans-serif", weights: [400, 700] }
+  mono: { family: "Fira Mono", fallback: "ui-monospace, monospace", weights: [400] }
+  ramp:
+    display: { size: 28px, line: 34px, weight: 700, family: sans }
+    h1: { size: 24px, line: 30px, weight: 700, family: sans }
+    h2: { size: 18px, line: 23px, weight: 700, family: sans }
+    body: { size: 14px, line: 20px, weight: 400, family: sans }
+    small: { size: 12px, line: 18px, weight: 400, family: sans }
+    caption: { size: 12px, line: 16px, weight: 700, family: sans, tracking: 0.1em, transform: uppercase }
+    data: { size: 13px, line: 20px, weight: 400, family: mono, features: [tnum] }
+  register-scope: { sans: [chrome, controls, body, page-title], mono: [data, ids, timestamps, amounts] }
+elevation:
+  radius: { sm: 4px, md: 8px, lg: 12px, pill: 9999px }
+  hairline: border
+  shadow:
+    elevated: "0 8px 8px oklch(0.08 0.01 155 / 0.3)"
+    overlay: "0 8px 24px oklch(0.08 0.01 155 / 0.5)"
+    popover: "0 4px 12px oklch(0.08 0.01 155 / 0.35)"
+  dark-ladder: { background: 0.18, raised: 0.24, overlay: 0.28, hue-held: 155 }
+motion:
+  duration: { press: 100ms, fade: 160ms, panel: 240ms }
+  easing: { standard: "cubic-bezier(0.2, 0, 0, 1)", exit: "cubic-bezier(0.4, 0, 1, 1)" }
+  entrance-never: ease-in
+  identity-moments: [first-run-onboarding, empty-library]
+iconography: { set: lucide, stroke: 1.75px, grid: [16px, 20px] }
+charts:
+  categorical: [chart-1, chart-2, chart-3, chart-4, chart-5]
+  sequential: { from: background, to: chart-1 }
+  diverging: { negative: chart-4, mid: muted, positive: chart-1 }
+layout: { base: 8px, sidebar: [256px, 64px], topbar: 64px, side-panel: [420px, 640px], content-max: 1336px }
+```