Skip to content

v2 site view is a wireframe of the approved design, not the design #112

Description

@pseudoseed

Problem. Comparing the shipped /v2/ render against codev/research/v2-mockups/01-site.png side by side, the structure and palette match but almost everything that makes the design readable was dropped. It reads as a wireframe of the mockup.

Spec 83 checked tokens, containment, rust discipline and D8 chrome absence — all of which passed. Nothing checked fidelity against the mockup itself, which is why this got through review.

Missing, all present in the approved design:

Approved (01-site.png) Shipped
Header: Porch mark, SITE REGISTER · 2 MACHINES · 5 WORKSPACES · 11 BUILDERS, FIND NODE ⌘K, ADD MACHINE, gate badge localhost THIS MACHINE and nothing else
tower-01 MAC STUDIO · FOREMAN'S RIG + ONLINE · 41% LOAD no machine metadata at all
WORKSPACE / CHECKOUT with icon bare CODEV-1455
architect/checkout-v3 with icon and status dot bare main
builder/pay-2201 bare spir-83
Sparkline as visible bars of varying height a row of dots, effectively invisible
Offline machine shows RECONNECT TO RESUME in its empty lot nothing
Plots sized to content, ~3 across, compact stretched to the tallest in the row (#111)

The naming convention is the biggest single loss. workspace/, architect/ and builder/ prefixes are how the design tells four node kinds apart at a glance. Without them every row is an undifferentiated string, and the hierarchy has to be inferred from indentation alone — which is the outline FR-1 explicitly rejects.

Sparklines. .spark i bars render at the trace value, so an all-zero trace is zero-height and reads as dots. The mockup's idle builders show a visible flat baseline (....... at a consistent low height) rather than nothing. An idle builder should look idle, not look broken.

Not in scope, correctly omitted: gate queue rail, live panes, find-node, add-machine. Those are later units per D8 and are absent rather than stubbed, which was the right call.

Scope of a fix. Restore the label prefixes and icons, the header bar with its counts, machine metadata where the wire carries it (and omit what it does not — do not invent 41% LOAD), a visible idle baseline for sparklines, and the offline-lot placeholder. Fix #111 in the same pass since it is one line and compounds all of this.

Testing. A fidelity check the current suite has no equivalent of: render a fixture matching the mockup's data and assert the label prefixes, header counts and sparkline baseline are present. Component tests that assert only "the name renders" cannot catch a missing prefix.

Found by the architect comparing renders after merge. Spec 83's review verified tokens and structure and never compared against the mockup — that gap is the reason this shipped.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/dashboardTower web dashboardfork-onlyDeliberately not upstreamed to cluesmith/codev

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions