Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

design: one brand mark, one palette, one icon grammar

sammohammad5784f86c7299142
diff --git a/docs/design/review.html b/docs/design/review.html
new file mode 100644
index 0000000..f6a76aa
--- /dev/null
+++ b/docs/design/review.html
@@ -0,0 +1,1529 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>AEC Model Bridge — design review</title>
+<style>
+/* ------------------------------------------------------------------ *
+ This sheet is painted with the tokens it documents.
+ Every hex below also appears in docs/design/tokens.md.
+ * ------------------------------------------------------------------ */
+:root{
+ --sheet-bg:#0F1319;
+ --sheet:#161B22;
+ --sheet-2:#1C222B;
+ --rule:#242D39;
+ --rule-soft:#1D242E;
+ --ink:#E9EEF5;
+ --muted:#8D9BAD;
+ --faint:#67758A;
+ --brand:#3FC3D6;
+ --brand-2:#6FD8E6;
+
+ /* mark paint, dark context (default for this sheet) */
+ --mk-ink:#E9EEF5;
+ --mk-brand:#3FC3D6;
+ --mk-ink-wash:rgba(233,238,245,.16);
+ --mk-brand-wash:rgba(63,195,214,.20);
+}
+
+*{box-sizing:border-box}
+
+svg{max-width:100%;height:auto}
+
+html{-webkit-text-size-adjust:100%}
+
+body{
+ margin:0;
+ background:var(--sheet-bg);
+ color:var(--ink);
+ font-family:"Segoe UI",system-ui,-apple-system,sans-serif;
+ font-size:14px;
+ line-height:1.55;
+}
+
+.sheet{
+ max-width:1120px;
+ margin:0 auto;
+ padding:0 16px 96px;
+}
+
+/* ---------- title block ---------- */
+
+.titleblock{
+ display:flex;
+ flex-wrap:wrap;
+ gap:8px 28px;
+ align-items:baseline;
+ padding:22px 0 18px;
+ border-bottom:1px solid var(--rule);
+}
+.titleblock .doc{font-size:13px;font-weight:600;letter-spacing:.01em}
+.titleblock .bit{font-size:12px;color:var(--faint)}
+.titleblock .bit b{font-weight:600;color:var(--muted)}
+
+/* ---------- hero ---------- */
+
+.hero{
+ display:grid;
+ grid-template-columns:minmax(320px,480px) minmax(0,1fr);
+ gap:40px 56px;
+ align-items:center;
+ padding:56px 0 64px;
+ border-bottom:1px solid var(--rule);
+}
+.hero svg{width:100%;height:auto;max-width:480px}
+.hero h1{
+ margin:0;
+ font-size:clamp(30px,4.4vw,46px);
+ font-weight:600;
+ line-height:1.1;
+ letter-spacing:-.012em;
+}
+.hero .tag{margin:10px 0 0;font-size:17px;color:var(--muted);font-weight:400}
+.hero p.lede{margin:26px 0 0;max-width:46ch;color:var(--muted);font-size:14.5px}
+.hero p.lede b{color:var(--ink);font-weight:600}
+
+/* annotation layer on the hero mark */
+.annot line{stroke:rgba(141,155,173,.42);stroke-width:.55;stroke-dasharray:2.4 2.6}
+.annot .tick{stroke:rgba(141,155,173,.75);stroke-dasharray:none;stroke-width:.6}
+.annot circle{fill:rgba(141,155,173,.85)}
+.annot text{
+ fill:#8D9BAD;font-size:4.1px;
+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;
+ letter-spacing:-.03em;
+}
+
+/* ---------- section scaffold: drawing-sheet margin column ---------- */
+
+section{
+ display:grid;
+ grid-template-columns:186px minmax(0,1fr);
+ gap:24px 40px;
+ padding:44px 0;
+ border-bottom:1px solid var(--rule-soft);
+}
+section > .margin h2{
+ margin:0;
+ font-size:16px;
+ font-weight:600;
+ line-height:1.25;
+ letter-spacing:-.005em;
+}
+section > .margin p{
+ margin:10px 0 0;
+ font-size:12.5px;
+ line-height:1.5;
+ color:var(--faint);
+}
+section > .margin p + p{margin-top:9px}
+section > .body{min-width:0}
+
+/* ---------- chips: a light context and a dark context ---------- */
+
+.chips{display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:16px}
+
+.chip{
+ border-radius:12px;
+ padding:26px 22px 20px;
+ border:1px solid transparent;
+}
+.chip .cap{
+ margin-top:20px;
+ font-size:11.5px;
+ color:inherit;
+ opacity:.62;
+}
+.chip.dark{
+ background:#1C222B;border-color:#2F3945;color:#E9EEF5;
+ --mk-ink:#E9EEF5;--mk-brand:#3FC3D6;
+ --mk-ink-wash:rgba(233,238,245,.16);--mk-brand-wash:rgba(63,195,214,.20);
+}
+.chip.light{
+ background:#FFFFFF;border-color:#D3DAE3;color:#18202C;
+ --mk-ink:#18202C;--mk-brand:#0091A7;
+ --mk-ink-wash:rgba(24,32,44,.12);--mk-brand-wash:rgba(0,145,167,.20);
+}
+
+/* ---------- the mark ---------- */
+
+.mark{display:block}
+.mark .w-ink{fill:var(--mk-ink-wash);stroke:none}
+.mark .w-brand{fill:var(--mk-brand-wash);stroke:none}
+.mark .s{fill:none;stroke-linecap:round;stroke-linejoin:round}
+.mark .s .ink{stroke:var(--mk-ink)}
+.mark .s .br{stroke:var(--mk-brand)}
+
+/* size row */
+.sizes{display:flex;flex-wrap:wrap;align-items:flex-end;gap:34px}
+.spec{display:flex;flex-direction:column;align-items:center;gap:12px}
+.spec .px{
+ font-size:11px;color:var(--muted);
+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;
+}
+.chip.light .spec .px{color:#5B6676}
+.chip.dark .spec .px{color:#9BA8B9}
+.rule-under{border-top:1px solid currentColor;opacity:.16;width:100%;margin-top:2px}
+
+/* ---------- lockup ---------- */
+
+.lockup{display:flex;align-items:center;gap:20px}
+.lockup .name{font-size:26px;font-weight:600;line-height:1.1;letter-spacing:-.01em}
+.lockup .sub{font-size:13px;line-height:1.3;opacity:.62;margin-top:3px}
+
+/* ---------- panel mock ---------- */
+
+.mocks{display:grid;grid-template-columns:repeat(auto-fit,minmax(320px,1fr));gap:20px}
+
+.panel{
+ border-radius:12px;
+ overflow:hidden;
+ display:grid;
+ grid-template-columns:58px minmax(0,1fr);
+ font-size:13px;
+ border:1px solid;
+ min-height:400px;
+}
+.panel.dark{
+ background:#14181E;border-color:#2F3945;color:#E9EEF5;
+ --p-surface:#1C222B;--p-line:#2F3945;--p-muted:#9BA8B9;--p-raised:#232A34;
+ --p-brand:#3FC3D6;--p-glass:rgba(28,34,43,.72);--p-glass-line:rgba(255,255,255,.07);
+ --mk-ink:#E9EEF5;--mk-brand:#3FC3D6;
+ --mk-ink-wash:rgba(233,238,245,.16);--mk-brand-wash:rgba(63,195,214,.20);
+}
+.panel.light{
+ background:#F2F5F8;border-color:#D3DAE3;color:#18202C;
+ --p-surface:#FFFFFF;--p-line:#D3DAE3;--p-muted:#5B6676;--p-raised:#E9EEF4;
+ --p-brand:#0091A7;--p-glass:rgba(255,255,255,.72);--p-glass-line:rgba(16,24,40,.08);
+ --mk-ink:#E9EEF5;--mk-brand:#3FC3D6;
+ --mk-ink-wash:rgba(233,238,245,.16);--mk-brand-wash:rgba(63,195,214,.20);
+}
+
+/* the rail is dark in both themes */
+.rail{
+ background:#141B24;
+ display:grid;
+ grid-template-rows:58px repeat(6,44px) 1fr;
+ gap:6px;
+ padding:8px;
+ border-right:1px solid rgba(255,255,255,.07);
+}
+.rail .brandcell{display:grid;place-items:center;gap:4px}
+.rail .amb{font-size:10px;font-weight:600;letter-spacing:.06em;color:#C9D4E2}
+.rail .nav{
+ position:relative;
+ display:grid;place-items:center;
+ border-radius:8px;
+ font-size:13px;font-weight:600;
+ color:#C9D4E2;
+ background:transparent;
+ border:0;
+ font-family:inherit;
+}
+.rail .nav.on{background:rgba(63,195,214,.14);color:#E9EEF5}
+.rail .nav.on::before{
+ content:"";position:absolute;left:-8px;top:9px;bottom:9px;width:2px;
+ background:#3FC3D6;border-radius:0 2px 2px 0;
+}
+
+.appcol{display:grid;grid-template-rows:auto minmax(0,1fr);min-width:0}
+.topbar{
+ display:flex;align-items:center;justify-content:space-between;gap:10px;
+ padding:12px 14px;
+ background:var(--p-glass);
+ border-bottom:1px solid var(--p-line);
+ backdrop-filter:blur(14px) saturate(140%);
+ -webkit-backdrop-filter:blur(14px) saturate(140%);
+}
+.topbar h3{margin:0;font-size:18px;font-weight:650;line-height:1.2}
+.topbar .sub{margin:3px 0 0;font-size:12px;color:var(--p-muted)}
+.pill{
+ display:inline-flex;align-items:center;gap:7px;
+ padding:5px 11px;border-radius:999px;
+ background:var(--p-raised);border:1px solid var(--p-line);
+ font-size:12px;color:var(--p-muted);white-space:nowrap;
+}
+.pill .dot{width:8px;height:8px;border-radius:50%;background:#3FCB8B}
+.panel.light .pill .dot{background:#127A4B}
+
+.cards{display:grid;gap:10px;align-content:start;padding:14px}
+.card{
+ background:var(--p-surface);
+ border:1px solid var(--p-line);
+ border-radius:8px;
+ padding:11px 12px;
+}
+.panel.light .card{box-shadow:0 1px 2px rgba(16,24,40,.08)}
+.card .head{display:flex;align-items:center;justify-content:space-between;gap:10px}
+.card h4{margin:0;font-size:14px;font-weight:600;line-height:1.3}
+.card p{margin:6px 0 0;font-size:12.5px;line-height:1.45;color:var(--p-muted)}
+.card .acts{display:flex;gap:8px;margin-top:10px}
+.btn{
+ font-family:inherit;font-size:12.5px;
+ padding:6px 11px;border-radius:6px;
+ border:1px solid var(--p-line);
+ background:var(--p-surface);color:inherit;
+}
+.btn.primary{background:var(--p-brand);border-color:var(--p-brand);color:#06222A;font-weight:600}
+.panel.light .btn.primary{color:#FFFFFF}
+
+/* ---------- badges ---------- */
+
+.badge{
+ display:inline-block;
+ border-radius:999px;
+ padding:3px 9px;
+ font-size:11px;font-weight:600;letter-spacing:.01em;
+ text-transform:capitalize;
+ border:1px solid transparent;
+ white-space:nowrap;
+}
+.badgerow{display:flex;flex-wrap:wrap;gap:8px;align-items:center}
+
+.on-light .badge{color:#fff}
+.on-light .badge.error{background:#C23B2E}
+.on-light .badge.warning{background:#A45F0B}
+.on-light .badge.info{background:#2457C5}
+.on-light .badge.success{background:#127A4B}
+.on-light .badge.pending{background:#6D3FB8}
+.on-light .badge.idle{background:#5B6676}
+
+.on-dark .badge.error{background:rgba(240,121,107,.14);border-color:rgba(240,121,107,.40);color:#F0796B}
+.on-dark .badge.warning{background:rgba(242,166,60,.14);border-color:rgba(242,166,60,.40);color:#F2A63C}
+.on-dark .badge.info{background:rgba(127,166,245,.14);border-color:rgba(127,166,245,.40);color:#7FA6F5}
+.on-dark .badge.success{background:rgba(63,203,139,.14);border-color:rgba(63,203,139,.40);color:#3FCB8B}
+.on-dark .badge.pending{background:rgba(183,154,240,.14);border-color:rgba(183,154,240,.40);color:#B79AF0}
+.on-dark .badge.idle{background:rgba(155,168,185,.14);border-color:rgba(155,168,185,.40);color:#9BA8B9}
+
+/* the pending fix, shown as it was vs as it is */
+.fix{
+ display:grid;grid-template-columns:repeat(auto-fit,minmax(230px,1fr));
+ gap:14px;margin-top:20px;
+}
+.fix .col{border:1px solid var(--rule);border-radius:10px;padding:14px 15px}
+.fix .col h5{margin:0 0 4px;font-size:12.5px;font-weight:600}
+.fix .col small{display:block;color:var(--faint);font-size:11.5px;line-height:1.45;margin-bottom:12px}
+.fix .was{background:#64748b;color:#fff;border-radius:999px;padding:3px 9px;font-size:11px;font-weight:600;display:inline-block}
+.fix .col.now{border-color:rgba(63,195,214,.35)}
+
+/* ---------- tool icons ---------- */
+
+.ico{display:block}
+.ico .fi{fill:var(--ic-ink-wash);stroke:none}
+.ico .fa{fill:var(--ic-wash);stroke:none}
+.ico .sa{fill:var(--ic);stroke:none}
+.ico .st{fill:none;stroke-linecap:round;stroke-linejoin:round}
+.ico .st.k{stroke:var(--ic-ink)}
+.ico .st.a{stroke:var(--ic)}
+
+.iconwall{display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:18px}
+.icell{display:flex;flex-direction:column;align-items:center;gap:11px;padding:16px 8px;border-radius:10px}
+.icell .pair{display:flex;align-items:flex-end;gap:14px;min-height:34px}
+.icell .nm{font-size:12px;font-weight:600;text-align:center}
+.icell .tk{
+ font-size:10.5px;opacity:.6;text-align:center;
+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;
+}
+.ribbon.dark{background:#2F3338;border:1px solid #3C4249}
+.ribbon.light{background:#F0F0F0;border:1px solid #D8D8D8;color:#18202C}
+
+.tier{margin:0 0 14px;font-size:12.5px;color:var(--faint)}
+
+/* ---------- token table ---------- */
+
+.tablewrap{overflow-x:auto;-webkit-overflow-scrolling:touch}
+table{border-collapse:collapse;width:100%;min-width:480px;font-size:12.5px}
+thead th{
+ text-align:left;font-weight:600;font-size:11.5px;color:var(--faint);
+ padding:0 10px 9px 0;border-bottom:1px solid var(--rule);
+}
+tbody td{padding:9px 10px 9px 0;border-bottom:1px solid var(--rule-soft);vertical-align:middle}
+tbody tr:last-child td{border-bottom:0}
+.tname{font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;font-size:11.5px;white-space:nowrap}
+.sw{display:inline-flex;align-items:center;gap:9px;white-space:nowrap}
+.sw i{width:17px;height:17px;border-radius:5px;display:inline-block;border:1px solid rgba(255,255,255,.14);flex:none}
+.sw code{
+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;
+ font-size:11.5px;color:var(--muted);font-style:normal;
+}
+td.role{color:var(--faint)}
+
+/* ---------- type ---------- */
+.typerow{display:grid;grid-template-columns:auto minmax(0,1fr);gap:6px 22px;align-items:baseline}
+.typerow .lab{
+ font-size:11px;color:var(--faint);white-space:nowrap;
+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;
+}
+
+footer{padding:38px 0 0;color:var(--faint);font-size:12.5px;max-width:64ch}
+footer code{font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;color:var(--muted)}
+
+@media (max-width:760px){
+ .hero{grid-template-columns:minmax(0,1fr);gap:32px;padding:36px 0 44px}
+ .hero svg{max-width:100%}
+ section{grid-template-columns:minmax(0,1fr);gap:18px;padding:34px 0}
+ .mocks{grid-template-columns:minmax(0,1fr)}
+ .iconwall{grid-template-columns:repeat(auto-fill,minmax(120px,1fr))}
+ .sizes{gap:22px}
+}
+@media (max-width:420px){
+ .sheet{padding:0 14px 72px}
+ .chips{grid-template-columns:minmax(0,1fr)}
+ .fix{grid-template-columns:minmax(0,1fr)}
+ .titleblock{gap:6px 18px}
+}
+</style>
+</head>
+<body>
+<div class="sheet">
+
+ <div class="titleblock">
+ <span class="doc">AEC Model Bridge — design review</span>
+ <span class="bit"><b>Sheet</b> 1 of 1</span>
+ <span class="bit"><b>Spec</b> docs/design/tokens.md</span>
+ <span class="bit"><b>Status</b> proposed, awaiting approval</span>
+ </div>
+
+ <!-- ================= HERO ================= -->
+ <div class="hero">
+ <svg class="mark" viewBox="-26 -10 152 116" width="456" height="348" role="img"
+ aria-label="The Span: two nodes joined by a deck, with a triangular apex above them">
+ <g class="annot">
+ <line x1="-20" y1="72.5" x2="120" y2="72.5"/>
+ <line x1="50" y1="0" x2="50" y2="82"/>
+ <line x1="33" y1="45" x2="33" y2="70"/>
+ <line x1="67" y1="45" x2="67" y2="70"/>
+ <line class="tick" x1="36.5" y1="57.8" x2="44" y2="57.8"/>
+ <line class="tick" x1="56" y1="57.8" x2="63.5" y2="57.8"/>
+ <line class="tick" x1="19" y1="72.5" x2="28.9" y2="82.4"/>
+ <circle cx="50" cy="8.5" r="1.15"/>
+ <circle cx="81" cy="72.5" r="1.15"/>
+ <text x="-24" y="69.2">y 0.725</text>
+ <text x="-24" y="63.5">deck</text>
+ <text x="52.2" y="-1.4">x 0.500</text>
+ <text x="33.5" y="91.6">r 0.140</text>
+ <text x="122" y="99" text-anchor="end">node 0.810, 0.725</text>
+ <text x="55.5" y="7.4">apex 0.500, 0.085</text>
+ <text x="50" y="59.6" text-anchor="middle">0.340</text>
+ </g>
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+
+ <div>
+ <h1>The Span</h1>
+ <p class="tag">One mark, sixteen colors, one icon grammar.</p>
+ <p class="lede">
+ A span, drawn flat. The <b>two nodes are the model and the agent</b>;
+ the <b>apex above them is this product</b>. Deck and nodes are drawn in
+ ink because they already exist — the apex is the only thing painted in
+ brand color, because it is the only thing the bridge adds.
+ </p>
+ <p class="lede">
+ Nothing draws a line from the nodes up to the apex. They are tied
+ together by <b>alignment</b>: the apex base and the deck are both
+ exactly 0.340 wide and sit on the same two axes. Connector lines were
+ drawn five different ways and every one of them turned the mark into a
+ capital A.
+ </p>
+ <p class="lede">
+ It is the <b>Connect</b> icon already shipping in the ribbon,
+ reproportioned and promoted. Circles and straight lines only, which is
+ what lets SVG, WPF and CSS each reproduce it exactly — something the
+ three different shaded cubes it replaces never managed.
+ </p>
+ </div>
+ </div>
+
+ <!-- ================= SIZES ================= -->
+ <section>
+ <div class="margin">
+ <h2>The sizes it ships at</h2>
+ <p>16 and 32 px on the Revit ribbon, 26 px in the panel nav rail,
+ ~300 px in the README lockup.</p>
+ <p>One geometry at every size. Nothing is dropped or re-tuned for small
+ sizes, so there is no optical-size variant to keep in sync across three
+ renderers by hand.</p>
+ <p>Only the stroke changes: <code>size × 0.06</code>, snapped to half a
+ pixel, floor 1.5 px — the arithmetic
+ <code>IconGenerator.StrokeWidth</code> already does.</p>
+ </div>
+ <div class="body">
+ <div class="chips">
+
+ <div class="chip dark">
+ <div class="sizes">
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="9.4">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">16</span>
+ </div>
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="26" height="26" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="5.8">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">26</span>
+ </div>
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">32</span>
+ </div>
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="96" height="96" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">96</span>
+ </div>
+ </div>
+ <div class="cap">Dark — Revit dark theme, GitHub dark README, panel dark</div>
+ </div>
+
+ <div class="chip light">
+ <div class="sizes">
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="9.4">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">16</span>
+ </div>
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="26" height="26" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="5.8">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">26</span>
+ </div>
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">32</span>
+ </div>
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="96" height="96" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">96</span>
+ </div>
+ </div>
+ <div class="cap">Light — Revit light theme, GitHub light README, panel light</div>
+ </div>
+
+ </div>
+ </div>
+ </section>
+
+ <!-- ================= WHY NO CONNECTORS ================= -->
+ <section>
+ <div class="margin">
+ <h2>Why nothing connects the apex</h2>
+ <p>The brief's motif has lines running from each node up to the apex. Drawn
+ literally, they extend the apex's own legs and the deck becomes a
+ crossbar.</p>
+ <p>Five variants, all the same outcome. The alignment of the apex base to
+ the deck says “these belong together” without spelling the letter.</p>
+ </div>
+ <div class="body">
+ <div class="chips">
+ <div class="chip dark" style="--mk-brand:#F0796B;--mk-brand-wash:rgba(240,121,107,.20)">
+ <div class="sizes">
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="96" height="96" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 65.5,43 34.5,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="13"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="13"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="32" y1="72.5" x2="68" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="13"/>
+ <circle class="ink" cx="81" cy="72.5" r="13"/>
+ <line class="br" x1="25.1" y1="61" x2="34.5" y2="43"/>
+ <line class="br" x1="74.9" y1="61" x2="65.5" y2="43"/>
+ <polygon class="br" points="50,8.5 65.5,43 34.5,43"/>
+ </g>
+ </svg>
+ <span class="px">rejected</span>
+ </div>
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 65.5,43 34.5,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="13"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="13"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="32" y1="72.5" x2="68" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="13"/>
+ <circle class="ink" cx="81" cy="72.5" r="13"/>
+ <line class="br" x1="25.1" y1="61" x2="34.5" y2="43"/>
+ <line class="br" x1="74.9" y1="61" x2="65.5" y2="43"/>
+ <polygon class="br" points="50,8.5 65.5,43 34.5,43"/>
+ </g>
+ </svg>
+ <span class="px">32</span>
+ </div>
+ </div>
+ <div class="cap">With connectors — it is a letter, not a mark</div>
+ </div>
+
+ <div class="chip dark">
+ <div class="sizes">
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="96" height="96" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">adopted</span>
+ </div>
+ <div class="spec">
+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="px">32</span>
+ </div>
+ </div>
+ <div class="cap">Tied by alignment — 0.340 shared by deck and apex base</div>
+ </div>
+ </div>
+ </div>
+ </section>
+
+ <!-- ================= LOCKUP ================= -->
+ <section>
+ <div class="margin">
+ <h2>The lockup</h2>
+ <p>What replaces the cube-plus-“AEC / BRIDGE” in <code>assets/logo.svg</code>.</p>
+ <p>Segoe UI at weight 600, sentence case, no tracking. The mark carries the
+ identity; the wordmark only says the name.</p>
+ </div>
+ <div class="body">
+ <div class="chips">
+ <div class="chip dark">
+ <div class="lockup">
+ <svg class="mark" viewBox="0 0 100 100" width="72" height="72" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <div>
+ <div class="name">AEC Model Bridge</div>
+ <div class="sub">Model context for Revit</div>
+ </div>
+ </div>
+ <div class="cap">Dark README</div>
+ </div>
+ <div class="chip light">
+ <div class="lockup">
+ <svg class="mark" viewBox="0 0 100 100" width="72" height="72" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <div>
+ <div class="name">AEC Model Bridge</div>
+ <div class="sub">Model context for Revit</div>
+ </div>
+ </div>
+ <div class="cap">Light README</div>
+ </div>
+ </div>
+ </div>
+ </section>
+
+ <!-- ================= PANEL MOCK ================= -->
+ <section>
+ <div class="margin">
+ <h2>The panel</h2>
+ <p>Same markup the panel ships today — 58 px rail, 64 px topbar, card list —
+ repainted with these tokens and the mark dropped into the rail in place
+ of the gradient square.</p>
+ <p>The rail stays dark in both themes. It is the product's spine, and it is
+ the one place the brand indicator lives.</p>
+ <p>Rail and topbar are the only translucent surfaces. Cards stay opaque —
+ glass behind body text is a legibility tax.</p>
+ </div>
+ <div class="body">
+ <div class="mocks">
+
+ <!-- dark -->
+ <div class="panel dark on-dark">
+ <div class="rail">
+ <div class="brandcell">
+ <svg class="mark" viewBox="0 0 100 100" width="26" height="26" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="5.8">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="amb">AMB</span>
+ </div>
+ <div class="nav">C</div>
+ <div class="nav">P</div>
+ <div class="nav on">F</div>
+ <div class="nav">R</div>
+ <div class="nav">L</div>
+ <div class="nav">S</div>
+ </div>
+ <div class="appcol">
+ <div class="topbar">
+ <div>
+ <h3>Findings</h3>
+ <p class="sub">4 findings in Level 2 — Structure</p>
+ </div>
+ <span class="pill"><span class="dot"></span>Hub connected</span>
+ </div>
+ <div class="cards">
+ <div class="card">
+ <div class="head">
+ <h4>Wall joins unmitred</h4>
+ <span class="badge error">error</span>
+ </div>
+ <p>Six walls on grid C meet without a mitre. Corners will render open in section.</p>
+ <div class="acts"><button class="btn">Select in Revit</button></div>
+ </div>
+ <div class="card">
+ <div class="head">
+ <h4>Rooms unbounded</h4>
+ <span class="badge warning">warning</span>
+ </div>
+ <p>Two rooms on Level 2 have no bounding element and report zero area.</p>
+ </div>
+ <div class="card">
+ <div class="head">
+ <h4>Rename 14 door types</h4>
+ <span class="badge pending">pending</span>
+ </div>
+ <p>Waiting on your approval before anything is written to the model.</p>
+ <div class="acts">
+ <button class="btn primary">Approve</button>
+ <button class="btn">Reject</button>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+
+ <!-- light -->
+ <div class="panel light on-light">
+ <div class="rail">
+ <div class="brandcell">
+ <svg class="mark" viewBox="0 0 100 100" width="26" height="26" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="5.8">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <span class="amb">AMB</span>
+ </div>
+ <div class="nav">C</div>
+ <div class="nav">P</div>
+ <div class="nav on">F</div>
+ <div class="nav">R</div>
+ <div class="nav">L</div>
+ <div class="nav">S</div>
+ </div>
+ <div class="appcol">
+ <div class="topbar">
+ <div>
+ <h3>Findings</h3>
+ <p class="sub">4 findings in Level 2 — Structure</p>
+ </div>
+ <span class="pill"><span class="dot"></span>Hub connected</span>
+ </div>
+ <div class="cards">
+ <div class="card">
+ <div class="head">
+ <h4>Wall joins unmitred</h4>
+ <span class="badge error">error</span>
+ </div>
+ <p>Six walls on grid C meet without a mitre. Corners will render open in section.</p>
+ <div class="acts"><button class="btn">Select in Revit</button></div>
+ </div>
+ <div class="card">
+ <div class="head">
+ <h4>Rooms unbounded</h4>
+ <span class="badge warning">warning</span>
+ </div>
+ <p>Two rooms on Level 2 have no bounding element and report zero area.</p>
+ </div>
+ <div class="card">
+ <div class="head">
+ <h4>Rename 14 door types</h4>
+ <span class="badge pending">pending</span>
+ </div>
+ <p>Waiting on your approval before anything is written to the model.</p>
+ <div class="acts">
+ <button class="btn primary">Approve</button>
+ <button class="btn">Reject</button>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+
+ </div>
+ </div>
+ </section>
+
+ <!-- ================= BADGES ================= -->
+ <section>
+ <div class="margin">
+ <h2>Severity</h2>
+ <p>One set of six, shared by the ribbon icons and the panel badges. Solid
+ fill on light, 14 % tint with a hairline on dark.</p>
+ <p>Every light fill clears 4.5:1 against its own white label. The amber
+ shipping today does not — it measures 3.6:1.</p>
+ <p>Sentence case, not caps. Uppercase at 11 px costs legibility on a word
+ like “warning” and the pill shape already says “status”.</p>
+ </div>
+ <div class="body">
+ <div class="chips">
+ <div class="chip light on-light">
+ <div class="badgerow">
+ <span class="badge error">error</span>
+ <span class="badge warning">warning</span>
+ <span class="badge info">info</span>
+ <span class="badge success">success</span>
+ <span class="badge pending">pending</span>
+ <span class="badge idle">idle</span>
+ </div>
+ <div class="cap">Light</div>
+ </div>
+ <div class="chip dark on-dark">
+ <div class="badgerow">
+ <span class="badge error">error</span>
+ <span class="badge warning">warning</span>
+ <span class="badge info">info</span>
+ <span class="badge success">success</span>
+ <span class="badge pending">pending</span>
+ <span class="badge idle">idle</span>
+ </div>
+ <div class="cap">Dark</div>
+ </div>
+ </div>
+
+ <div class="fix">
+ <div class="col">
+ <h5>Pending today, in the panel</h5>
+ <small>Slate grey <code>#64748b</code>. Grey is the universal signal
+ for “nothing to do here”, on the one state that blocks everything
+ until you act.</small>
+ <span class="was">PENDING</span>
+ </div>
+ <div class="col">
+ <h5>Pending today, on the ribbon</h5>
+ <small>Violet <code>#7B1FA2</code>. Same concept, unrelated colour,
+ drawn by a different file.</small>
+ <span class="badge" style="background:#7B1FA2;color:#fff;border-color:#7B1FA2">pending</span>
+ </div>
+ <div class="col now">
+ <h5>Resolved: violet, both surfaces</h5>
+ <small>The ribbon was right. <code>--amb-pending</code> is
+ <code>#6D3FB8</code> light and <code>#B79AF0</code> dark, and the
+ grey moves to <code>--amb-idle</code> for states that really are
+ inert.</small>
+ <span class="badgerow on-dark" style="display:inline-flex">
+ <span class="badge pending">pending</span>
+ <span class="badge idle">idle</span>
+ </span>
+ </div>
+ </div>
+ </div>
+ </section>
+
+ <!-- ================= ICONS ================= -->
+ <section>
+ <div class="margin">
+ <h2>Icon grammar</h2>
+ <p>Structure is ink. One accent, and only if the icon reports a state.</p>
+ <p>Five state icons carry a semantic colour. Four action icons carry none —
+ ink strokes, ink-tinted interiors. That is what makes a ribbon scannable
+ instead of eight unrelated stickers.</p>
+ <p>Brand cyan appears on the mark and nowhere else in the ribbon, which is
+ what makes the brand button findable.</p>
+ </div>
+ <div class="body">
+
+ <p class="tier">State — the icon reports a condition</p>
+ <div class="iconwall">
+
+ <!-- Connect: monochrome success -->
+ <div class="icell ribbon dark" style="--ic:#3FCB8B;--ic-ink:#3FCB8B;--ic-wash:rgba(63,203,139,.20);--ic-ink-wash:rgba(63,203,139,.20)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <polygon class="fa" points="50,8.5 67,43 33,43"/>
+ <circle class="fi" cx="19" cy="72.5" r="14"/>
+ <circle class="fi" cx="81" cy="72.5" r="14"/>
+ <g class="st a" stroke-width="9.4">
+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle cx="19" cy="72.5" r="14"/>
+ <circle cx="81" cy="72.5" r="14"/>
+ <polygon points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="fa" points="50,8.5 67,43 33,43"/>
+ <circle class="fi" cx="19" cy="72.5" r="14"/>
+ <circle class="fi" cx="81" cy="72.5" r="14"/>
+ <g class="st a" stroke-width="6.25">
+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle cx="19" cy="72.5" r="14"/>
+ <circle cx="81" cy="72.5" r="14"/>
+ <polygon points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Connect</div>
+ <div class="tk">--amb-success</div>
+ </div>
+
+ <!-- Disconnect: monochrome danger + slash -->
+ <div class="icell ribbon dark" style="--ic:#F0796B;--ic-ink:#F0796B;--ic-wash:rgba(240,121,107,.20);--ic-ink-wash:rgba(240,121,107,.20)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <polygon class="fa" points="50,8.5 67,43 33,43"/>
+ <circle class="fi" cx="19" cy="72.5" r="14"/>
+ <circle class="fi" cx="81" cy="72.5" r="14"/>
+ <g class="st a" stroke-width="9.4">
+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle cx="19" cy="72.5" r="14"/>
+ <circle cx="81" cy="72.5" r="14"/>
+ <polygon points="50,8.5 67,43 33,43"/>
+ </g>
+ <g class="st a" stroke-width="12.5">
+ <line x1="30" y1="29" x2="70" y2="69"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="fa" points="50,8.5 67,43 33,43"/>
+ <circle class="fi" cx="19" cy="72.5" r="14"/>
+ <circle class="fi" cx="81" cy="72.5" r="14"/>
+ <g class="st a" stroke-width="6.25">
+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle cx="19" cy="72.5" r="14"/>
+ <circle cx="81" cy="72.5" r="14"/>
+ <polygon points="50,8.5 67,43 33,43"/>
+ </g>
+ <g class="st a" stroke-width="7.8">
+ <line x1="30" y1="29" x2="70" y2="69"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Disconnect</div>
+ <div class="tk">--amb-danger</div>
+ </div>
+
+ <!-- Status: ink + info -->
+ <div class="icell ribbon dark" style="--ic:#7FA6F5;--ic-ink:#E9EEF5;--ic-wash:rgba(127,166,245,.20);--ic-ink-wash:rgba(233,238,245,.16)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <circle class="fa" cx="73" cy="72" r="14"/>
+ <g class="st k" stroke-width="9.4">
+ <rect x="7" y="7" width="86" height="86" rx="9"/>
+ <line x1="19" y1="32" x2="58" y2="32"/>
+ <line x1="19" y1="53" x2="50" y2="53"/>
+ </g>
+ <g class="st a" stroke-width="9.4"><circle cx="73" cy="72" r="14"/></g>
+ <circle class="sa" cx="73" cy="72" r="5.5"/>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <circle class="fa" cx="73" cy="72" r="14"/>
+ <g class="st k" stroke-width="6.25">
+ <rect x="7" y="7" width="86" height="86" rx="9"/>
+ <line x1="19" y1="32" x2="58" y2="32"/>
+ <line x1="19" y1="53" x2="50" y2="53"/>
+ </g>
+ <g class="st a" stroke-width="6.25"><circle cx="73" cy="72" r="14"/></g>
+ <circle class="sa" cx="73" cy="72" r="5.5"/>
+ </svg>
+ </div>
+ <div class="nm">Status</div>
+ <div class="tk">--amb-info</div>
+ </div>
+
+ <!-- Health: ink + warning -->
+ <div class="icell ribbon dark" style="--ic:#F2A63C;--ic-ink:#E9EEF5;--ic-wash:rgba(242,166,60,.20);--ic-ink-wash:rgba(233,238,245,.16)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <g class="st k" stroke-width="9.4">
+ <rect x="20" y="12" width="60" height="78" rx="6"/>
+ <rect x="38" y="5" width="24" height="11" rx="3"/>
+ </g>
+ <g class="st a" stroke-width="11"><polyline points="32,53 45,66 70,36"/></g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <g class="st k" stroke-width="6.25">
+ <rect x="20" y="12" width="60" height="78" rx="6"/>
+ <rect x="38" y="5" width="24" height="11" rx="3"/>
+ </g>
+ <g class="st a" stroke-width="9"><polyline points="32,53 45,66 70,36"/></g>
+ </svg>
+ </div>
+ <div class="nm">Health</div>
+ <div class="tk">--amb-warning</div>
+ </div>
+
+ <!-- Pending: ink + pending -->
+ <div class="icell ribbon dark" style="--ic:#B79AF0;--ic-ink:#E9EEF5;--ic-wash:rgba(183,154,240,.20);--ic-ink-wash:rgba(233,238,245,.16)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <circle class="fa" cx="73" cy="74" r="21"/>
+ <g class="st k" stroke-width="10">
+ <line x1="10" y1="22" x2="62" y2="22"/>
+ <line x1="10" y1="42" x2="54" y2="42"/>
+ <line x1="10" y1="62" x2="42" y2="62"/>
+ </g>
+ <g class="st a" stroke-width="8.6">
+ <circle cx="73" cy="74" r="21"/>
+ <line x1="73" y1="74" x2="73" y2="62.5"/>
+ <line x1="73" y1="74" x2="82.5" y2="76.1"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <circle class="fa" cx="73" cy="74" r="21"/>
+ <g class="st k" stroke-width="7">
+ <line x1="10" y1="22" x2="62" y2="22"/>
+ <line x1="10" y1="42" x2="54" y2="42"/>
+ <line x1="10" y1="62" x2="42" y2="62"/>
+ </g>
+ <g class="st a" stroke-width="5.5">
+ <circle cx="73" cy="74" r="21"/>
+ <line x1="73" y1="74" x2="73" y2="62.5"/>
+ <line x1="73" y1="74" x2="82.5" y2="76.1"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Pending</div>
+ <div class="tk">--amb-pending</div>
+ </div>
+
+ </div>
+
+ <p class="tier" style="margin-top:26px">Action — no condition, so no accent</p>
+ <div class="iconwall">
+
+ <!-- Settings: ink only -->
+ <div class="icell ribbon dark" style="--ic:#E9EEF5;--ic-ink:#E9EEF5;--ic-wash:rgba(233,238,245,.16);--ic-ink-wash:rgba(233,238,245,.16)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <g class="st k" stroke-width="9.4">
+ <circle cx="50" cy="50" r="12"/>
+ <circle cx="50" cy="50" r="30"/>
+ </g>
+ <g class="st k" stroke-width="11">
+ <line x1="80" y1="50" x2="91" y2="50"/>
+ <line x1="65" y1="75.98" x2="70.5" y2="85.51"/>
+ <line x1="35" y1="75.98" x2="29.5" y2="85.51"/>
+ <line x1="20" y1="50" x2="9" y2="50"/>
+ <line x1="35" y1="24.02" x2="29.5" y2="14.49"/>
+ <line x1="65" y1="24.02" x2="70.5" y2="14.49"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <g class="st k" stroke-width="6.25">
+ <circle cx="50" cy="50" r="12"/>
+ <circle cx="50" cy="50" r="30"/>
+ </g>
+ <g class="st k" stroke-width="8">
+ <line x1="80" y1="50" x2="91" y2="50"/>
+ <line x1="65" y1="75.98" x2="70.5" y2="85.51"/>
+ <line x1="35" y1="75.98" x2="29.5" y2="85.51"/>
+ <line x1="20" y1="50" x2="9" y2="50"/>
+ <line x1="35" y1="24.02" x2="29.5" y2="14.49"/>
+ <line x1="65" y1="24.02" x2="70.5" y2="14.49"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Settings</div>
+ <div class="tk">ink only</div>
+ </div>
+
+ <!-- Panel: ink only -->
+ <div class="icell ribbon dark" style="--ic:#E9EEF5;--ic-ink:#E9EEF5;--ic-wash:rgba(233,238,245,.16);--ic-ink-wash:rgba(233,238,245,.16)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <rect class="fi" x="63" y="9" width="28" height="82"/>
+ <g class="st k" stroke-width="9.4">
+ <rect x="7" y="7" width="86" height="86" rx="9"/>
+ <line x1="17" y1="30" x2="53" y2="30"/>
+ <line x1="17" y1="50" x2="46" y2="50"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <rect class="fi" x="63" y="9" width="28" height="82"/>
+ <g class="st k" stroke-width="6.25">
+ <rect x="7" y="7" width="86" height="86" rx="9"/>
+ <line x1="17" y1="30" x2="53" y2="30"/>
+ <line x1="17" y1="50" x2="46" y2="50"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Panel</div>
+ <div class="tk">ink only</div>
+ </div>
+
+ <!-- Reports: ink only -->
+ <div class="icell ribbon dark" style="--ic:#E9EEF5;--ic-ink:#E9EEF5;--ic-wash:rgba(233,238,245,.16);--ic-ink-wash:rgba(233,238,245,.16)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <g class="fi">
+ <rect x="15" y="58" width="17" height="28"/>
+ <rect x="41.5" y="40" width="17" height="46"/>
+ <rect x="68" y="22" width="17" height="64"/>
+ </g>
+ <g class="st k" stroke-width="9.4">
+ <rect x="15" y="58" width="17" height="28"/>
+ <rect x="41.5" y="40" width="17" height="46"/>
+ <rect x="68" y="22" width="17" height="64"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <g class="fi">
+ <rect x="15" y="58" width="17" height="28"/>
+ <rect x="41.5" y="40" width="17" height="46"/>
+ <rect x="68" y="22" width="17" height="64"/>
+ </g>
+ <g class="st k" stroke-width="5">
+ <rect x="15" y="58" width="17" height="28"/>
+ <rect x="41.5" y="40" width="17" height="46"/>
+ <rect x="68" y="22" width="17" height="64"/>
+ </g>
+ <g class="st k" stroke-width="6.25"><line x1="10" y1="86" x2="90" y2="86"/></g>
+ </svg>
+ </div>
+ <div class="nm">Reports</div>
+ <div class="tk">ink only</div>
+ </div>
+
+
+ </div>
+
+ <p class="tier" style="margin-top:26px">The mark &#8212; brand cyan, and nothing else in the ribbon has it</p>
+ <div class="iconwall">
+ <div class="icell ribbon dark" style="--mk-ink:#E9EEF5;--mk-brand:#3FC3D6;--mk-ink-wash:rgba(233,238,245,.16);--mk-brand-wash:rgba(63,195,214,.20)">
+ <div class="pair">
+ <svg class="mark" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="9.4">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>
+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>
+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>
+ <g class="s" stroke-width="6.25">
+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle class="ink" cx="19" cy="72.5" r="14"/>
+ <circle class="ink" cx="81" cy="72.5" r="14"/>
+ <polygon class="br" points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Brand</div>
+ <div class="tk">--amb-brand</div>
+ </div>
+
+ </div>
+
+ <p class="tier" style="margin-top:26px">The same five state icons on a light Revit ribbon</p>
+ <div class="iconwall">
+ <div class="icell ribbon light" style="--ic:#127A4B;--ic-ink:#127A4B;--ic-wash:rgba(18,122,75,.20);--ic-ink-wash:rgba(18,122,75,.20)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <polygon class="fa" points="50,8.5 67,43 33,43"/>
+ <circle class="fi" cx="19" cy="72.5" r="14"/>
+ <circle class="fi" cx="81" cy="72.5" r="14"/>
+ <g class="st a" stroke-width="9.4">
+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle cx="19" cy="72.5" r="14"/>
+ <circle cx="81" cy="72.5" r="14"/>
+ <polygon points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="fa" points="50,8.5 67,43 33,43"/>
+ <circle class="fi" cx="19" cy="72.5" r="14"/>
+ <circle class="fi" cx="81" cy="72.5" r="14"/>
+ <g class="st a" stroke-width="6.25">
+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle cx="19" cy="72.5" r="14"/>
+ <circle cx="81" cy="72.5" r="14"/>
+ <polygon points="50,8.5 67,43 33,43"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Connect</div>
+ <div class="tk">#127A4B</div>
+ </div>
+
+ <div class="icell ribbon light" style="--ic:#C23B2E;--ic-ink:#C23B2E;--ic-wash:rgba(194,59,46,.20);--ic-ink-wash:rgba(194,59,46,.20)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <polygon class="fa" points="50,8.5 67,43 33,43"/>
+ <circle class="fi" cx="19" cy="72.5" r="14"/>
+ <circle class="fi" cx="81" cy="72.5" r="14"/>
+ <g class="st a" stroke-width="9.4">
+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle cx="19" cy="72.5" r="14"/>
+ <circle cx="81" cy="72.5" r="14"/>
+ <polygon points="50,8.5 67,43 33,43"/>
+ </g>
+ <g class="st a" stroke-width="12.5">
+ <line x1="30" y1="29" x2="70" y2="69"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <polygon class="fa" points="50,8.5 67,43 33,43"/>
+ <circle class="fi" cx="19" cy="72.5" r="14"/>
+ <circle class="fi" cx="81" cy="72.5" r="14"/>
+ <g class="st a" stroke-width="6.25">
+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>
+ <circle cx="19" cy="72.5" r="14"/>
+ <circle cx="81" cy="72.5" r="14"/>
+ <polygon points="50,8.5 67,43 33,43"/>
+ </g>
+ <g class="st a" stroke-width="7.8">
+ <line x1="30" y1="29" x2="70" y2="69"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Disconnect</div>
+ <div class="tk">#C23B2E</div>
+ </div>
+
+ <div class="icell ribbon light" style="--ic:#2457C5;--ic-ink:#18202C;--ic-wash:rgba(36,87,197,.20);--ic-ink-wash:rgba(24,32,44,.12)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <circle class="fa" cx="73" cy="72" r="14"/>
+ <g class="st k" stroke-width="9.4">
+ <rect x="7" y="7" width="86" height="86" rx="9"/>
+ <line x1="19" y1="32" x2="58" y2="32"/>
+ <line x1="19" y1="53" x2="50" y2="53"/>
+ </g>
+ <g class="st a" stroke-width="9.4"><circle cx="73" cy="72" r="14"/></g>
+ <circle class="sa" cx="73" cy="72" r="5.5"/>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <circle class="fa" cx="73" cy="72" r="14"/>
+ <g class="st k" stroke-width="6.25">
+ <rect x="7" y="7" width="86" height="86" rx="9"/>
+ <line x1="19" y1="32" x2="58" y2="32"/>
+ <line x1="19" y1="53" x2="50" y2="53"/>
+ </g>
+ <g class="st a" stroke-width="6.25"><circle cx="73" cy="72" r="14"/></g>
+ <circle class="sa" cx="73" cy="72" r="5.5"/>
+ </svg>
+ </div>
+ <div class="nm">Status</div>
+ <div class="tk">#2457C5</div>
+ </div>
+
+ <div class="icell ribbon light" style="--ic:#A45F0B;--ic-ink:#18202C;--ic-wash:rgba(164,95,11,.20);--ic-ink-wash:rgba(24,32,44,.12)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <g class="st k" stroke-width="9.4">
+ <rect x="20" y="12" width="60" height="78" rx="6"/>
+ <rect x="38" y="5" width="24" height="11" rx="3"/>
+ </g>
+ <g class="st a" stroke-width="11"><polyline points="32,53 45,66 70,36"/></g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <g class="st k" stroke-width="6.25">
+ <rect x="20" y="12" width="60" height="78" rx="6"/>
+ <rect x="38" y="5" width="24" height="11" rx="3"/>
+ </g>
+ <g class="st a" stroke-width="9"><polyline points="32,53 45,66 70,36"/></g>
+ </svg>
+ </div>
+ <div class="nm">Health</div>
+ <div class="tk">#A45F0B</div>
+ </div>
+
+ <div class="icell ribbon light" style="--ic:#6D3FB8;--ic-ink:#18202C;--ic-wash:rgba(109,63,184,.20);--ic-ink-wash:rgba(24,32,44,.12)">
+ <div class="pair">
+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">
+ <circle class="fa" cx="73" cy="74" r="21"/>
+ <g class="st k" stroke-width="10">
+ <line x1="10" y1="22" x2="62" y2="22"/>
+ <line x1="10" y1="42" x2="54" y2="42"/>
+ <line x1="10" y1="62" x2="42" y2="62"/>
+ </g>
+ <g class="st a" stroke-width="8.6">
+ <circle cx="73" cy="74" r="21"/>
+ <line x1="73" y1="74" x2="73" y2="62.5"/>
+ <line x1="73" y1="74" x2="82.5" y2="76.1"/>
+ </g>
+ </svg>
+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">
+ <circle class="fa" cx="73" cy="74" r="21"/>
+ <g class="st k" stroke-width="7">
+ <line x1="10" y1="22" x2="62" y2="22"/>
+ <line x1="10" y1="42" x2="54" y2="42"/>
+ <line x1="10" y1="62" x2="42" y2="62"/>
+ </g>
+ <g class="st a" stroke-width="5.5">
+ <circle cx="73" cy="74" r="21"/>
+ <line x1="73" y1="74" x2="73" y2="62.5"/>
+ <line x1="73" y1="74" x2="82.5" y2="76.1"/>
+ </g>
+ </svg>
+ </div>
+ <div class="nm">Pending</div>
+ <div class="tk">#6D3FB8</div>
+ </div>
+ </div>
+
+ </div>
+ </section>
+
+ <!-- ================= COLOR ================= -->
+ <section>
+ <div class="margin">
+ <h2>Sixteen tokens</h2>
+ <p>Down from the twenty-two unrelated hexes spread across
+ <code>logo.svg</code>, <code>IconGenerator.cs</code> and
+ <code>styles.css</code> today.</p>
+ <p>Brand cyan is the one saturated family no semantic token occupies, so
+ the brand can never be misread as a status. It is deliberately not
+ Autodesk's <code>#0696D7</code> — the panel is a guest inside Revit,
+ not a part of it.</p>
+ </div>
+ <div class="body">
+ <div class="tablewrap">
+ <table>
+ <thead>
+ <tr><th>Token</th><th>Light</th><th>Dark</th><th>Role</th></tr>
+ </thead>
+ <tbody>
+ <tr><td class="tname">--amb-ink</td>
+ <td><span class="sw"><i style="background:#18202C"></i><code>#18202C</code></span></td>
+ <td><span class="sw"><i style="background:#E9EEF5"></i><code>#E9EEF5</code></span></td>
+ <td class="role">Text; every icon's structural stroke</td></tr>
+ <tr><td class="tname">--amb-ink-muted</td>
+ <td><span class="sw"><i style="background:#5B6676"></i><code>#5B6676</code></span></td>
+ <td><span class="sw"><i style="background:#9BA8B9"></i><code>#9BA8B9</code></span></td>
+ <td class="role">Secondary text, metadata</td></tr>
+ <tr><td class="tname">--amb-bg</td>
+ <td><span class="sw"><i style="background:#F2F5F8"></i><code>#F2F5F8</code></span></td>
+ <td><span class="sw"><i style="background:#14181E"></i><code>#14181E</code></span></td>
+ <td class="role">App background</td></tr>
+ <tr><td class="tname">--amb-surface</td>
+ <td><span class="sw"><i style="background:#FFFFFF"></i><code>#FFFFFF</code></span></td>
+ <td><span class="sw"><i style="background:#1C222B"></i><code>#1C222B</code></span></td>
+ <td class="role">Cards, topbar, inputs</td></tr>
+ <tr><td class="tname">--amb-surface-raised</td>
+ <td><span class="sw"><i style="background:#E9EEF4"></i><code>#E9EEF4</code></span></td>
+ <td><span class="sw"><i style="background:#232A34"></i><code>#232A34</code></span></td>
+ <td class="role">Pills, hovered rows</td></tr>
+ <tr><td class="tname">--amb-line</td>
+ <td><span class="sw"><i style="background:#D3DAE3"></i><code>#D3DAE3</code></span></td>
+ <td><span class="sw"><i style="background:#2F3945"></i><code>#2F3945</code></span></td>
+ <td class="role">1 px borders and dividers</td></tr>
+ <tr><td class="tname">--amb-rail</td>
+ <td><span class="sw"><i style="background:#141B24"></i><code>#141B24</code></span></td>
+ <td><span class="sw"><i style="background:#141B24"></i><code>#141B24</code></span></td>
+ <td class="role">Nav rail — dark in both themes</td></tr>
+ <tr><td class="tname">--amb-rail-ink</td>
+ <td><span class="sw"><i style="background:#C9D4E2"></i><code>#C9D4E2</code></span></td>
+ <td><span class="sw"><i style="background:#C9D4E2"></i><code>#C9D4E2</code></span></td>
+ <td class="role">Rail label and inactive glyph</td></tr>
+ <tr><td class="tname">--amb-brand</td>
+ <td><span class="sw"><i style="background:#0091A7"></i><code>#0091A7</code></span></td>
+ <td><span class="sw"><i style="background:#3FC3D6"></i><code>#3FC3D6</code></span></td>
+ <td class="role">Mark apex; focus ring; active nav</td></tr>
+ <tr><td class="tname">--amb-brand-strong</td>
+ <td><span class="sw"><i style="background:#046B80"></i><code>#046B80</code></span></td>
+ <td><span class="sw"><i style="background:#6FD8E6"></i><code>#6FD8E6</code></span></td>
+ <td class="role">Brand-coloured text and links</td></tr>
+ <tr><td class="tname">--amb-danger</td>
+ <td><span class="sw"><i style="background:#C23B2E"></i><code>#C23B2E</code></span></td>
+ <td><span class="sw"><i style="background:#F0796B"></i><code>#F0796B</code></span></td>
+ <td class="role">Error finding; disconnected</td></tr>
+ <tr><td class="tname">--amb-warning</td>
+ <td><span class="sw"><i style="background:#A45F0B"></i><code>#A45F0B</code></span></td>
+ <td><span class="sw"><i style="background:#F2A63C"></i><code>#F2A63C</code></span></td>
+ <td class="role">Warning finding; health check</td></tr>
+ <tr><td class="tname">--amb-info</td>
+ <td><span class="sw"><i style="background:#2457C5"></i><code>#2457C5</code></span></td>
+ <td><span class="sw"><i style="background:#7FA6F5"></i><code>#7FA6F5</code></span></td>
+ <td class="role">Info finding; status readout</td></tr>
+ <tr><td class="tname">--amb-success</td>
+ <td><span class="sw"><i style="background:#127A4B"></i><code>#127A4B</code></span></td>
+ <td><span class="sw"><i style="background:#3FCB8B"></i><code>#3FCB8B</code></span></td>
+ <td class="role">Connected; passed; approved</td></tr>
+ <tr><td class="tname">--amb-pending</td>
+ <td><span class="sw"><i style="background:#6D3FB8"></i><code>#6D3FB8</code></span></td>
+ <td><span class="sw"><i style="background:#B79AF0"></i><code>#B79AF0</code></span></td>
+ <td class="role">Awaiting a human decision</td></tr>
+ <tr><td class="tname">--amb-idle</td>
+ <td><span class="sw"><i style="background:#5B6676"></i><code>#5B6676</code></span></td>
+ <td><span class="sw"><i style="background:#9BA8B9"></i><code>#9BA8B9</code></span></td>
+ <td class="role">Inert: not run yet, disabled, n/a</td></tr>
+ </tbody>
+ </table>
+ </div>
+ </div>
+ </section>
+
+ <!-- ================= TYPE ================= -->
+ <section>
+ <div class="margin">
+ <h2>Type</h2>
+ <p>Segoe UI stays, for everything, and this is now a decision rather than
+ an accident.</p>
+ <p>The panel is a docked pane inside Revit. A webfont would flash on every
+ open and would make the product look like a web page embedded in Revit
+ instead of a part of it. The distinctiveness budget is spent on the mark
+ and the icon grammar.</p>
+ </div>
+ <div class="body">
+ <div class="typerow">
+ <span class="lab">18 / 650</span>
+ <span style="font-size:18px;font-weight:650;line-height:1.2">Findings</span>
+ <span class="lab">14 / 600</span>
+ <span style="font-size:14px;font-weight:600;line-height:1.3">Wall joins unmitred</span>
+ <span class="lab">13 / 400</span>
+ <span style="font-size:13px;line-height:1.45">Six walls on grid C meet without a mitre. Corners will render open in section.</span>
+ <span class="lab">12 / 400</span>
+ <span style="font-size:12px;line-height:1.45;color:var(--muted)">4 findings in Level 2 — Structure</span>
+ <span class="lab">11 / 400</span>
+ <span style="font-size:11px;line-height:1.4;color:var(--faint);font-variant-numeric:tabular-nums">14:02:11 · health check complete</span>
+ <span class="lab">11 / 600</span>
+ <span class="on-dark"><span class="badge pending">pending</span></span>
+ <span class="lab">10 / 600</span>
+ <span style="font-size:10px;font-weight:600;letter-spacing:.06em;color:var(--muted)">AMB</span>
+ </div>
+ <p style="margin:22px 0 0;font-size:12.5px;color:var(--faint);max-width:62ch">
+ Sentence case for all UI strings. <code style="font-family:ui-monospace,Consolas,monospace">font-variant-numeric: tabular-nums</code>
+ on the run log, finding counts and timestamps, so columns of numbers stop
+ shifting as they update.
+ </p>
+ </div>
+ </section>
+
+ <footer>
+ Every value on this sheet is written out in <code>docs/design/tokens.md</code>
+ and hand-copied from there into <code>assets/logo.svg</code>,
+ <code>packages/revit-bridge-addin/src/UI/IconGenerator.cs</code> and
+ <code>panel/styles.css</code>, each under a
+ <code>// keep in sync with docs/design/tokens.md</code> comment. There is no
+ token build step, on purpose.
+ </footer>
+
+</div>
+</body>
+</html>
diff --git a/docs/design/tokens.md b/docs/design/tokens.md
new file mode 100644
index 0000000..be83f6f
--- /dev/null
+++ b/docs/design/tokens.md
@@ -0,0 +1,545 @@
+# AEC Model Bridge — design tokens
+
+Status: **proposed**, pending maintainer approval.
+Scope: the brand mark, the color system, typography, and the ribbon icon
+grammar for `assets/logo.svg`, `packages/revit-bridge-addin/src/UI/IconGenerator.cs`,
+and `panel/styles.css`.
+
+This file is the single source of truth. There is **no codegen and no token
+sync tool** — that is deliberate (ADR-free decision for a solo maintainer with
+no bundler in `panel/`). Every value below is hand-copied into the three
+renderers, and each copy site carries the comment:
+
+```
+// keep in sync with docs/design/tokens.md
+```
+
+Companion file: `docs/design/review.html` — open it in a browser to see every
+token on this page rendered at real size.
+
+---
+
+## 1. What is being replaced
+
+| Today | Problem |
+| --- | --- |
+| `assets/logo.svg` — isometric cube + "AEC / BRIDGE" text | Cube #1 |
+| `IconGenerator.CreateBrandIcon()` — a *different* isometric cube, gradient-shaded | Cube #2, disagrees with cube #1 |
+| `panel/styles.css` `.brand-mark` — a 3-color gradient square | Not a cube at all; disagrees with both |
+| 9 ribbon icons, 8 unrelated accent hues | No system; nothing means anything |
+| `pending` = violet on the ribbon, grey in `.badge.pending` | Same concept, two colors |
+
+All five are replaced by **one mark** and **one palette** below.
+
+---
+
+## 2. The mark — "the Span"
+
+### 2.1 Concept
+
+A span, drawn flat: **two anchor nodes joined by a deck, and the bridge itself
+standing above them.** It is the existing `CreateConnectIcon()` motif promoted
+to primary mark — the same three parts, reproportioned and resolved.
+
+- **Two anchor nodes** joined by a **deck** — the model and the agent, the two
+ things being connected.
+- **One apex** above them — the bridge process.
+
+Four shapes: one line, two circles, one triangle. No gradients, no shading, no
+3D. That is what makes it reproducible to the pixel in SVG, WPF
+`DrawingVisual` and CSS, which the cube never was.
+
+**The apex is not tied to the nodes by drawn lines.** It is tied to them by
+alignment: the apex's base edge and the deck are both exactly `0.340` wide and
+sit on the same two vertical axes, `x = 0.330` and `x = 0.670`. One module,
+stated twice. Drawn connector lines were tried in five variants and every one
+of them turned the mark into a capital **A** — the connector continues the
+apex's own leg, and the deck becomes the crossbar. Alignment says the same
+thing and stays a mark.
+
+### 2.2 Geometry — exact
+
+All coordinates are fractions of a `size × size` box, same convention as
+`IconGenerator.cs` (multiply by `size`). Origin top-left, y grows downward.
+
+| # | Element | Geometry | Stroke | Fill |
+| --- | --- | --- | --- | --- |
+| 1 | Apex wash | closed polygon `(0.500, 0.085)` → `(0.670, 0.430)` → `(0.330, 0.430)` | none | brand wash |
+| 2 | Node wash, left | circle center `(0.190, 0.725)`, r `0.140` | none | ink wash |
+| 3 | Node wash, right | circle center `(0.810, 0.725)`, r `0.140` | none | ink wash |
+| 4 | Deck | line `(0.330, 0.725)` → `(0.670, 0.725)` | **ink** | — |
+| 5 | Node, left | circle center `(0.190, 0.725)`, r `0.140` | **ink** | none |
+| 6 | Node, right | circle center `(0.810, 0.725)`, r `0.140` | **ink** | none |
+| 7 | Apex | closed polygon `(0.500, 0.085)` → `(0.670, 0.430)` → `(0.330, 0.430)` | **brand** | none |
+
+Draw in the order given (1 → 7). Rows 1–3 are unstroked fills painted first;
+rows 4–7 are unfilled strokes painted on top. Rows 1 and 7 are the same
+polygon, once filled and once stroked — in SVG that is a single `<polygon>`
+with both `fill` and `stroke`; the two rows are split here only because WPF
+`DrawGeometry(fill, pen, geo)` and CSS take them separately.
+
+The same geometry is used at **every** size, 16 px to 300 px. There is no
+optical-size variant to keep in sync across three renderers.
+
+Relationships worth preserving if anyone ever nudges this:
+
+- Node edge `0.190 + 0.140 = 0.330` — the deck starts exactly where the left
+ node ends, and ends exactly where the right node begins.
+- Apex base spans `0.330 → 0.670`, the same `0.340` module as the deck.
+- Ink extents: `x 0.020 → 0.980`, `y 0.055 → 0.895` at `stroke = 0.06`. Optical
+ center `y ≈ 0.475`, deliberately a touch above the box center because the
+ figure is top-heavy.
+
+### 2.3 Stroke
+
+```
+stroke = clamp( round(size × 0.06 × 2) / 2 , min 1.5 , ∞ )
+```
+
+Snapped to half a pixel, floor 1.5 px. This is exactly the existing
+`IconGenerator.StrokeWidth(size, 0.06)` contract — do not change that helper.
+
+| size | stroke |
+| --- | --- |
+| 16 | 1.5 |
+| 24 | 1.5 |
+| 32 | 2.0 |
+| 48 | 3.0 |
+| 96 | 6.0 |
+| 300 | 18.0 |
+
+Caps: **round**. Joins: **round**. (Same as today.)
+
+### 2.4 Paint
+
+Two-tone. The **deck and nodes are ink** — the model and the agent, the things
+that already exist. The **apex is brand** — the bridge, the only thing this
+product adds. That split is the reason the mark is not just a triangle, and it
+is what tells the brand mark apart from the monochrome Connect icon two
+buttons away on the same ribbon.
+
+| Part | Light theme | Dark theme |
+| --- | --- | --- |
+| Deck, node strokes | `--amb-ink` `#18202C` | `--amb-ink` `#E9EEF5` |
+| Node wash fill | `rgba(24, 32, 44, 0.12)` | `rgba(233, 238, 245, 0.16)` |
+| Apex stroke | `--amb-brand` `#0091A7` | `--amb-brand` `#3FC3D6` |
+| Apex wash fill | `rgba(0, 145, 167, 0.20)` | `rgba(63, 195, 214, 0.20)` |
+
+The ink wash is lighter than the accent wash on purpose. A near-white fill at
+`0.20` over a dark surface turns the nodes into solid discs and the deck reads
+as a strike-through; a near-black fill at `0.20` over white is just as heavy.
+Accent hues are mid-luminance and take `0.20` in both themes.
+
+**Monochrome variant** (favicon, disabled state, single-color print, and the
+Connect / Disconnect icons): every stroke in one color, every wash in that
+color at `0.20`.
+
+### 2.5 Wordmark lockup — for `assets/logo.svg` and the README
+
+```
+viewBox="0 0 560 168"
+```
+
+| Item | Placement |
+| --- | --- |
+| Mark | `size = 120`, translated to `(24, 24)` — i.e. mark box occupies `x 24…144`, `y 24…144` |
+| "AEC Model Bridge" | Segoe UI, weight 600, `font-size: 46`, `letter-spacing: 0`, `fill: #18202C`, baseline at `x = 188, y = 88` |
+| "Model context for Revit" | Segoe UI, weight 400, `font-size: 19`, `letter-spacing: 0.2`, `fill: #5B6676`, baseline at `x = 190, y = 120` |
+
+- Sentence case. No tracked-out caps, no em-dash fragments.
+- Clear space on all sides: **≥ 0.25 × mark size** (30 px at the lockup scale).
+- Minimum reproduction size of the mark alone: **16 px**. Minimum for the full
+ lockup: **180 px** wide.
+- `assets/logo.svg` ships the **light-theme** paint and adds
+ `@media (prefers-color-scheme: dark)` inside its `<style>` block so it also
+ reads on GitHub's dark README.
+- The isometric cube polygons and the `AEC` / `BRIDGE` text in the current file
+ are deleted outright — not recolored.
+
+### 2.6 Panel rail mark (`panel/styles.css` `.brand-mark`)
+
+Replace the three stacked `linear-gradient()`s with the mark as an inline
+`<svg>` in `panel/index.html` (26 × 26, two-tone, dark-rail paint).
+Do **not** try to rebuild the mark out of CSS gradients — that is how the
+third inconsistent mark happened.
+
+---
+
+## 3. Color
+
+### 3.1 Reading the table
+
+Every token resolves to one value under the light theme and one under the dark
+theme, exactly like the existing `@media (prefers-color-scheme: dark)` block in
+`panel/styles.css`. On the ribbon, `IconGenerator.IsDarkTheme()` already makes
+the same choice.
+
+Contrast figures are measured against that theme's `--amb-surface`
+(`#FFFFFF` / `#1C222B`), or against white for the solid badge fills.
+
+### 3.2 Neutrals — the structure
+
+| Token | Light | Dark | Role |
+| --- | --- | --- | --- |
+| `--amb-ink` | `#18202C` | `#E9EEF5` | Primary text; every icon's structural stroke |
+| `--amb-ink-muted` | `#5B6676` | `#9BA8B9` | Secondary text, metadata, inactive icon |
+| `--amb-bg` | `#F2F5F8` | `#14181E` | App background |
+| `--amb-surface` | `#FFFFFF` | `#1C222B` | Cards, topbar, inputs |
+| `--amb-surface-raised` | `#E9EEF4` | `#232A34` | Pills, hovered rows, segmented controls |
+| `--amb-line` | `#D3DAE3` | `#2F3945` | 1 px borders and dividers |
+| `--amb-rail` | `#141B24` | `#141B24` | Nav rail — **dark in both themes**, as today |
+| `--amb-rail-ink` | `#C9D4E2` | `#C9D4E2` | Nav rail label and inactive glyph |
+
+Measured: ink 16.4:1 light / 13.7:1 dark. Muted 5.8:1 light / 6.7:1 dark.
+
+`--amb-ink` light is `#18202C`, the value already in `panel/styles.css`.
+Kept on purpose — it is correct, and continuity beats novelty for neutrals.
+
+### 3.3 Brand
+
+| Token | Light | Dark | Role |
+| --- | --- | --- | --- |
+| `--amb-brand` | `#0091A7` | `#3FC3D6` | Mark apex; focus ring; active nav indicator |
+| `--amb-brand-strong` | `#046B80` | `#6FD8E6` | Brand-colored **text** and links; primary button hover |
+| `--amb-brand-wash` | `rgba(0, 145, 167, 0.14)` | `rgba(63, 195, 214, 0.14)` | Tinted brand surfaces |
+
+Measured: `--amb-brand` 3.8:1 on white, 4.2:1 on `#1C222B` — above the 3:1
+floor for graphics in both themes, which is why one hue serves both.
+`--amb-brand-strong` 5.6:1 / 9.7:1 — safe for text.
+
+**Why this hue.** It is the one saturated family that no semantic token below
+occupies, so the brand never gets read as a status. It is also the color of an
+instrument readout — displacement plots, point-cloud intensity, total-station
+displays — which is the vernacular this product actually lives in. It is
+deliberately *not* Autodesk's `#0696D7`: the panel is a guest inside Revit, not
+a part of it.
+
+**Primary buttons.** `panel/styles.css` currently paints the submit/save
+buttons with `--blue` (`#2563eb`), which is now the *info* token. Repaint them
+with `--amb-brand` (light) / `--amb-brand` (dark) and white / `#06222A` label
+respectively.
+
+### 3.4 Semantic — shared by ribbon icons and panel badges
+
+| Token | Light | Dark | Meaning |
+| --- | --- | --- | --- |
+| `--amb-danger` | `#C23B2E` | `#F0796B` | Error finding; disconnected; destructive action |
+| `--amb-warning` | `#A45F0B` | `#F2A63C` | Warning finding; health check; degraded |
+| `--amb-info` | `#2457C5` | `#7FA6F5` | Info finding; status readout; report |
+| `--amb-success` | `#127A4B` | `#3FCB8B` | Connected; passed; approved |
+| `--amb-pending` | `#6D3FB8` | `#B79AF0` | Awaiting a human decision |
+| `--amb-idle` | `#5B6676` | `#9BA8B9` | Inert: not run yet, disabled, n/a |
+
+Measured against white (the solid badge label color), light column:
+danger 5.3:1, warning 5.0:1, info 6.5:1, success 5.4:1, pending 6.8:1,
+idle 5.8:1. All pass AA for 11 px text.
+Measured against `#1C222B`, dark column: 5.8 / 7.9 / 6.6 / 7.7 / 6.8 / 6.7.
+
+> The current `.badge.warning` uses `#b7791f`, which is **3.6:1 against its own
+> white label** — it fails AA today. `#A45F0B` is the fix, not a restyle.
+
+### 3.5 The `pending` mismatch — resolved
+
+**`pending` is violet. `#6D3FB8` light, `#B79AF0` dark. Both surfaces.**
+
+- `IconGenerator.CreatePendingIcon()`: `#7B1FA2` → `--amb-pending`.
+- `panel/styles.css` `.badge.pending`: `#64748b` → `--amb-pending`.
+
+The ribbon was right and the panel was wrong. `pending` in this product means
+"a plan is sitting in the approval queue and nothing moves until you act"
+(ADR 0008). That is the single most action-required state in the app, and grey
+is the universal signal for *ignore me*. A grey approval queue is a queue
+nobody empties.
+
+Violet, not amber or red, because nothing is wrong — it is held, not failing.
+Violet is also the only semantic hue with no other job in this palette.
+
+The vacated grey is **not** deleted. It becomes `--amb-idle` and now has a real
+job: states that genuinely are inert — a health check that has never run, a
+disabled nav item, an unavailable provider.
+
+**Implementer note for Task 7:** `panel/app.js` `renderPlans()` hardcodes
+`class="badge pending"` while printing `plan.status` as the label, so a plan
+whose status is `approved` currently renders a violet "approved" badge. Map the
+status string to a token class (`approved` → `success`, `rejected` → `danger`,
+`pending`/anything else → `pending`) at the same time.
+
+### 3.6 Badge treatment
+
+Light theme — solid fill, white label:
+
+```css
+.badge { border-radius: 999px; padding: 3px 9px; font-size: 11px;
+ font-weight: 600; letter-spacing: 0.01em;
+ text-transform: capitalize; color: #fff; }
+.badge.error { background: #C23B2E; }
+.badge.warning { background: #A45F0B; }
+.badge.info { background: #2457C5; }
+.badge.success { background: #127A4B; }
+.badge.pending { background: #6D3FB8; }
+.badge.idle { background: #5B6676; }
+```
+
+Dark theme — 14 % tint, 40 % hairline, lifted label:
+
+```css
+.badge.error { background: rgba(240,121,107,.14); border: 1px solid rgba(240,121,107,.40); color: #F0796B; }
+.badge.warning { background: rgba(242,166, 60,.14); border: 1px solid rgba(242,166, 60,.40); color: #F2A63C; }
+.badge.info { background: rgba(127,166,245,.14); border: 1px solid rgba(127,166,245,.40); color: #7FA6F5; }
+.badge.success { background: rgba( 63,203,139,.14); border: 1px solid rgba( 63,203,139,.40); color: #3FCB8B; }
+.badge.pending { background: rgba(183,154,240,.14); border: 1px solid rgba(183,154,240,.40); color: #B79AF0; }
+.badge.idle { background: rgba(155,168,185,.14); border: 1px solid rgba(155,168,185,.40); color: #9BA8B9; }
+```
+
+The 14 % tint is the largest value that still leaves the lifted label at
+≥ 4.5:1 over the tinted surface (measured 4.7:1 for the tightest case, danger).
+Do not raise it.
+
+Add `border: 1px solid transparent` to the base `.badge` rule so the box does
+not resize between themes.
+
+`text-transform` changes from `uppercase` to `capitalize`. Uppercase at 11 px
+costs real legibility on words like "warning" and buys nothing; the pill shape
+already marks it as a status.
+
+### 3.6.1 Alpha washes
+
+| Name | Alpha | Hex byte (WPF `Color.FromArgb`) | Used for |
+| --- | --- | --- | --- |
+| wash | `0.14` | `0x24` (36) | Badge tints, tinted panel surfaces |
+| wash-strong | `0.20` | `0x33` (51) | Accent interior fills in icons and the mark |
+| wash-ink | `0.12` light / `0.16` dark | `0x1F` (31) / `0x29` (41) | Ink interior fills in icons and the mark |
+
+Only these two. The current icons use four different alphas (`32`, `64`, `90`,
+and opaque) — that is part of what makes the ribbon look assembled rather than
+designed.
+
+### 3.7 Surface treatment — the glassmorphism the ADR promised
+
+ADR 0011 §4 committed to "sleek dark mode default, subtle micro-animations,
+glassmorphism card layouts". Delivering that means exactly two translucent
+surfaces — the rail and the topbar — not translucent everything.
+
+```css
+/* dark */
+--amb-glass: rgba(28, 34, 43, 0.72);
+--amb-glass-line: rgba(255, 255, 255, 0.07);
+--amb-glass-filter: blur(14px) saturate(140%);
+
+/* light */
+--amb-glass: rgba(255, 255, 255, 0.72);
+--amb-glass-line: rgba(16, 24, 40, 0.08);
+--amb-glass-filter: blur(14px) saturate(120%);
+```
+
+Applied to `.rail` and `.topbar` only. Cards, inputs and list rows stay opaque
+— glass behind body text is a legibility tax with no benefit.
+
+Elevation:
+
+```css
+/* light */ --amb-shadow-1: 0 1px 2px rgba(16,24,40,.08);
+ --amb-shadow-2: 0 6px 16px rgba(16,24,40,.10);
+/* dark */ --amb-shadow-1: 0 1px 0 rgba(255,255,255,.04) inset;
+ --amb-shadow-2: 0 1px 0 rgba(255,255,255,.04) inset, 0 10px 28px rgba(0,0,0,.45);
+```
+
+Radius: `4` chips · `6` buttons, inputs, selects · `8` cards, alerts, messages ·
+`10` the rail mark plate · `999` pills and badges.
+
+Spacing scale (px): `4 · 6 · 8 · 12 · 16 · 24 · 32`.
+
+Focus ring — one rule, everywhere, replacing the current
+`button:hover { border-color: … }` as the only visible affordance:
+
+```css
+:focus-visible { outline: none;
+ box-shadow: 0 0 0 2px var(--amb-bg), 0 0 0 4px var(--amb-brand); }
+```
+
+Motion:
+
+```css
+--amb-motion-fast: 120ms cubic-bezier(.4, 0, .2, 1); /* hover, press */
+--amb-motion-view: 180ms cubic-bezier(.2, .7, .3, 1); /* view switch */
+@media (prefers-reduced-motion: reduce) { * { animation: none !important; transition: none !important; } }
+```
+
+---
+
+## 4. Typography
+
+**Decision: keep `"Segoe UI", system-ui, sans-serif` for everything.**
+Recorded explicitly so it stops being an accident.
+
+One family, no display face, no webfont. The panel is a docked pane inside
+Revit; a loaded webfont would flash on every panel open and would make the app
+look like a web page embedded in Revit rather than a part of it. Distinctiveness
+is spent on the mark and the icon grammar instead.
+
+| Role | Size | Weight | Line height | Notes |
+| --- | --- | --- | --- | --- |
+| View title (`h1`) | 18 px | 650 | 1.2 | Unchanged from today |
+| Card title (`h2`) | 14 px | 600 | 1.3 | |
+| Body | 13 px | 400 | 1.45 | |
+| Secondary / detail | 12 px | 400 | 1.45 | `--amb-ink-muted` |
+| Metadata, timestamps | 11 px | 400 | 1.4 | `--amb-ink-muted` |
+| Badge | 11 px | 600 | 1 | `letter-spacing: .01em`, capitalize |
+| Rail label ("AMB") | 10 px | 600 | 1 | `letter-spacing: .06em` |
+
+Additional rules:
+
+- Sentence case for all UI strings. No tracked-out all-caps eyebrow labels.
+- `font-variant-numeric: tabular-nums` on the run log, finding counts, and any
+ timestamp, so columns of numbers stop shifting.
+- Body copy caps at ~72 characters per line; the panel is narrow enough that
+ this only affects the settings view.
+- The wordmark is the same family at weight 600 — the mark carries the
+ identity, the wordmark just says the name.
+
+---
+
+## 5. Icon system
+
+### 5.1 The grammar — one rule for all nine
+
+> **Structure is ink. One accent, and only if the icon reports a state.**
+
+Every icon is drawn with `--amb-ink` strokes. Then:
+
+- **State icons** — the icon reports a condition the user should scan for —
+ get exactly one element in a semantic color.
+- **Action icons** — the icon is a verb with no condition attached — get
+ **no accent at all**. Ink only, with interiors filled at wash-ink.
+
+That is the whole system. It is why the ribbon currently looks like eight
+unrelated stickers: eight icons, eight hues, none of them meaning anything. A
+ribbon where only the five state icons are colored is scannable at a glance.
+
+Brand cyan appears on the brand mark and nowhere else in the ribbon, which is
+what makes the brand button findable.
+
+Shared across all icons: stroke per §2.3 (`size × 0.06`), round caps, round
+joins, interiors at wash-strong / wash-ink (§3.6.1), `IsDarkTheme()` picks the
+theme column.
+
+### 5.2 Re-targeting table — Task 6 follows this directly
+
+| # | `IconGenerator` method | Tier | Structure | Accent token | Accent light / dark | Was |
+| --- | --- | --- | --- | --- | --- | --- |
+| 1 | `CreateConnectIcon` | state | *mono — accent* | `--amb-success` | `#127A4B` / `#3FCB8B` | `#2E7D32` emerald |
+| 2 | `CreateDisconnectIcon` | state | *mono — accent* | `--amb-danger` | `#C23B2E` / `#F0796B` | `#D32F2F` crimson |
+| 3 | `CreateStatusIcon` | state | `--amb-ink` | `--amb-info` | `#2457C5` / `#7FA6F5` | `#0288D1` "Autodesk blue" |
+| 4 | `CreateSettingsIcon` | action | `--amb-ink` | **none** | — | already ink-only |
+| 5 | `CreateHelpIcon` | action | `--amb-ink` | **none** | — | `#009688` teal — dropped |
+| 6 | `CreatePanelIcon` | action | `--amb-ink` | **none** | — | `#3F51B5` indigo — dropped |
+| 7 | `CreateHealthIcon` | state | `--amb-ink` | `--amb-warning` | `#A45F0B` / `#F2A63C` | `#F57C00` amber |
+| 8 | `CreatePendingIcon` | state | `--amb-ink` | `--amb-pending` | `#6D3FB8` / `#B79AF0` | `#7B1FA2` violet |
+| 9 | `CreateReportsIcon` | action | `--amb-ink` | **none** | — | `#1976D2` blue — dropped |
+| — | `CreateBrandIcon` | mark | `--amb-ink` | `--amb-brand` | `#0091A7` / `#3FC3D6` | gradient cube — deleted |
+
+Nine icons, nine explicit assignments, no gaps.
+
+### 5.3 Per-icon notes
+
+**1 · Connect** — becomes the mark of §2.2, drawn **monochrome in
+`--amb-success`**: every stroke green, both washes green at `0.20`. Being
+monochrome is what keeps it distinct from the two-tone brand mark sitting a
+few buttons away on the same ribbon.
+
+**2 · Disconnect** — identical to Connect but monochrome in `--amb-danger`,
+plus a **single** cancel slash `(0.300, 0.290) → (0.700, 0.690)`, stroke
+`size × 0.08`, round caps, same danger color. One slash, not a cross — a cross
+over a triangle is mush at 16 px, and the single diagonal already reads as
+“not connected”. Drop the broken-connector treatment; the slash is the signal.
+
+**3 · Status** — geometry unchanged. Frame, both grid lines and the outer ring
+go to `--amb-ink`; the inner pulse dot (`r = 0.055`, filled) and its `r = 0.14`
+ring stay accented, now `--amb-info`, ring fill at wash-strong.
+
+**4 · Settings** — geometry and paint unchanged. It was already correct; it is
+the reference for the action tier.
+
+**5 · Help** — remove the teal balloon fill and the teal stroke. Circle stroked
+in ink, filled at wash-ink; the `?` glyph in ink. Segoe UI Bold at
+`size × 0.54`, as today.
+
+**6 · Panel** — remove the indigo. Frame and content rows in ink; the docked
+right-hand strip filled at wash-ink with an ink stroke.
+
+**7 · Health** — clipboard body, clip tab and rows in ink; **the checkmark** is
+the accent, `--amb-warning`. Warning rather than success because the tool's job
+is to surface problems, and a permanently green check implies a result the
+button has not produced yet.
+
+**8 · Pending** — the three queue rows in ink; **the clock badge** (ring, fill,
+both hands) in `--amb-pending`, fill at wash-strong. This is the ribbon half of
+the §3.5 fix.
+
+While you are in there, fix the clipping: the badge is currently centred at
+`(0.74, 0.76)` with `r = 0.23`, so its bottom edge lands at `0.99` and the
+stroke is cut off by the bitmap boundary at every size. Move it to
+`(0.730, 0.740)` with `r = 0.210`; hands then run to `(0.730, 0.6245)` and
+`(0.825, 0.761)`.
+
+**9 · Reports** — remove the blue. All three bars filled at wash-ink with ink
+strokes, baseline in ink. The tinted fills keep it from reading hollow.
+
+**Brand** — the two-tone mark of §2.2/§2.4, identical at every size. Delete
+the gradient-cube code entirely.
+
+### 5.4 Panel nav rail glyphs
+
+`panel/index.html` renders the six nav items as single letters
+(`C P F R L S`). Leave them as letters — swapping in six new glyphs is a
+separate piece of work and is not covered by this token set. Style only:
+
+- inactive: `--amb-rail-ink`, weight 600, 13 px
+- hover: `--amb-ink` `#E9EEF5` on `rgba(255,255,255,.08)`
+- active: `--amb-ink` `#E9EEF5` on `rgba(63,195,214,.14)` plus a 2 px
+ `--amb-brand` bar on the rail's inner edge, radius 0 2px 2px 0
+
+---
+
+## 6. Copy-site checklist for Tasks 5–7
+
+| Task | File | Uses |
+| --- | --- | --- |
+| 5 | `assets/logo.svg` | §2.2 geometry, §2.4 light paint + dark media query, §2.5 lockup |
+| 6 | `packages/revit-bridge-addin/src/UI/IconGenerator.cs` | §2.2–2.4 for `CreateBrandIcon`/`CreateConnectIcon`/`CreateDisconnectIcon`, §3.2–3.4 hexes, §3.6.1 alpha bytes, §5.2 table, §5.3 notes |
+| 7 | `panel/styles.css`, `panel/index.html`, `panel/app.js` | §2.6 inline rail mark, §3.2–3.7 all tokens, §3.5 badge fix + `renderPlans()` status mapping, §4 type scale, §5.4 rail glyph styling |
+
+Each of the three files gets a `// keep in sync with docs/design/tokens.md`
+comment at the top of the block that carries copied values.
+
+---
+
+## 7. Full value index
+
+```
+--amb-ink #18202C #E9EEF5
+--amb-ink-muted #5B6676 #9BA8B9
+--amb-bg #F2F5F8 #14181E
+--amb-surface #FFFFFF #1C222B
+--amb-surface-raised #E9EEF4 #232A34
+--amb-line #D3DAE3 #2F3945
+--amb-rail #141B24 #141B24
+--amb-rail-ink #C9D4E2 #C9D4E2
+--amb-brand #0091A7 #3FC3D6
+--amb-brand-strong #046B80 #6FD8E6
+--amb-danger #C23B2E #F0796B
+--amb-warning #A45F0B #F2A63C
+--amb-info #2457C5 #7FA6F5
+--amb-success #127A4B #3FCB8B
+--amb-pending #6D3FB8 #B79AF0
+--amb-idle #5B6676 #9BA8B9
+--amb-on-brand #FFFFFF #06222A
+wash 0.14 (0x24)
+wash-strong 0.20 (0x33) accent fills
+wash-ink 0.12 / 0.16 (0x1F / 0x29) ink fills
+```
+
+Seventeen tokens. Retired: `#2E7D32`, `#D32F2F`, `#0288D1`, `#009688`, `#3F51B5`,
+`#F57C00`, `#7B1FA2`, `#1976D2`, `#00BCD4`, `#2196F3`, `#1565C0`, `#00695C`,
+`#64748b`, `#b7791f`, `#c2413a`, `#0f8a5f`, `#2563eb`, `#14b8a6`, `#8b5cf6`,
+`#60a5fa`, `#93c5fd`, `#3b82f6`.