# Visual Grammar

## Semantic Color Roles

- `signal-info`: observational data (blue family)
- `signal-health`: stable/healthy state (green family)
- `signal-risk`: degraded/uncertain state (amber/red family)
- `signal-lineage`: historical substrate and inherited patterns (earth/violet accents)

## Hierarchy

1. Page intent (topbar + current mode)
2. Active decision context (selected project / bed)
3. Immediate controls (run/check/lock/graft/etc.)
4. Evidence detail (raw output, links, traces)

## Surface Rules

- Primary surfaces use high contrast and clear borders.
- Secondary surfaces use softer contrast but preserve readability.
- Decorative gradients should not reduce text legibility.

## Typography

- Dense operational data: compact sans with strong numerals.
- Narrative/memo sections: same family, larger line height.
- Avoid style shifts that imply different product identity.