From 8d0c92dccffb06d13b162dd6d77c07b9dec1e91c Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Tue, 14 Jul 2026 00:43:16 +0200 Subject: [PATCH 01/14] feat(dashboard): visual-revamp design system + adversarial gate Baseline references, design-language + rollout doctrine, Home spec, DS-uplift ledger, and per-pass reports (V2b Home, V3 investigation spine, V4 consoles). Prototype source + per-pass snapshots land as each visual pass completes. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01HTiQfrNFCVhjQFqbLKm5xo --- .../render/_visual-reports/V1-complete.md | 91 ++++++ .../render/_visual-reports/V2-shell-home.md | 133 +++++++++ .../_visual-reports/V2b-home-highcraft.md | 250 ++++++++++++++++ .../_visual-reports/V3-investigation-spine.md | 223 ++++++++++++++ .../V4-consoles-workers-sagas.md | 278 ++++++++++++++++++ .../visual/DESIGN-LANGUAGE.md | 61 ++++ .../visual/DS-UPLIFT-BACKLOG.md | 171 +++++++++++ .../beta10--orchestrator/visual/HOME-SPEC.md | 69 +++++ .../visual/ROLLOUT-DOCTRINE.md | 77 +++++ .../beta10--orchestrator/visual/V1-brief.md | 45 +++ .../visual/_evals/V3-adversarial-brief.md | 21 ++ .../visual/_evals/V3-adversarial.md | 242 +++++++++++++++ .../visual/_evals/V3-vision-eval.md | 0 .../visual/_kimi-smoke.md | 9 + .../beta10--orchestrator/visual/_smoke.md | 7 + .../references/01-synergy-hr-desktop.png | Bin 0 -> 119771 bytes .../references/02-synergy-mobile-nav.png | Bin 0 -> 95565 bytes .../visual/references/03-analytics-cards.png | Bin 0 -> 225516 bytes .../visual/references/04-finance-cards.png | Bin 0 -> 99892 bytes .../references/05-timeoff-workhour-cards.png | Bin 0 -> 104177 bytes .../visual/references/06-mobile-sheets.png | Bin 0 -> 228615 bytes .../visual/references/07-chat-signin.png | Bin 0 -> 246723 bytes .../visual/references/08-ref.png | Bin 0 -> 607823 bytes .../visual/references/09-ref.png | Bin 0 -> 310496 bytes .../visual/references/10-ref.png | Bin 0 -> 284729 bytes .../visual/references/11-devconsole-a.png | Bin 0 -> 731179 bytes .../visual/references/12-devconsole-b.png | Bin 0 -> 862039 bytes .../visual/references/13-devconsole-c.png | Bin 0 -> 676061 bytes .../visual/references/14-ref.png | Bin 0 -> 1970681 bytes .../visual/references/15-ref.png | Bin 0 -> 619933 bytes .../visual/references/16-ref.png | Bin 0 -> 819892 bytes .../visual/references/17-ref.jpg | Bin 0 -> 376805 bytes .../visual/references/18-ref.jpg | Bin 0 -> 390871 bytes .../visual/references/19-pm-dashboard.png | Bin 0 -> 256402 bytes .../visual/references/20-ref.png | Bin 0 -> 280465 bytes .../visual/references/21-flow-builder.webp | Bin 0 -> 63970 bytes 36 files changed, 1677 insertions(+) create mode 100644 .llm/runs/beta10--orchestrator/render/_visual-reports/V1-complete.md create mode 100644 .llm/runs/beta10--orchestrator/render/_visual-reports/V2-shell-home.md create mode 100644 .llm/runs/beta10--orchestrator/render/_visual-reports/V2b-home-highcraft.md create mode 100644 .llm/runs/beta10--orchestrator/render/_visual-reports/V3-investigation-spine.md create mode 100644 .llm/runs/beta10--orchestrator/render/_visual-reports/V4-consoles-workers-sagas.md create mode 100644 .llm/runs/beta10--orchestrator/visual/DESIGN-LANGUAGE.md create mode 100644 .llm/runs/beta10--orchestrator/visual/DS-UPLIFT-BACKLOG.md create mode 100644 .llm/runs/beta10--orchestrator/visual/HOME-SPEC.md create mode 100644 .llm/runs/beta10--orchestrator/visual/ROLLOUT-DOCTRINE.md create mode 100644 .llm/runs/beta10--orchestrator/visual/V1-brief.md create mode 100644 .llm/runs/beta10--orchestrator/visual/_evals/V3-adversarial-brief.md create mode 100644 .llm/runs/beta10--orchestrator/visual/_evals/V3-adversarial.md create mode 100644 .llm/runs/beta10--orchestrator/visual/_evals/V3-vision-eval.md create mode 100644 .llm/runs/beta10--orchestrator/visual/_kimi-smoke.md create mode 100644 .llm/runs/beta10--orchestrator/visual/_smoke.md create mode 100644 .llm/runs/beta10--orchestrator/visual/references/01-synergy-hr-desktop.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/02-synergy-mobile-nav.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/03-analytics-cards.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/04-finance-cards.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/05-timeoff-workhour-cards.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/06-mobile-sheets.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/07-chat-signin.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/08-ref.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/09-ref.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/10-ref.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/11-devconsole-a.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/12-devconsole-b.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/13-devconsole-c.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/14-ref.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/15-ref.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/16-ref.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/17-ref.jpg create mode 100644 .llm/runs/beta10--orchestrator/visual/references/18-ref.jpg create mode 100644 .llm/runs/beta10--orchestrator/visual/references/19-pm-dashboard.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/20-ref.png create mode 100644 .llm/runs/beta10--orchestrator/visual/references/21-flow-builder.webp diff --git a/.llm/runs/beta10--orchestrator/render/_visual-reports/V1-complete.md b/.llm/runs/beta10--orchestrator/render/_visual-reports/V1-complete.md new file mode 100644 index 000000000..5122801c5 --- /dev/null +++ b/.llm/runs/beta10--orchestrator/render/_visual-reports/V1-complete.md @@ -0,0 +1,91 @@ +# V1 — Global Design-System Foundation (visual-only pass) + +**Scope:** System-level visual polish only. No route, logic, data, feature, markup-text, +or markup-structure changes. Raw `ns-*` class markup preserved (round-trips to Fresh source). +Warm-cream light default + dark both retained. All edits are additive rules appended to +`assets/ns-ext.css` (which loads **last**, after `_ns_styles.css` → `proto.css`, so equal-specificity +overrides of the DS card/panel/shadow rules win legitimately without touching the generated closure). + +**Files touched:** `assets/ns-ext.css` (one appended `V1 — GLOBAL DESIGN-SYSTEM FOUNDATION` block). +`proto.css` not modified — the console page-header size rule already lived there and only needed a +tracking/weight refinement, which the ns-ext override supplies. Markup not modified. + +**Verification:** 16 nav screens × 2 themes = 32 captures, every iteration. `holes[]` and `errors[]` +stayed `[]` on all 32 through the final run. Zero surviving `{{ }}`, zero console errors, in both themes. +Tokens only — no raw hex introduced (the only `rgba()` values are inside shadow/highlight definitions, +matching the DS's own shadow-token convention, e.g. `--ns-shadow-* : … rgba(0,0,0,…)`). + +Final screenshot outdir: +`/tmp/claude-1000/-home-codex-repos-netscript-beta10/cd2ee104-ed45-4ed4-bcca-f960c60a1d84/scratchpad/shots-final` + +--- + +## What changed, and why + +### 1. Signature "press" shadow (biggest lever) +NS One's stated identity is a **hard-offset press shadow**, but the DS shipped generic soft-blur +Material shadows (`--ns-shadow-xs: 0 1px 2px rgba(0,0,0,.05)`), which read as templated. Redefined the +entire shadow ramp (`xs`→`xl`) for **both** themes to a crisp vertical-offset + tight-spread cast so every +surface sits on the canvas with intent. +- **Light:** cast uses the warm ink (`rgba(41,37,33,…)`) at low alpha instead of pure black — sits with + the warm-cream palette instead of graying it. +- **Dark:** deeper offset cast, paired with border + top-highlight (see #3) so raised surfaces read. +- *Before:* cards looked flat/washed, indistinguishable from the page. *After:* cards read as distinct + instrument planes with a subtle lift. + +### 2. Surface language — card + panel +- Radius `--ns-radius-xl` (12px, reads soft/marketing) → **10px** (reads instrument) on `.ns-card`, + `.ns-panel`, and the net-new console cards (`.ns-kpi`, `.ns-assist`, `.ns-incident`, `.ns-statlink`, + `.ns-logstrip`) so hand-built surfaces match the DS card exactly. +- Every card now carries a resting `--ns-shadow-sm/xs` and net-new console cards inherit the same, so the + card grid on Home / Runtime / DLQ reads as a set of planes rather than outlined rectangles. +- Unified interactive feel: `.ns-card--interactive`, `.ns-kpi`, `.ns-stackmap__node` all lift to + `--ns-shadow-md` on hover — one hover language across DS and net-new surfaces. + +### 3. Border presence + dark-mode machined edge +- **Light:** card/panel resting border firmed one notch above the `rgba(0,0,0,.08)` hairline + (`color-mix(border-strong 45%, border)`) so the press shadow lands against a real edge, not a wash. + Calibrated to stay present-but-not-heavy on the cream canvas. +- **Dark:** the baseline borders were near-invisible (`rgba(235,228,210,.06)`) — KPI/stat cards + dissolved into the near-black canvas. Bumped card/panel/kpi/statlink/logstrip borders to + `--ns-border-strong` **and** added a 1px inset top-highlight (`inset 0 1px 0 rgba(235,228,210,.04)`) + so raised surfaces catch a Linear/Vercel-style machined edge. This was the single most visible + dark-mode fix. + +### 4. Typography +- Display headings: tightened tracking to `-0.02em` on `.ns-page-header h1` for a machined feel. +- Console page-header (`--console`, used on the 16 in-shell detail views): `text-2xl` / weight 650 / + `-0.018em` / line-height 1.15 — one clear notch below the marketing h1 but same optical intent. +- Lede: normalized to one size (`--ns-text-sm`), relaxed leading, `max-width: 68ch` — calmer measure, + consistent across screens (was `0.925rem` and running a touch large/loose). +- Mono uppercase micro-labels (KPI labels, log heads, mini-labels, CLI labels, grounding labels) + normalized to `0.09em` tracking so they read as one family instead of drifting per component. + +### 5. Console rhythm + focus +- Three-zone `.ns-console-grid` gutter tightened one step (`space-6`→`space-5`, `space-6` at ≥1440px) + for a denser operator feel without crowding. +- KPI intra-card rhythm tightened (`gap: space-1-5`, value `letter-spacing: -0.01em`) so the number + dominates and the sparkline reads as a footnote — the label+value+delta read as one stat block. +- Standardized focus ring offset to 2px on the net-new interactive rows (`.ns-flowrow`, `.ns-quickcmd`, + `.ns-seg__btn`) that previously used mixed 1px/2px/no-offset. + +--- + +## Deliberately deferred to later per-screen clusters + +These are per-screen or component-internal calls, out of scope for a system-level V1 foundation: + +- **KPI value↔label vertical spacing on Runtime Config** — the big stat numbers ("2 active", "0", …) + sit slightly loose relative to their caption; a per-screen density pass should tune the specific + `ns-kpi`/stat markup on that screen rather than the global token. +- **Waterfall / stackmap internal density** (Run Inspector, Catalog stackmap) — proportional-bar and + node-graph tuning is component-scoped, best done in the component's own cluster. +- **Log-stream / logstrip column widths** — the fixed grid-template columns are content-specific; leave + to the log-surface cluster. +- **Segmented-control + toggle-switch micro-states** — these are DS primitives; any refinement belongs + in a DS-primitive pass, not a consumer-CSS override. +- **Sparkline stroke weights per tone** — legible as-is; a data-viz cluster can calibrate stroke/opacity + per intent color if desired. + +No accessibility, contrast, or hole/error regressions were observed; the foundation holds in both +themes across all 16 nav screens. diff --git a/.llm/runs/beta10--orchestrator/render/_visual-reports/V2-shell-home.md b/.llm/runs/beta10--orchestrator/render/_visual-reports/V2-shell-home.md new file mode 100644 index 000000000..d0b917f7c --- /dev/null +++ b/.llm/runs/beta10--orchestrator/render/_visual-reports/V2-shell-home.md @@ -0,0 +1,133 @@ +# V2 — BOLD shell + Home redesign (sets the new quality bar) + +Scope: **shell (sidebar + topbar) + Home only**. Visual + layout only — no route, logic, data, +feature, or copy-meaning change. Warm-cream light + dark, hard-offset press shadow, `--ns-*` tokens +only (no raw hex), `ns-*` class markup, DM Sans / DM Mono preserved. Zero `{{ }}` in the rendered +DOM, zero console errors, no horizontal body scroll — verified desktop (1440×900) **and** mobile +(390×844), both themes, plus a rail-collapsed and drawer-open pass. + +Reference bar: `references/01-synergy-hr-desktop`, `02-synergy-mobile-nav`, `03-analytics-cards`, +`04-finance-cards`, `05-timeoff-workhour-cards`, `06-mobile-sheets`, `08-ref` (Pulsar, the closest +dev-dashboard analogue), `09-ref`. Adopted their **structure / density / component-variety / +hierarchy / chrome / responsiveness**; kept NS One's **identity** (copper primary, teal/amber/red +state — not the refs' purple/green/soft-rounded). + +## Files touched +- `render/prototype.dc.html` — shell markup (sidebar + topbar), Home markup recomposition, S1 data + builders in the `data-dc-script` logic, two post-mount geometry drawers. +- `render/assets/ns-ext.css` — all net-new component CSS (loads last; overrides DS defaults where + needed). `proto.css` and the DS `_ns_styles.css` / `support.js` were **not** edited. + +## The one collision that mattered (recorded so it doesn't recur) +The DS ships a layout primitive named **`.ns-sidebar`** (Every-Layout "Sidebar": a horizontal +sidebar+content flex row). Adding `ns-sidebar` to the dashboard `