Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.
Python aecai-agentsautodeskautomationbimclaudeifcmcpmcp-servermodel-context-protocolnavisworksrevitrevit-addinrevit-apirhino
docs: README visual set with a rebuildable build script (#54)
A. Sam Mohammad24d1e96b75fb
diff --git a/docs/design/readme-visuals/README.md b/docs/design/readme-visuals/README.mdnew file mode 100644index 0000000..b07c0e3--- /dev/null+++ b/docs/design/readme-visuals/README.md@@ -0,0 +1,73 @@+# README visual set++Editable SVG sources are in `src/`; optimized PNGs are in `docs/images/readme/`.+`build.mjs` is the single source of truth: it writes the SVGs, renders the PNGs and holds the+text (title and `<desc>`) that doubles as alt text.++## Rebuild++Needs Playwright with Chromium and the **Inter** font (the build stops if Inter is missing).+ImageMagick 7 (`magick`) is optional and only shrinks the PNGs.++```bash+# bash+NODE_PATH=$(npm root -g) node docs/design/readme-visuals/build.mjs+```++```powershell+# PowerShell+$env:NODE_PATH = (npm root -g); node docs/design/readme-visuals/build.mjs+```++| Variable | Effect |+|---|---|+| `PNG_DIR` | Output folder for the PNGs (default `docs/images/readme`). |+| `WITH_PLACEHOLDER=1` | Also render `demo-cover.png`, the placeholder cover. Off by default. |++Text stays live `<text>` in the SVGs. The Pier logo is embedded verbatim from+`assets/logo-mark.svg` and is not redrawn. Pixel sizes are exact. When `magick` is found the+PNGs are palette-reduced (128 colours, no dither); the build prints how many were reduced.++## Known gap: palette drift++The colours in `build.mjs` are derived from `docs/design/tokens.md` but no longer match it+(dark background, surface and raised values, and the light-theme brand accent). The panel and+dialogs follow `tokens.md`, so these images are slightly off-palette in dark mode. Fixing it+changes every PNG, so it needs a rebuild on a machine that has Playwright and Inter.++## Assets++| Asset | PNG (docs/images/readme/) | Source (src/) | Size |+|---|---|---|---|+| README hero, light | `readme-hero-light.png` | `readme-hero-light.svg` | 1600 × 700 |+| README hero, dark | `readme-hero-dark.png` | `readme-hero-dark.svg` | 1600 × 700 |+| Workflow, light | `readme-workflow-light.png` | `readme-workflow-light.svg` | 1600 × 500 |+| Workflow, dark | `readme-workflow-dark.png` | `readme-workflow-dark.svg` | 1600 × 500 |+| Social preview | `social-preview.png` | `social-preview.svg` | 1280 × 640 |+| Demo cover (placeholder) | not shipped | `demo-cover.svg` | 1600 × 900 |++The demo cover is only a template with a dashed "screenshot placeholder" box. Do not publish a+PNG of it. Add the PNG only after you have a real capture from live Revit (mock mode returns+canned responses and is not a live demonstration).++## Alt text++Use the SVG title followed by its `<desc>`, exactly as written in `build.mjs`:++- **Hero:** "Find parameter issues. Review the fixes. A BIM model with a door flagged for an empty Mark parameter and a callout showing the reviewed correction. Example values."+- **Workflow:** "Inspect, Propose, Approve, Verify. Four steps: inspect finds an empty Mark, propose drafts a change, approve is a human decision, verify reads the value back. Example values are illustrative."+- **Social preview:** "AEC Model Bridge. AEC Model Bridge with the Pier logo, an architectural model illustration and the line AI-assisted BIM coordination."++## README embed (light and dark)++Use absolute URLs. Relative paths break on directory sites that mirror the README.++```html+<picture>+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Sam-AEC/aec-model-bridge/main/docs/images/readme/readme-hero-dark.png">+ <img src="https://raw.githubusercontent.com/Sam-AEC/aec-model-bridge/main/docs/images/readme/readme-hero-light.png" alt="Find parameter issues. Review the fixes. A BIM model with a door flagged for an empty Mark parameter and a callout showing the reviewed correction. Example values." width="900">+</picture>+```++Use the same pattern for `readme-workflow-*.png`. Upload `social-preview.png` under+Settings > Social preview.diff --git a/docs/design/readme-visuals/build.mjs b/docs/design/readme-visuals/build.mjsnew file mode 100644index 0000000..09d2abe--- /dev/null+++ b/docs/design/readme-visuals/build.mjs@@ -0,0 +1,314 @@+// Builds the README visual set: editable SVG sources + PNG exports.+//+// bash: NODE_PATH=$(npm root -g) node docs/design/readme-visuals/build.mjs+// PowerShell: $env:NODE_PATH = (npm root -g); node docs/design/readme-visuals/build.mjs+//+// Needs Playwright with Chromium and the Inter font installed (the build stops if Inter+// is missing). ImageMagick 7 (`magick`) is optional and only shrinks the PNGs.+// Env: PNG_DIR = output folder (default docs/images/readme),+// WITH_PLACEHOLDER=1 also renders the demo-cover placeholder PNG.+// PALETTE NOTE: the values in THEMES are derived from docs/design/tokens.md but have+// drifted from it (dark bg/surface/raised, light brand accent). Aligning them needs a+// rebuild on a machine with Playwright and Inter. The Pier logo is embedded verbatim+// from assets/logo-mark.svg and is never redrawn.+import fs from 'node:fs';+import path from 'node:path';+import { createRequire } from 'node:module';+import { fileURLToPath } from 'node:url';+import { execFileSync } from 'node:child_process';++const require = createRequire(import.meta.url);+const { chromium } = require('playwright');++const here = path.dirname(fileURLToPath(import.meta.url));+const root = path.resolve(here, '../../..');+const srcDir = path.join(here, 'src');+const pngDir = process.env.PNG_DIR || path.join(root, 'docs/images/readme');+fs.mkdirSync(srcDir, { recursive: true });+fs.mkdirSync(pngDir, { recursive: true });++// ---------------------------------------------------------------- tokens+const THEMES = {+ light: {+ bg: '#F2F5F8', surface: '#FFFFFF', raised: '#E9EEF4', line: '#D3DAE3',+ ink: '#18202C', muted: '#5B6676', brand: '#1CB5CA', brandText: '#046B80',+ warn: '#A45F0B', warnBg: 'rgba(164,95,11,0.12)', ok: '#127A4B', okBg: 'rgba(18,122,75,0.12)',+ pend: '#6D3FB8', pendBg: 'rgba(109,63,184,0.12)', btnText: '#0B1118',+ top: '#FFFFFF', left: '#EAF0F5', right: '#D6DFE9', stroke: '#18202C',+ glass: 'rgba(28,181,202,0.22)', ground: '#E4EAF0', logoRing: 'none',+ },+ dark: {+ bg: '#0D131B', surface: '#151D28', raised: '#1C2530', line: '#2F3945',+ ink: '#E9EEF5', muted: '#9BA8B9', brand: '#1CB5CA', brandText: '#6FD8E6',+ warn: '#F2A63C', warnBg: 'rgba(242,166,60,0.16)', ok: '#3FCB8B', okBg: 'rgba(63,203,139,0.16)',+ pend: '#B79AF0', pendBg: 'rgba(183,154,240,0.16)', btnText: '#0B1118',+ top: '#2D3B4A', left: '#1E2935', right: '#141C26', stroke: '#C9D4E2',+ glass: 'rgba(28,181,202,0.30)', ground: '#111A24', logoRing: '#3A4756',+ },+};+const FONT = "Inter, 'Helvetica Neue', Arial, sans-serif";++// ---------------------------------------------------------------- helpers+const esc = (s) => String(s).replace(/&/g, '&').replace(/</g, '<');+const f1 = (n) => (+n).toFixed(1);++const text = (x, y, s, { size = 26, weight = 500, fill, anchor, ls, italic, id } = {}) =>+ `<text${id ? ` id="${id}"` : ''} x="${x}" y="${y}" font-size="${size}" font-weight="${weight}" fill="${fill}"` ++ `${anchor ? ` text-anchor="${anchor}"` : ''}${ls ? ` letter-spacing="${ls}"` : ''}${italic ? ' font-style="italic"' : ''}>${esc(s)}</text>`;++const rect = (x, y, w, h, r = 0, o = {}) =>+ `<rect x="${x}" y="${y}" width="${w}" height="${h}"${r ? ` rx="${r}"` : ''} fill="${o.fill ?? 'none'}"` ++ `${o.stroke ? ` stroke="${o.stroke}" stroke-width="${o.sw ?? 2}"` : ''}${o.dash ? ` stroke-dasharray="${o.dash}"` : ''}/>`;++const line = (x1, y1, x2, y2, stroke, w = 2, extra = '') =>+ `<line x1="${x1}" y1="${y1}" x2="${x2}" y2="${y2}" stroke="${stroke}" stroke-width="${w}" stroke-linecap="round" ${extra}/>`;++const check = (cx, cy, r, color, onColor) =>+ `<circle cx="${cx}" cy="${cy}" r="${r}" fill="${color}"/>` ++ `<path d="M${cx - r * 0.42} ${cy + r * 0.02} L${cx - r * 0.1} ${cy + r * 0.34} L${cx + r * 0.46} ${cy - r * 0.34}" fill="none" stroke="${onColor}" stroke-width="${r * 0.2}" stroke-linecap="round" stroke-linejoin="round"/>`;++const arrow = (x1, y, x2, color, w = 3) =>+ line(x1, y, x2 - 4, y, color, w) ++ `<path d="M${x2 - 14} ${y - 9} L${x2} ${y} L${x2 - 14} ${y + 9}" fill="none" stroke="${color}" stroke-width="${w}" stroke-linecap="round" stroke-linejoin="round"/>`;+++// Pier logo: the inner markup of assets/logo-mark.svg, untouched.+const logoInner = fs+ .readFileSync(path.join(root, 'assets/logo-mark.svg'), 'utf8')+ .replace(/^[\s\S]*?<svg[^>]*>/, '')+ .replace(/<\/svg>\s*$/, '')+ .trim();+const logo = (T, x, y, size) =>+ `<g id="pier-logo" transform="translate(${x} ${y}) scale(${size / 96})">${logoInner}</g>` ++ (T.logoRing !== 'none'+ ? `<rect x="${x}" y="${y}" width="${size}" height="${size}" rx="${(20 * size) / 96}" fill="none" stroke="${T.logoRing}" stroke-width="1.5"/>`+ : '');++const svgDoc = (w, h, T, title, desc, body) =>+ `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${w} ${h}" width="${w}" height="${h}" role="img" aria-labelledby="t d" ` ++ `font-family="${FONT}">\n` ++ `<title id="t">${esc(title)}</title><desc id="d">${esc(desc)}</desc>\n` ++ `<rect id="background" width="${w}" height="${h}" fill="${T.bg}"/>\n${body}\n</svg>\n`;++// ---------------------------------------------------------------- BIM model illustration+// Isometric block model: three storeys, a roof plant volume, a ground plate with+// grid lines. door: 'issue' (amber, missing parameter) | 'fixed' (teal) | 'none'.+function model(T, { s, ox, oy, door = 'issue', grid = true }) {+ const C = Math.cos(Math.PI / 6);+ const X = 7, Y = 4, fh = 1.1, H = 3 * fh;+ const P = (x, y, z) => [ox + (x - y) * C * s, oy + (x + y) * 0.5 * s - z * s];+ const pts = (a) => a.map((p) => `${f1(p[0])},${f1(p[1])}`).join(' ');+ const sw = Math.max(1.5, s / 16);+ const thin = Math.max(1, s / 30);+ const poly = (a, fill, stroke = T.stroke, w = sw) =>+ `<polygon points="${pts(a)}" fill="${fill}" stroke="${stroke}" stroke-width="${w}" stroke-linejoin="round"/>`;+ const L = (u0, u1, v0, v1) => [P(u0, Y, v0), P(u1, Y, v0), P(u1, Y, v1), P(u0, Y, v1)];+ const Rr = (u0, u1, v0, v1) => [P(X, u0, v0), P(X, u1, v0), P(X, u1, v1), P(X, u0, v1)];+ const warn = T.warn;+ let o = `<g id="model-illustration">`;++ // ground plate + grid+ o += poly([P(-1, -1, 0), P(X + 1, -1, 0), P(X + 1, Y + 1, 0), P(-1, Y + 1, 0)], T.ground, T.line, thin);+ if (grid) {+ const labels = ['A', 'B', 'C'];+ [0, 3.5, 7].forEach((x, i) => {+ const a = P(x, -1, 0), b = P(x, Y + 1.7, 0), c = P(x, Y + 2.15, 0);+ o += line(f1(a[0]), f1(a[1]), f1(b[0]), f1(b[1]), T.line, thin * 1.4, 'stroke-dasharray="7 6"');+ o += `<circle cx="${f1(c[0])}" cy="${f1(c[1])}" r="${s * 0.42}" fill="${T.bg}" stroke="${T.muted}" stroke-width="${thin}"/>`;+ o += text(f1(c[0]), f1(c[1] + s * 0.17), labels[i], { size: Math.round(s * 0.5), weight: 600, fill: T.muted, anchor: 'middle' });+ });+ }++ // main block+ o += poly([P(0, 0, H), P(X, 0, H), P(X, Y, H), P(0, Y, H)], T.top);+ o += poly(L(0, X, 0, H), T.left);+ o += poly(Rr(0, Y, 0, H), T.right);++ // slab lines+ for (let k = 1; k < 3; k++) {+ const a = P(0, Y, k * fh), b = P(X, Y, k * fh), c = P(X, 0, k * fh);+ o += `<polyline points="${pts([a, b, c])}" fill="none" stroke="${T.stroke}" stroke-width="${sw}" stroke-linejoin="round"/>`;+ }++ // windows+ const win = (a) => poly(a, T.glass, T.stroke, thin);+ for (let k = 0; k < 3; k++) {+ for (let i = 0; i < 7; i++) {+ const u = 0.5 + i * 0.9;+ if (k === 0 && Math.abs(u - 3.2) < 0.01) continue; // entrance door+ o += win(L(u, u + 0.6, k * fh + 0.3, k * fh + 0.9));+ }+ [0.4, 1.4, 2.4, 3.3].forEach((u) => {+ if (k === 0 && u < 3.2) return; // doors on the ground floor of this face+ o += win(Rr(u, u + 0.6, k * fh + 0.3, k * fh + 0.9));+ });+ }++ // doors+ const doorFill = T.surface;+ o += poly(L(3.2, 3.8, 0, 0.92), doorFill, T.stroke, thin * 1.3); // entrance+ const doorAt = (u, kind) => {+ const q = Rr(u, u + 0.55, 0, 0.92);+ if (kind === 'issue') return poly(q, T.warnBg, warn, sw * 1.35);+ if (kind === 'fixed') return poly(q, 'rgba(28,181,202,0.35)', T.brand, sw * 1.35);+ if (kind === 'also') return `<polygon points="${pts(q)}" fill="${T.warnBg}" stroke="${warn}" stroke-width="${thin * 1.4}" stroke-dasharray="5 4" stroke-linejoin="round"/>`;+ return poly(q, doorFill, T.stroke, thin * 1.3);+ };+ const flagged = door === 'none' ? 'plain' : door;+ o += doorAt(0.5, flagged);+ o += doorAt(1.6, door === 'issue' ? 'also' : 'plain');+ o += doorAt(2.7, 'plain');++ // roof plant volume+ const x0 = 1.2, x1 = 4.4, y0 = 1, y1 = 3, z0 = H, z1 = H + 0.9;+ o += poly([P(x0, y0, z1), P(x1, y0, z1), P(x1, y1, z1), P(x0, y1, z1)], T.top);+ o += poly([P(x0, y1, z0), P(x1, y1, z0), P(x1, y1, z1), P(x0, y1, z1)], T.left);+ o += poly([P(x1, y0, z0), P(x1, y1, z0), P(x1, y1, z1), P(x1, y0, z1)], T.right);+ o += poly([P(x0 + 0.3, y1, z0 + 0.3), P(x1 - 0.3, y1, z0 + 0.3), P(x1 - 0.3, y1, z1 - 0.25), P(x0 + 0.3, y1, z1 - 0.25)], T.glass, T.stroke, thin);++ o += `</g>`;+ return { svg: o, door: P(X, 0.5 + 0.275, 0.46) };+}++// ---------------------------------------------------------------- cards+function card(T, x, y, w, h, { fill, stroke } = {}) {+ return rect(x, y, w, h, 14, { fill: fill ?? T.surface, stroke: stroke ?? T.line, sw: 2 });+}+// ================================================================= HERO+function hero(name) {+ const T = THEMES[name];+ const W = 1600, H = 700;+ let b = '';+ b += logo(T, 88, 92, 96);+ b += text(88, 330, 'Find parameter issues.', { size: 68, weight: 700, fill: T.ink, ls: -1, id: 'headline-1' });+ b += text(88, 412, 'Review the fixes.', { size: 68, weight: 700, fill: T.brandText, ls: -1, id: 'headline-2' });+ b += rect(90, 442, 96, 6, 3, { fill: T.brand });+ b += text(88, 514, 'AI-assisted BIM coordination', { size: 34, weight: 500, fill: T.muted, id: 'support-1' });+ b += text(88, 560, 'with human approval.', { size: 34, weight: 500, fill: T.muted, id: 'support-2' });+ b += text(88, 640, 'Illustration with example values.', { size: 22, weight: 500, fill: T.muted, id: 'footnote' });++ const m = model(T, { s: 38, ox: 1090, oy: 250, door: 'issue', grid: false });+ b += m.svg;+ const [dx, dy] = m.door;+ b += `<circle cx="${f1(dx)}" cy="${f1(dy)}" r="20" fill="none" stroke="${T.warn}" stroke-width="3"/>`;+ // one callout: issue -> reviewed fix+ const cx = 1010, cy = 530, cw = 500, ch = 124;+ b += `<polyline points="${f1(dx)},${f1(dy + 20)} ${f1(dx)},${cy}" fill="none" stroke="${T.warn}" stroke-width="3"/>`;+ b += rect(cx, cy, cw, ch, 16, { fill: T.surface, stroke: T.line, sw: 2 });+ b += text(cx + 32, cy + 50, 'Door \u00B7 Mark', { size: 26, weight: 600, fill: T.muted });+ b += text(cx + 32, cy + 96, 'empty', { size: 38, weight: 700, fill: T.warn });+ b += arrow(cx + 170, cy + 82, cx + 232, T.muted, 3);+ b += text(cx + 252, cy + 96, 'D-101', { size: 38, weight: 700, fill: T.brandText });+ b += check(cx + cw - 52, cy + 62, 22, T.ok, T.surface);+ return svgDoc(W, H, T, 'Find parameter issues. Review the fixes.',+ 'A BIM model with a door flagged for an empty Mark parameter and a callout showing the reviewed correction. Example values.', b);+}++// ================================================================= WORKFLOW+function workflow(name) {+ const T = THEMES[name];+ const W = 1600, H = 500;+ let b = '';+ const cw = 312, gap = 64, x0 = 80, cy = 130, ch = 220;+ const steps = ['Inspect', 'Propose', 'Approve', 'Verify'];+ steps.forEach((s, i) => {+ const x = x0 + i * (cw + gap);+ b += text(x, 88, s, { size: 44, weight: 700, fill: i === 2 ? T.brandText : T.ink });+ b += card(T, x, cy, cw, ch, i === 2 ? { stroke: T.brand } : {});+ if (i < 3) b += arrow(x + cw + 12, cy + ch / 2, x + cw + gap - 12, T.muted, 3);+ });+ b += text(80, 432, 'Missing values become proposed changes. A person approves. Results are checked.', { size: 28, weight: 500, fill: T.muted });+ b += text(80, 472, 'Example values are illustrative.', { size: 22, weight: 500, fill: T.muted, id: 'footnote' });+ const row = (x, y, a, bv, ca, cb) => text(x + 28, y, a, { size: 28, weight: 600, fill: ca }) + text(x + cw - 28, y, bv, { size: 28, weight: 700, fill: cb, anchor: 'end' });+ let x = x0;+ b += row(x, cy + 80, 'Door 0416', 'D-102', T.ink, T.muted);+ b += rect(x + 16, cy + 118, cw - 32, 56, 8, { fill: T.warnBg, stroke: T.warn, sw: 2, dash: '6 5' });+ b += row(x, cy + 155, 'Door 0417', 'empty', T.ink, T.warn);+ x += cw + gap;+ b += text(x + 28, cy + 70, 'Door 0417', { size: 28, weight: 600, fill: T.muted });+ b += text(x + 28, cy + 140, 'empty', { size: 32, weight: 600, fill: T.warn });+ b += arrow(x + 138, cy + 128, x + 176, T.muted, 3);+ b += text(x + 192, cy + 140, 'D-103', { size: 32, weight: 700, fill: T.brandText });+ b += text(x + 28, cy + 190, 'Draft, not applied', { size: 24, weight: 500, fill: T.muted });+ x += cw + gap;+ b += rect(x + 28, cy + 56, cw - 56, 72, 12, { fill: T.brand });+ b += text(x + cw / 2, cy + 104, 'Approve', { size: 34, weight: 700, fill: T.btnText, anchor: 'middle' });+ b += text(x + cw / 2, cy + 176, 'You decide', { size: 28, weight: 500, fill: T.muted, anchor: 'middle' });+ x += cw + gap;+ b += check(x + 52, cy + 90, 26, T.ok, T.surface);+ b += text(x + 96, cy + 102, 'D-103', { size: 38, weight: 700, fill: T.ink });+ b += text(x + 28, cy + 176, 'Read back', { size: 26, weight: 500, fill: T.muted });+ return svgDoc(W, H, T, 'Inspect, Propose, Approve, Verify',+ 'Four steps: inspect finds an empty Mark, propose drafts a change, approve is a human decision, verify reads the value back. Example values are illustrative.', b);+}++// ================================================================= SOCIAL+function social() {+ const T = THEMES.light;+ const W = 1280, H = 640;+ let b = '';+ b += logo(T, 88, 96, 128);+ b += text(88, 316, 'AEC Model Bridge', { size: 70, weight: 700, fill: T.ink, ls: -1, id: 'project-name' });+ b += rect(90, 346, 96, 6, 3, { fill: T.brand });+ b += text(88, 416, 'AI-assisted BIM coordination.', { size: 36, weight: 500, fill: T.muted, id: 'tagline' });+ b += text(88, 560, 'MCP server + native Revit add-in', { size: 26, weight: 500, fill: T.brandText });+ b += model(T, { s: 40, ox: 905, oy: 335, door: 'fixed' }).svg;+ return svgDoc(W, H, T, 'AEC Model Bridge', 'AEC Model Bridge with the Pier logo, an architectural model illustration and the line AI-assisted BIM coordination.', b);+}++// ================================================================= DEMO COVER+function cover() {+ const T = THEMES.light;+ const W = 1600, H = 900;+ let b = '';+ b += logo(T, 80, 80, 80);+ ['Fix missing', 'parameters', 'in Revit.'].forEach((l, i) =>+ (b += text(80, 380 + i * 92, l, { size: 80, weight: 700, fill: i === 2 ? T.brandText : T.ink, ls: -1.5, id: `title-${i + 1}` })));+ b += rect(82, 626, 96, 6, 3, { fill: T.brand });+ b += text(80, 700, 'Inspect. Review. Approve. Verify.', { size: 30, weight: 500, fill: T.muted, id: 'subtitle' });+ const px = 640, py = 110, pw = 880, ph = 550;+ b += rect(px, py, pw, ph, 12, { fill: T.surface, stroke: T.muted, sw: 3, dash: '14 10' });+ b += text(px + pw / 2, py + ph / 2 + 4, 'Screenshot placeholder', { size: 46, weight: 650, fill: T.ink, anchor: 'middle', id: 'placeholder-label' });+ b += text(px + pw / 2, py + ph / 2 + 50, 'Synthetic test model, live Revit', { size: 26, weight: 500, fill: T.muted, anchor: 'middle' });+ return svgDoc(W, H, T, 'Fix missing parameters in Revit.', 'Demo cover with title, subtitle and a large labelled screenshot placeholder.', b);+}++// ---------------------------------------------------------------- output+const outputs = [+ ['readme-hero-light', hero('light'), 1600, 700],+ ['readme-hero-dark', hero('dark'), 1600, 700],+ ['readme-workflow-light', workflow('light'), 1600, 500],+ ['readme-workflow-dark', workflow('dark'), 1600, 500],+ ['social-preview', social(), 1280, 640],+ ['demo-cover', cover(), 1600, 900],+];+for (const [n, svg] of outputs) fs.writeFileSync(path.join(srcDir, `${n}.svg`), svg);+// demo-cover is a placeholder (no real capture yet), so its PNG is not rendered unless asked.+const pngOutputs = outputs.filter(([n]) => n !== 'demo-cover' || process.env.WITH_PLACEHOLDER === '1');++const browser = await chromium.launch();+const page = await browser.newPage({ deviceScaleFactor: 1 });+async function render(svg, w, h, file) {+ await page.setViewportSize({ width: w, height: h });+ await page.setContent(`<!doctype html><body style="margin:0">${svg}</body>`);+ await page.evaluate(() => document.fonts.ready);+ const hasInter = await page.evaluate(() => document.fonts.check('16px Inter'));+ if (!hasInter) throw new Error('The Inter font is not installed; the layout uses fixed offsets, so output would differ. Install Inter and rebuild.');+ await page.screenshot({ path: file, clip: { x: 0, y: 0, width: w, height: h } });+}+for (const [n, svg, w, h] of pngOutputs) await render(svg, w, h, path.join(pngDir, `${n}.png`));+await browser.close();+// Palette-reduce the flat graphics with ImageMagick 7 (`magick`). Never `convert`: on Windows+// that name is System32\convert.exe, a disk tool. If magick is missing the PNGs stay full colour.+let reduced = 0;+for (const [n] of pngOutputs) {+ const f = path.join(pngDir, `${n}.png`);+ try {+ execFileSync('magick', [f, '-colors', '128', '-dither', 'None', '-define', 'png:compression-level=9', '-strip', `PNG8:${f}`], { stdio: 'pipe' });+ reduced++;+ } catch (e) {+ if (e.code === 'ENOENT') { console.warn('ImageMagick (magick) not found: PNGs left full-colour and larger.'); break; }+ console.warn(`Palette reduction failed for ${n}: ${String(e.message).split('\n')[0]}`);+ }+}+console.log(`built ${pngOutputs.map((o) => o[0]).join(', ')} (${reduced}/${pngOutputs.length} palette-reduced)`);diff --git a/docs/design/readme-visuals/src/demo-cover.svg b/docs/design/readme-visuals/src/demo-cover.svgnew file mode 100644index 0000000..67f1eb1--- /dev/null+++ b/docs/design/readme-visuals/src/demo-cover.svg@@ -0,0 +1,12 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 900" width="1600" height="900" role="img" aria-labelledby="t d" font-family="Inter, 'Helvetica Neue', Arial, sans-serif">+<title id="t">Fix missing parameters in Revit.</title><desc id="d">Demo cover with title, subtitle and a large labelled screenshot placeholder.</desc>+<rect id="background" width="1600" height="900" fill="#F2F5F8"/>+<g id="pier-logo" transform="translate(80 80) scale(0.8333333333333334)"><rect width="96" height="96" rx="20" fill="#111923"/>+ <g stroke="#111923" stroke-width="2.5" stroke-linejoin="round">+ <polygon fill="#1CB5CA" points="48,16 76,32 48,48 20,32"/>+ <polygon fill="#FFFFFF" points="20,32 48,48 48,80 20,64"/>+ <polygon fill="#AEBCCB" points="48,48 76,32 76,64 48,80"/>+ </g>+ <path fill="#111923" transform="matrix(28,16,0,32,20,32)" d="M0.24,1.02 V0.66 A0.26,0.26 0 0 1 0.76,0.66 V1.02 Z"/>+ <path fill="#111923" transform="matrix(28,-16,0,32,48,48)" d="M0.24,1.02 V0.66 A0.26,0.26 0 0 1 0.76,0.66 V1.02 Z"/></g><text id="title-1" x="80" y="380" font-size="80" font-weight="700" fill="#18202C" letter-spacing="-1.5">Fix missing</text><text id="title-2" x="80" y="472" font-size="80" font-weight="700" fill="#18202C" letter-spacing="-1.5">parameters</text><text id="title-3" x="80" y="564" font-size="80" font-weight="700" fill="#046B80" letter-spacing="-1.5">in Revit.</text><rect x="82" y="626" width="96" height="6" rx="3" fill="#1CB5CA"/><text id="subtitle" x="80" y="700" font-size="30" font-weight="500" fill="#5B6676">Inspect. Review. Approve. Verify.</text><rect x="640" y="110" width="880" height="550" rx="12" fill="#FFFFFF" stroke="#5B6676" stroke-width="3" stroke-dasharray="14 10"/><text id="placeholder-label" x="1080" y="389" font-size="46" font-weight="650" fill="#18202C" text-anchor="middle">Screenshot placeholder</text><text x="1080" y="435" font-size="26" font-weight="500" fill="#5B6676" text-anchor="middle">Synthetic test model, live Revit</text>+</svg>diff --git a/docs/design/readme-visuals/src/readme-hero-dark.svg b/docs/design/readme-visuals/src/readme-hero-dark.svgnew file mode 100644index 0000000..341616d--- /dev/null+++ b/docs/design/readme-visuals/src/readme-hero-dark.svg@@ -0,0 +1,12 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 700" width="1600" height="700" role="img" aria-labelledby="t d" font-family="Inter, 'Helvetica Neue', Arial, sans-serif">+<title id="t">Find parameter issues. Review the fixes.</title><desc id="d">A BIM model with a door flagged for an empty Mark parameter and a callout showing the reviewed correction. Example values.</desc>+<rect id="background" width="1600" height="700" fill="#0D131B"/>+<g id="pier-logo" transform="translate(88 92) scale(1)"><rect width="96" height="96" rx="20" fill="#111923"/>+ <g stroke="#111923" stroke-width="2.5" stroke-linejoin="round">+ <polygon fill="#1CB5CA" points="48,16 76,32 48,48 20,32"/>+ <polygon fill="#FFFFFF" points="20,32 48,48 48,80 20,64"/>+ <polygon fill="#AEBCCB" points="48,48 76,32 76,64 48,80"/>+ </g>+ <path fill="#111923" transform="matrix(28,16,0,32,20,32)" d="M0.24,1.02 V0.66 A0.26,0.26 0 0 1 0.76,0.66 V1.02 Z"/>+ <path fill="#111923" transform="matrix(28,-16,0,32,48,48)" d="M0.24,1.02 V0.66 A0.26,0.26 0 0 1 0.76,0.66 V1.02 Z"/></g><rect x="88" y="92" width="96" height="96" rx="20" fill="none" stroke="#3A4756" stroke-width="1.5"/><text id="headline-1" x="88" y="330" font-size="68" font-weight="700" fill="#E9EEF5" letter-spacing="-1">Find parameter issues.</text><text id="headline-2" x="88" y="412" font-size="68" font-weight="700" fill="#6FD8E6" letter-spacing="-1">Review the fixes.</text><rect x="90" y="442" width="96" height="6" rx="3" fill="#1CB5CA"/><text id="support-1" x="88" y="514" font-size="34" font-weight="500" fill="#9BA8B9">AI-assisted BIM coordination</text><text id="support-2" x="88" y="560" font-size="34" font-weight="500" fill="#9BA8B9">with human approval.</text><text id="footnote" x="88" y="640" font-size="22" font-weight="500" fill="#9BA8B9">Illustration with example values.</text><g id="model-illustration"><polygon points="1090.0,212.0 1386.2,383.0 1188.7,497.0 892.5,326.0" fill="#111A24" stroke="#2F3945" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1090.0,124.6 1320.4,257.6 1188.7,333.6 958.4,200.6" fill="#2D3B4A" stroke="#C9D4E2" stroke-width="2.375" stroke-linejoin="round"/><polygon points="958.4,326.0 1188.7,459.0 1188.7,333.6 958.4,200.6" fill="#1E2935" stroke="#C9D4E2" stroke-width="2.375" stroke-linejoin="round"/><polygon points="1320.4,383.0 1188.7,459.0 1188.7,333.6 1320.4,257.6" fill="#141C26" stroke="#C9D4E2" stroke-width="2.375" stroke-linejoin="round"/><polyline points="958.4,284.2 1188.7,417.2 1320.4,341.2" fill="none" stroke="#C9D4E2" stroke-width="2.375" stroke-linejoin="round"/><polyline points="958.4,242.4 1188.7,375.4 1320.4,299.4" fill="none" stroke="#C9D4E2" stroke-width="2.375" stroke-linejoin="round"/><polygon points="974.8,324.1 994.6,335.5 994.6,312.7 974.8,301.3" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1004.4,341.2 1024.2,352.6 1024.2,329.8 1004.4,318.4" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1034.1,358.3 1053.8,369.7 1053.8,346.9 1034.1,335.5" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1093.3,392.5 1113.0,403.9 1113.0,381.1 1093.3,369.7" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1122.9,409.6 1142.7,421.0 1142.7,398.2 1122.9,386.8" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1152.5,426.7 1172.3,438.1 1172.3,415.3 1152.5,403.9" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1211.8,434.3 1192.0,445.7 1192.0,422.9 1211.8,411.5" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="974.8,282.3 994.6,293.7 994.6,270.9 974.8,259.5" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1004.4,299.4 1024.2,310.8 1024.2,288.0 1004.4,276.6" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1034.1,316.5 1053.8,327.9 1053.8,305.1 1034.1,293.7" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1063.7,333.6 1083.4,345.0 1083.4,322.2 1063.7,310.8" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1093.3,350.7 1113.0,362.1 1113.0,339.3 1093.3,327.9" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1122.9,367.8 1142.7,379.2 1142.7,356.4 1122.9,345.0" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1152.5,384.9 1172.3,396.3 1172.3,373.5 1152.5,362.1" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1307.2,337.4 1287.5,348.8 1287.5,326.0 1307.2,314.6" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1274.3,356.4 1254.5,367.8 1254.5,345.0 1274.3,333.6" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1241.4,375.4 1221.6,386.8 1221.6,364.0 1241.4,352.6" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1211.8,392.5 1192.0,403.9 1192.0,381.1 1211.8,369.7" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="974.8,240.5 994.6,251.9 994.6,229.1 974.8,217.7" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1004.4,257.6 1024.2,269.0 1024.2,246.2 1004.4,234.8" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1034.1,274.7 1053.8,286.1 1053.8,263.3 1034.1,251.9" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1063.7,291.8 1083.4,303.2 1083.4,280.4 1063.7,269.0" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1093.3,308.9 1113.0,320.3 1113.0,297.5 1093.3,286.1" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1122.9,326.0 1142.7,337.4 1142.7,314.6 1122.9,303.2" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1152.5,343.1 1172.3,354.5 1172.3,331.7 1152.5,320.3" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1307.2,295.6 1287.5,307.0 1287.5,284.2 1307.2,272.8" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1274.3,314.6 1254.5,326.0 1254.5,303.2 1274.3,291.8" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1241.4,333.6 1221.6,345.0 1221.6,322.2 1241.4,310.8" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1211.8,350.7 1192.0,362.1 1192.0,339.3 1211.8,327.9" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1063.7,386.8 1083.4,398.2 1083.4,363.2 1063.7,351.8" fill="#151D28" stroke="#C9D4E2" stroke-width="1.6466666666666667" stroke-linejoin="round"/><polygon points="1303.9,392.5 1285.8,403.0 1285.8,368.0 1303.9,357.5" fill="rgba(242,166,60,0.16)" stroke="#F2A63C" stroke-width="3.2062500000000003" stroke-linejoin="round"/><polygon points="1267.7,413.4 1249.6,423.9 1249.6,388.9 1267.7,378.4" fill="rgba(242,166,60,0.16)" stroke="#F2A63C" stroke-width="1.7733333333333332" stroke-dasharray="5 4" stroke-linejoin="round"/><polygon points="1231.5,434.3 1213.4,444.8 1213.4,409.8 1231.5,399.3" fill="#151D28" stroke="#C9D4E2" stroke-width="1.6466666666666667" stroke-linejoin="round"/><polygon points="1096.6,132.2 1201.9,193.0 1136.1,231.0 1030.8,170.2" fill="#2D3B4A" stroke="#C9D4E2" stroke-width="2.375" stroke-linejoin="round"/><polygon points="1030.8,204.4 1136.1,265.2 1136.1,231.0 1030.8,170.2" fill="#1E2935" stroke="#C9D4E2" stroke-width="2.375" stroke-linejoin="round"/><polygon points="1201.9,227.2 1136.1,265.2 1136.1,231.0 1201.9,193.0" fill="#141C26" stroke="#C9D4E2" stroke-width="2.375" stroke-linejoin="round"/><polygon points="1040.6,198.7 1126.2,248.1 1126.2,234.8 1040.6,185.4" fill="rgba(28,181,202,0.30)" stroke="#C9D4E2" stroke-width="1.2666666666666666" stroke-linejoin="round"/></g><circle cx="1294.9" cy="380.2" r="20" fill="none" stroke="#F2A63C" stroke-width="3"/><polyline points="1294.9,400.2 1294.9,530" fill="none" stroke="#F2A63C" stroke-width="3"/><rect x="1010" y="530" width="500" height="124" rx="16" fill="#151D28" stroke="#2F3945" stroke-width="2"/><text x="1042" y="580" font-size="26" font-weight="600" fill="#9BA8B9">Door · Mark</text><text x="1042" y="626" font-size="38" font-weight="700" fill="#F2A63C">empty</text><line x1="1180" y1="612" x2="1238" y2="612" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" /><path d="M1228 603 L1242 612 L1228 621" fill="none" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="1262" y="626" font-size="38" font-weight="700" fill="#6FD8E6">D-101</text><circle cx="1458" cy="592" r="22" fill="#3FCB8B"/><path d="M1448.76 592.44 L1455.8 599.48 L1468.12 584.52" fill="none" stroke="#151D28" stroke-width="4.4" stroke-linecap="round" stroke-linejoin="round"/>+</svg>diff --git a/docs/design/readme-visuals/src/readme-hero-light.svg b/docs/design/readme-visuals/src/readme-hero-light.svgnew file mode 100644index 0000000..a9cd425--- /dev/null+++ b/docs/design/readme-visuals/src/readme-hero-light.svg@@ -0,0 +1,12 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 700" width="1600" height="700" role="img" aria-labelledby="t d" font-family="Inter, 'Helvetica Neue', Arial, sans-serif">+<title id="t">Find parameter issues. Review the fixes.</title><desc id="d">A BIM model with a door flagged for an empty Mark parameter and a callout showing the reviewed correction. Example values.</desc>+<rect id="background" width="1600" height="700" fill="#F2F5F8"/>+<g id="pier-logo" transform="translate(88 92) scale(1)"><rect width="96" height="96" rx="20" fill="#111923"/>+ <g stroke="#111923" stroke-width="2.5" stroke-linejoin="round">+ <polygon fill="#1CB5CA" points="48,16 76,32 48,48 20,32"/>+ <polygon fill="#FFFFFF" points="20,32 48,48 48,80 20,64"/>+ <polygon fill="#AEBCCB" points="48,48 76,32 76,64 48,80"/>+ </g>+ <path fill="#111923" transform="matrix(28,16,0,32,20,32)" d="M0.24,1.02 V0.66 A0.26,0.26 0 0 1 0.76,0.66 V1.02 Z"/>+ <path fill="#111923" transform="matrix(28,-16,0,32,48,48)" d="M0.24,1.02 V0.66 A0.26,0.26 0 0 1 0.76,0.66 V1.02 Z"/></g><text id="headline-1" x="88" y="330" font-size="68" font-weight="700" fill="#18202C" letter-spacing="-1">Find parameter issues.</text><text id="headline-2" x="88" y="412" font-size="68" font-weight="700" fill="#046B80" letter-spacing="-1">Review the fixes.</text><rect x="90" y="442" width="96" height="6" rx="3" fill="#1CB5CA"/><text id="support-1" x="88" y="514" font-size="34" font-weight="500" fill="#5B6676">AI-assisted BIM coordination</text><text id="support-2" x="88" y="560" font-size="34" font-weight="500" fill="#5B6676">with human approval.</text><text id="footnote" x="88" y="640" font-size="22" font-weight="500" fill="#5B6676">Illustration with example values.</text><g id="model-illustration"><polygon points="1090.0,212.0 1386.2,383.0 1188.7,497.0 892.5,326.0" fill="#E4EAF0" stroke="#D3DAE3" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1090.0,124.6 1320.4,257.6 1188.7,333.6 958.4,200.6" fill="#FFFFFF" stroke="#18202C" stroke-width="2.375" stroke-linejoin="round"/><polygon points="958.4,326.0 1188.7,459.0 1188.7,333.6 958.4,200.6" fill="#EAF0F5" stroke="#18202C" stroke-width="2.375" stroke-linejoin="round"/><polygon points="1320.4,383.0 1188.7,459.0 1188.7,333.6 1320.4,257.6" fill="#D6DFE9" stroke="#18202C" stroke-width="2.375" stroke-linejoin="round"/><polyline points="958.4,284.2 1188.7,417.2 1320.4,341.2" fill="none" stroke="#18202C" stroke-width="2.375" stroke-linejoin="round"/><polyline points="958.4,242.4 1188.7,375.4 1320.4,299.4" fill="none" stroke="#18202C" stroke-width="2.375" stroke-linejoin="round"/><polygon points="974.8,324.1 994.6,335.5 994.6,312.7 974.8,301.3" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1004.4,341.2 1024.2,352.6 1024.2,329.8 1004.4,318.4" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1034.1,358.3 1053.8,369.7 1053.8,346.9 1034.1,335.5" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1093.3,392.5 1113.0,403.9 1113.0,381.1 1093.3,369.7" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1122.9,409.6 1142.7,421.0 1142.7,398.2 1122.9,386.8" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1152.5,426.7 1172.3,438.1 1172.3,415.3 1152.5,403.9" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1211.8,434.3 1192.0,445.7 1192.0,422.9 1211.8,411.5" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="974.8,282.3 994.6,293.7 994.6,270.9 974.8,259.5" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1004.4,299.4 1024.2,310.8 1024.2,288.0 1004.4,276.6" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1034.1,316.5 1053.8,327.9 1053.8,305.1 1034.1,293.7" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1063.7,333.6 1083.4,345.0 1083.4,322.2 1063.7,310.8" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1093.3,350.7 1113.0,362.1 1113.0,339.3 1093.3,327.9" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1122.9,367.8 1142.7,379.2 1142.7,356.4 1122.9,345.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1152.5,384.9 1172.3,396.3 1172.3,373.5 1152.5,362.1" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1307.2,337.4 1287.5,348.8 1287.5,326.0 1307.2,314.6" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1274.3,356.4 1254.5,367.8 1254.5,345.0 1274.3,333.6" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1241.4,375.4 1221.6,386.8 1221.6,364.0 1241.4,352.6" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1211.8,392.5 1192.0,403.9 1192.0,381.1 1211.8,369.7" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="974.8,240.5 994.6,251.9 994.6,229.1 974.8,217.7" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1004.4,257.6 1024.2,269.0 1024.2,246.2 1004.4,234.8" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1034.1,274.7 1053.8,286.1 1053.8,263.3 1034.1,251.9" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1063.7,291.8 1083.4,303.2 1083.4,280.4 1063.7,269.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1093.3,308.9 1113.0,320.3 1113.0,297.5 1093.3,286.1" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1122.9,326.0 1142.7,337.4 1142.7,314.6 1122.9,303.2" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1152.5,343.1 1172.3,354.5 1172.3,331.7 1152.5,320.3" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1307.2,295.6 1287.5,307.0 1287.5,284.2 1307.2,272.8" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1274.3,314.6 1254.5,326.0 1254.5,303.2 1274.3,291.8" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1241.4,333.6 1221.6,345.0 1221.6,322.2 1241.4,310.8" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1211.8,350.7 1192.0,362.1 1192.0,339.3 1211.8,327.9" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/><polygon points="1063.7,386.8 1083.4,398.2 1083.4,363.2 1063.7,351.8" fill="#FFFFFF" stroke="#18202C" stroke-width="1.6466666666666667" stroke-linejoin="round"/><polygon points="1303.9,392.5 1285.8,403.0 1285.8,368.0 1303.9,357.5" fill="rgba(164,95,11,0.12)" stroke="#A45F0B" stroke-width="3.2062500000000003" stroke-linejoin="round"/><polygon points="1267.7,413.4 1249.6,423.9 1249.6,388.9 1267.7,378.4" fill="rgba(164,95,11,0.12)" stroke="#A45F0B" stroke-width="1.7733333333333332" stroke-dasharray="5 4" stroke-linejoin="round"/><polygon points="1231.5,434.3 1213.4,444.8 1213.4,409.8 1231.5,399.3" fill="#FFFFFF" stroke="#18202C" stroke-width="1.6466666666666667" stroke-linejoin="round"/><polygon points="1096.6,132.2 1201.9,193.0 1136.1,231.0 1030.8,170.2" fill="#FFFFFF" stroke="#18202C" stroke-width="2.375" stroke-linejoin="round"/><polygon points="1030.8,204.4 1136.1,265.2 1136.1,231.0 1030.8,170.2" fill="#EAF0F5" stroke="#18202C" stroke-width="2.375" stroke-linejoin="round"/><polygon points="1201.9,227.2 1136.1,265.2 1136.1,231.0 1201.9,193.0" fill="#D6DFE9" stroke="#18202C" stroke-width="2.375" stroke-linejoin="round"/><polygon points="1040.6,198.7 1126.2,248.1 1126.2,234.8 1040.6,185.4" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.2666666666666666" stroke-linejoin="round"/></g><circle cx="1294.9" cy="380.2" r="20" fill="none" stroke="#A45F0B" stroke-width="3"/><polyline points="1294.9,400.2 1294.9,530" fill="none" stroke="#A45F0B" stroke-width="3"/><rect x="1010" y="530" width="500" height="124" rx="16" fill="#FFFFFF" stroke="#D3DAE3" stroke-width="2"/><text x="1042" y="580" font-size="26" font-weight="600" fill="#5B6676">Door · Mark</text><text x="1042" y="626" font-size="38" font-weight="700" fill="#A45F0B">empty</text><line x1="1180" y1="612" x2="1238" y2="612" stroke="#5B6676" stroke-width="3" stroke-linecap="round" /><path d="M1228 603 L1242 612 L1228 621" fill="none" stroke="#5B6676" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="1262" y="626" font-size="38" font-weight="700" fill="#046B80">D-101</text><circle cx="1458" cy="592" r="22" fill="#127A4B"/><path d="M1448.76 592.44 L1455.8 599.48 L1468.12 584.52" fill="none" stroke="#FFFFFF" stroke-width="4.4" stroke-linecap="round" stroke-linejoin="round"/>+</svg>diff --git a/docs/design/readme-visuals/src/readme-workflow-dark.svg b/docs/design/readme-visuals/src/readme-workflow-dark.svgnew file mode 100644index 0000000..7bb1a8f--- /dev/null+++ b/docs/design/readme-visuals/src/readme-workflow-dark.svg@@ -0,0 +1,5 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 500" width="1600" height="500" role="img" aria-labelledby="t d" font-family="Inter, 'Helvetica Neue', Arial, sans-serif">+<title id="t">Inspect, Propose, Approve, Verify</title><desc id="d">Four steps: inspect finds an empty Mark, propose drafts a change, approve is a human decision, verify reads the value back. Example values are illustrative.</desc>+<rect id="background" width="1600" height="500" fill="#0D131B"/>+<text x="80" y="88" font-size="44" font-weight="700" fill="#E9EEF5">Inspect</text><rect x="80" y="130" width="312" height="220" rx="14" fill="#151D28" stroke="#2F3945" stroke-width="2"/><line x1="404" y1="240" x2="440" y2="240" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" /><path d="M430 231 L444 240 L430 249" fill="none" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="456" y="88" font-size="44" font-weight="700" fill="#E9EEF5">Propose</text><rect x="456" y="130" width="312" height="220" rx="14" fill="#151D28" stroke="#2F3945" stroke-width="2"/><line x1="780" y1="240" x2="816" y2="240" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" /><path d="M806 231 L820 240 L806 249" fill="none" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="832" y="88" font-size="44" font-weight="700" fill="#6FD8E6">Approve</text><rect x="832" y="130" width="312" height="220" rx="14" fill="#151D28" stroke="#1CB5CA" stroke-width="2"/><line x1="1156" y1="240" x2="1192" y2="240" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" /><path d="M1182 231 L1196 240 L1182 249" fill="none" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="1208" y="88" font-size="44" font-weight="700" fill="#E9EEF5">Verify</text><rect x="1208" y="130" width="312" height="220" rx="14" fill="#151D28" stroke="#2F3945" stroke-width="2"/><text x="80" y="432" font-size="28" font-weight="500" fill="#9BA8B9">Missing values become proposed changes. A person approves. Results are checked.</text><text id="footnote" x="80" y="472" font-size="22" font-weight="500" fill="#9BA8B9">Example values are illustrative.</text><text x="108" y="210" font-size="28" font-weight="600" fill="#E9EEF5">Door 0416</text><text x="364" y="210" font-size="28" font-weight="700" fill="#9BA8B9" text-anchor="end">D-102</text><rect x="96" y="248" width="280" height="56" rx="8" fill="rgba(242,166,60,0.16)" stroke="#F2A63C" stroke-width="2" stroke-dasharray="6 5"/><text x="108" y="285" font-size="28" font-weight="600" fill="#E9EEF5">Door 0417</text><text x="364" y="285" font-size="28" font-weight="700" fill="#F2A63C" text-anchor="end">empty</text><text x="484" y="200" font-size="28" font-weight="600" fill="#9BA8B9">Door 0417</text><text x="484" y="270" font-size="32" font-weight="600" fill="#F2A63C">empty</text><line x1="594" y1="258" x2="628" y2="258" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" /><path d="M618 249 L632 258 L618 267" fill="none" stroke="#9BA8B9" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="648" y="270" font-size="32" font-weight="700" fill="#6FD8E6">D-103</text><text x="484" y="320" font-size="24" font-weight="500" fill="#9BA8B9">Draft, not applied</text><rect x="860" y="186" width="256" height="72" rx="12" fill="#1CB5CA"/><text x="988" y="234" font-size="34" font-weight="700" fill="#0B1118" text-anchor="middle">Approve</text><text x="988" y="306" font-size="28" font-weight="500" fill="#9BA8B9" text-anchor="middle">You decide</text><circle cx="1260" cy="220" r="26" fill="#3FCB8B"/><path d="M1249.08 220.52 L1257.4 228.84 L1271.96 211.16" fill="none" stroke="#151D28" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round"/><text x="1304" y="232" font-size="38" font-weight="700" fill="#E9EEF5">D-103</text><text x="1236" y="306" font-size="26" font-weight="500" fill="#9BA8B9">Read back</text>+</svg>diff --git a/docs/design/readme-visuals/src/readme-workflow-light.svg b/docs/design/readme-visuals/src/readme-workflow-light.svgnew file mode 100644index 0000000..94b8d47--- /dev/null+++ b/docs/design/readme-visuals/src/readme-workflow-light.svg@@ -0,0 +1,5 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 500" width="1600" height="500" role="img" aria-labelledby="t d" font-family="Inter, 'Helvetica Neue', Arial, sans-serif">+<title id="t">Inspect, Propose, Approve, Verify</title><desc id="d">Four steps: inspect finds an empty Mark, propose drafts a change, approve is a human decision, verify reads the value back. Example values are illustrative.</desc>+<rect id="background" width="1600" height="500" fill="#F2F5F8"/>+<text x="80" y="88" font-size="44" font-weight="700" fill="#18202C">Inspect</text><rect x="80" y="130" width="312" height="220" rx="14" fill="#FFFFFF" stroke="#D3DAE3" stroke-width="2"/><line x1="404" y1="240" x2="440" y2="240" stroke="#5B6676" stroke-width="3" stroke-linecap="round" /><path d="M430 231 L444 240 L430 249" fill="none" stroke="#5B6676" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="456" y="88" font-size="44" font-weight="700" fill="#18202C">Propose</text><rect x="456" y="130" width="312" height="220" rx="14" fill="#FFFFFF" stroke="#D3DAE3" stroke-width="2"/><line x1="780" y1="240" x2="816" y2="240" stroke="#5B6676" stroke-width="3" stroke-linecap="round" /><path d="M806 231 L820 240 L806 249" fill="none" stroke="#5B6676" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="832" y="88" font-size="44" font-weight="700" fill="#046B80">Approve</text><rect x="832" y="130" width="312" height="220" rx="14" fill="#FFFFFF" stroke="#1CB5CA" stroke-width="2"/><line x1="1156" y1="240" x2="1192" y2="240" stroke="#5B6676" stroke-width="3" stroke-linecap="round" /><path d="M1182 231 L1196 240 L1182 249" fill="none" stroke="#5B6676" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="1208" y="88" font-size="44" font-weight="700" fill="#18202C">Verify</text><rect x="1208" y="130" width="312" height="220" rx="14" fill="#FFFFFF" stroke="#D3DAE3" stroke-width="2"/><text x="80" y="432" font-size="28" font-weight="500" fill="#5B6676">Missing values become proposed changes. A person approves. Results are checked.</text><text id="footnote" x="80" y="472" font-size="22" font-weight="500" fill="#5B6676">Example values are illustrative.</text><text x="108" y="210" font-size="28" font-weight="600" fill="#18202C">Door 0416</text><text x="364" y="210" font-size="28" font-weight="700" fill="#5B6676" text-anchor="end">D-102</text><rect x="96" y="248" width="280" height="56" rx="8" fill="rgba(164,95,11,0.12)" stroke="#A45F0B" stroke-width="2" stroke-dasharray="6 5"/><text x="108" y="285" font-size="28" font-weight="600" fill="#18202C">Door 0417</text><text x="364" y="285" font-size="28" font-weight="700" fill="#A45F0B" text-anchor="end">empty</text><text x="484" y="200" font-size="28" font-weight="600" fill="#5B6676">Door 0417</text><text x="484" y="270" font-size="32" font-weight="600" fill="#A45F0B">empty</text><line x1="594" y1="258" x2="628" y2="258" stroke="#5B6676" stroke-width="3" stroke-linecap="round" /><path d="M618 249 L632 258 L618 267" fill="none" stroke="#5B6676" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><text x="648" y="270" font-size="32" font-weight="700" fill="#046B80">D-103</text><text x="484" y="320" font-size="24" font-weight="500" fill="#5B6676">Draft, not applied</text><rect x="860" y="186" width="256" height="72" rx="12" fill="#1CB5CA"/><text x="988" y="234" font-size="34" font-weight="700" fill="#0B1118" text-anchor="middle">Approve</text><text x="988" y="306" font-size="28" font-weight="500" fill="#5B6676" text-anchor="middle">You decide</text><circle cx="1260" cy="220" r="26" fill="#127A4B"/><path d="M1249.08 220.52 L1257.4 228.84 L1271.96 211.16" fill="none" stroke="#FFFFFF" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round"/><text x="1304" y="232" font-size="38" font-weight="700" fill="#18202C">D-103</text><text x="1236" y="306" font-size="26" font-weight="500" fill="#5B6676">Read back</text>+</svg>diff --git a/docs/design/readme-visuals/src/social-preview.svg b/docs/design/readme-visuals/src/social-preview.svgnew file mode 100644index 0000000..e7e8014--- /dev/null+++ b/docs/design/readme-visuals/src/social-preview.svg@@ -0,0 +1,12 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 640" width="1280" height="640" role="img" aria-labelledby="t d" font-family="Inter, 'Helvetica Neue', Arial, sans-serif">+<title id="t">AEC Model Bridge</title><desc id="d">AEC Model Bridge with the Pier logo, an architectural model illustration and the line AI-assisted BIM coordination.</desc>+<rect id="background" width="1280" height="640" fill="#F2F5F8"/>+<g id="pier-logo" transform="translate(88 96) scale(1.3333333333333333)"><rect width="96" height="96" rx="20" fill="#111923"/>+ <g stroke="#111923" stroke-width="2.5" stroke-linejoin="round">+ <polygon fill="#1CB5CA" points="48,16 76,32 48,48 20,32"/>+ <polygon fill="#FFFFFF" points="20,32 48,48 48,80 20,64"/>+ <polygon fill="#AEBCCB" points="48,48 76,32 76,64 48,80"/>+ </g>+ <path fill="#111923" transform="matrix(28,16,0,32,20,32)" d="M0.24,1.02 V0.66 A0.26,0.26 0 0 1 0.76,0.66 V1.02 Z"/>+ <path fill="#111923" transform="matrix(28,-16,0,32,48,48)" d="M0.24,1.02 V0.66 A0.26,0.26 0 0 1 0.76,0.66 V1.02 Z"/></g><text id="project-name" x="88" y="316" font-size="70" font-weight="700" fill="#18202C" letter-spacing="-1">AEC Model Bridge</text><rect x="90" y="346" width="96" height="6" rx="3" fill="#1CB5CA"/><text id="tagline" x="88" y="416" font-size="36" font-weight="500" fill="#5B6676">AI-assisted BIM coordination.</text><text x="88" y="560" font-size="26" font-weight="500" fill="#046B80">MCP server + native Revit add-in</text><g id="model-illustration"><polygon points="905.0,295.0 1216.8,475.0 1008.9,595.0 697.2,415.0" fill="#E4EAF0" stroke="#D3DAE3" stroke-width="1.3333333333333333" stroke-linejoin="round"/><line x1="939.6" y1="315.0" x2="707.5" y2="449.0" stroke="#D3DAE3" stroke-width="1.8666666666666665" stroke-linecap="round" stroke-dasharray="7 6"/><circle cx="692.0" cy="458.0" r="16.8" fill="#F2F5F8" stroke="#5B6676" stroke-width="1.3333333333333333"/><text x="692.0" y="464.8" font-size="20" font-weight="600" fill="#5B6676" text-anchor="middle">A</text><line x1="1060.9" y1="385.0" x2="828.8" y2="519.0" stroke="#D3DAE3" stroke-width="1.8666666666666665" stroke-linecap="round" stroke-dasharray="7 6"/><circle cx="813.2" cy="528.0" r="16.8" fill="#F2F5F8" stroke="#5B6676" stroke-width="1.3333333333333333"/><text x="813.2" y="534.8" font-size="20" font-weight="600" fill="#5B6676" text-anchor="middle">B</text><line x1="1182.1" y1="455.0" x2="950.0" y2="589.0" stroke="#D3DAE3" stroke-width="1.8666666666666665" stroke-linecap="round" stroke-dasharray="7 6"/><circle cx="934.4" cy="598.0" r="16.8" fill="#F2F5F8" stroke="#5B6676" stroke-width="1.3333333333333333"/><text x="934.4" y="604.8" font-size="20" font-weight="600" fill="#5B6676" text-anchor="middle">C</text><polygon points="905.0,203.0 1147.5,343.0 1008.9,423.0 766.4,283.0" fill="#FFFFFF" stroke="#18202C" stroke-width="2.5" stroke-linejoin="round"/><polygon points="766.4,415.0 1008.9,555.0 1008.9,423.0 766.4,283.0" fill="#EAF0F5" stroke="#18202C" stroke-width="2.5" stroke-linejoin="round"/><polygon points="1147.5,475.0 1008.9,555.0 1008.9,423.0 1147.5,343.0" fill="#D6DFE9" stroke="#18202C" stroke-width="2.5" stroke-linejoin="round"/><polyline points="766.4,371.0 1008.9,511.0 1147.5,431.0" fill="none" stroke="#18202C" stroke-width="2.5" stroke-linejoin="round"/><polyline points="766.4,327.0 1008.9,467.0 1147.5,387.0" fill="none" stroke="#18202C" stroke-width="2.5" stroke-linejoin="round"/><polygon points="783.8,413.0 804.5,425.0 804.5,401.0 783.8,389.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="814.9,431.0 835.7,443.0 835.7,419.0 814.9,407.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="846.1,449.0 866.9,461.0 866.9,437.0 846.1,425.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="908.5,485.0 929.2,497.0 929.2,473.0 908.5,461.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="939.6,503.0 960.4,515.0 960.4,491.0 939.6,479.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="970.8,521.0 991.6,533.0 991.6,509.0 970.8,497.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1033.2,529.0 1012.4,541.0 1012.4,517.0 1033.2,505.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="783.8,369.0 804.5,381.0 804.5,357.0 783.8,345.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="814.9,387.0 835.7,399.0 835.7,375.0 814.9,363.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="846.1,405.0 866.9,417.0 866.9,393.0 846.1,381.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="877.3,423.0 898.1,435.0 898.1,411.0 877.3,399.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="908.5,441.0 929.2,453.0 929.2,429.0 908.5,417.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="939.6,459.0 960.4,471.0 960.4,447.0 939.6,435.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="970.8,477.0 991.6,489.0 991.6,465.0 970.8,453.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1133.6,427.0 1112.8,439.0 1112.8,415.0 1133.6,403.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1099.0,447.0 1078.2,459.0 1078.2,435.0 1099.0,423.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1064.3,467.0 1043.6,479.0 1043.6,455.0 1064.3,443.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1033.2,485.0 1012.4,497.0 1012.4,473.0 1033.2,461.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="783.8,325.0 804.5,337.0 804.5,313.0 783.8,301.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="814.9,343.0 835.7,355.0 835.7,331.0 814.9,319.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="846.1,361.0 866.9,373.0 866.9,349.0 846.1,337.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="877.3,379.0 898.1,391.0 898.1,367.0 877.3,355.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="908.5,397.0 929.2,409.0 929.2,385.0 908.5,373.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="939.6,415.0 960.4,427.0 960.4,403.0 939.6,391.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="970.8,433.0 991.6,445.0 991.6,421.0 970.8,409.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1133.6,383.0 1112.8,395.0 1112.8,371.0 1133.6,359.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1099.0,403.0 1078.2,415.0 1078.2,391.0 1099.0,379.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1064.3,423.0 1043.6,435.0 1043.6,411.0 1064.3,399.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="1033.2,441.0 1012.4,453.0 1012.4,429.0 1033.2,417.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/><polygon points="877.3,479.0 898.1,491.0 898.1,454.2 877.3,442.2" fill="#FFFFFF" stroke="#18202C" stroke-width="1.7333333333333334" stroke-linejoin="round"/><polygon points="1130.2,485.0 1111.1,496.0 1111.1,459.2 1130.2,448.2" fill="rgba(28,181,202,0.35)" stroke="#1CB5CA" stroke-width="3.375" stroke-linejoin="round"/><polygon points="1092.1,507.0 1073.0,518.0 1073.0,481.2 1092.1,470.2" fill="#FFFFFF" stroke="#18202C" stroke-width="1.7333333333333334" stroke-linejoin="round"/><polygon points="1054.0,529.0 1034.9,540.0 1034.9,503.2 1054.0,492.2" fill="#FFFFFF" stroke="#18202C" stroke-width="1.7333333333333334" stroke-linejoin="round"/><polygon points="911.9,211.0 1022.8,275.0 953.5,315.0 842.6,251.0" fill="#FFFFFF" stroke="#18202C" stroke-width="2.5" stroke-linejoin="round"/><polygon points="842.6,287.0 953.5,351.0 953.5,315.0 842.6,251.0" fill="#EAF0F5" stroke="#18202C" stroke-width="2.5" stroke-linejoin="round"/><polygon points="1022.8,311.0 953.5,351.0 953.5,315.0 1022.8,275.0" fill="#D6DFE9" stroke="#18202C" stroke-width="2.5" stroke-linejoin="round"/><polygon points="853.0,281.0 943.1,333.0 943.1,319.0 853.0,267.0" fill="rgba(28,181,202,0.22)" stroke="#18202C" stroke-width="1.3333333333333333" stroke-linejoin="round"/></g>+</svg>diff --git a/docs/images/readme/readme-hero-dark.png b/docs/images/readme/readme-hero-dark.pngnew file mode 100644index 0000000..373a64dBinary files /dev/null and b/docs/images/readme/readme-hero-dark.png differdiff --git a/docs/images/readme/readme-hero-light.png b/docs/images/readme/readme-hero-light.pngnew file mode 100644index 0000000..9264ec4Binary files /dev/null and b/docs/images/readme/readme-hero-light.png differdiff --git a/docs/images/readme/readme-workflow-dark.png b/docs/images/readme/readme-workflow-dark.pngnew file mode 100644index 0000000..733746bBinary files /dev/null and b/docs/images/readme/readme-workflow-dark.png differdiff --git a/docs/images/readme/readme-workflow-light.png b/docs/images/readme/readme-workflow-light.pngnew file mode 100644index 0000000..5014484Binary files /dev/null and b/docs/images/readme/readme-workflow-light.png differdiff --git a/docs/images/readme/social-preview.png b/docs/images/readme/social-preview.pngnew file mode 100644index 0000000..cbf6a47Binary files /dev/null and b/docs/images/readme/social-preview.png differ