Files
Claude 07cf81bd47 Handoff layout: new README; build-chat notes moved to docs/build-notes/
- README.md: what this is, how to run and build it, the folder map, how light and dark
  mode work (@hanzo/appearance, @hanzo/design), where every price and checkout link
  lives, scripts, and known differences from live
- docs/build-notes/: status files, request notes, per-page checklists and reviews, plans
- Removed: screenshot galleries, captures of third-party sites used as references,
  the generated status page and its script, editor config, a personal working-rules file
- Code comments point at the new docs paths (no code changes)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01P5YBdwj33XByFVTvu9bfci
2026-11-08 13:22:36 +00:00

18 KiB
Raw Permalink Blame History

/o11y coverage (MASTER.md part 2, the 18 parts)

Page file: components/pages/cloud/O11y.jsx (+ O11y.css) · route: app/o11y/page.jsx · gallery: docs/gallery/o11y/ · metric id: api_key_created

Open copy questions for James: none. The page keeps every live word; "View on GitHub" is the live hero label, reused as the one ask; "o11y.hanzo.ai" (the live eyebrow) sits in the window's address bar, not above the h1. Demo labels now reuse Hanzo's own phrases ("the same store the traces are in", "links to the trace that raised it", "one row with a number on it", "one endpoint variable", "if you already have it") instead of new wording. Shared changes requested (docs/build-notes/requests/o11y.md): (1) the site's ask bar floats over content on desktop (MASTER §3.2 rule 6; the parent owns it, and the page relies on it between the hero and the close); (2) RelatedCards' data-morph title makes the site cursor say "Open" (handled page-locally with pointer-events: none); (3) Frame's Paste/Console still carry Apple greys, a shadow and 18/10px radii (handled page-locally); (4) lib/cta.js and lib/track.js do not exist yet. Forks this page deleted: the header "Try Hanzo" override (Ask.jsx now decides), the forever-looping pivot (runs once, rests), the fake aria-hidden suite tabs (now buttons), the white suite window (now the hero's dark window), the ports pane repeated before the OTLP figures, the "What you keep" paragraph reprints, the separate Paste section (now inside the OTLP room), the centred hero head (now the 8/5 split), the suite's drop shadow, the window's shadow and double surfaces (fill plus hairline on the window, the logs card and the filter), the three-equal-boxes route grid, the hover scale on the waterfall bars, the 1px hover lift and .98 presses, every Apple grey (#1d1d1f, #6e6e73, #8e8e93, #a1a1a6, #c7c7cc, #d1d1d6, #f2f2f4, #f5f5f7, #161618, #1c1c1f, #232326, #424245, #48484a, #111113), figures over 64px (72 and 84), the page's own Paste/x-copy overrides that duplicated the kit.

Tick what applies. Strike the rest as n/a: reason. Fill each Done here: line with one or two sentences of evidence (a value, a file, a number). A part counts once its Done here: line has text.

1. Strategy and conversion

  • Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
  • One solid fill per viewport; label and href from lib/cta.js (n/a for the file: it does not exist yet; the label is Hanzo's live hero label)
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; prices from lib/plans.js (n/a for prices: none on this page)
  • Open copy questions for James listed, none decided

Done here: // Persona: Developer, // Goal:, // CTA: View on GitHub → github.com/hanzoai/o11y, Metric: api_key_created, // Signature: the pivot, // Beyond: what you keep and // V2: head both O11y.jsx and app/o11y/page.jsx. fs-audit.cjs finds the ask on screen and clear at 1470×801 and 375×812. Only the hero and the close carry the ask; the page's header override is gone, so components/Ask.jsx carries "View on GitHub" in between and outlines the header's "Try Hanzo" while a page ask is on screen. The chosen "what you keep" chip is a white fill, not a second solid.

2. Information architecture and navigation

  • One <main id="main">; skip link reaches it (the layout's skip link targets the page's one <main>)
  • Every link through A, Go, More or href(); every card a real link
  • Breadcrumb at depth 2 or more (n/a: depth 1)
  • Link parity: 0 removed, 0 unexpected

Done here: Every link renders through kit A (hero ask, console's eight product links via LaunchConsole, the Logs and Metrics cards via RelatedCards, the close via LaunchClose). parity.py /o11y: 12/12 links.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero (n/a for the component: not merged; the hero is the kit's LineMask h1 + lede + one ask + the live waterfall); nothing above the h1
  • JS off: legible; no opacity:0 on the LCP element
  • One idea per 100svh; no 3 same-height sections in a row
  • Ends in proof strip, Band, footer (the close is LaunchClose: the page's Sigil, "Get O11y", the one ask, licence and repo)
  • Card-to-page links use Morph; title lands within 12px (the Logs and Metrics titles carry data-morph)

Done here: The first screen is the black room: h1 52px left, lede and ask right (8/5 split, bottom-aligned), then the waterfall window whose bars draw in by 1.4 s while a playhead sweeps it; fs-audit.cjs measures 1,353 changed px (desktop) and 1,201 (phone) between 0 and 0.9 s after load, with nothing above the h1. The pivot runs once (slow span → payments → api → slow span, 9 s) and rests. With JS off (c3nojs.cjs) only the console's hover tips are hidden; every Hanzo word reads. Rhythm: black hero, tall pinned suite (the same dark window), quiet #f5f5f5 room (endpoint, keep, console, agent prompt), cards, close.

4. Conversion system

  • <Cta> only; no raw .x-btn (the kit's lx-cta mirrors Cta at 48px; noted for the swap)
  • Sticky ask in header and bar after the hero, same label (carried by the shared components/Ask.jsx from data-thumb)
  • Copy button copies exactly the displayed text; failure never says Copied (the kit's Copy in Frame's Paste)
  • data-cta and data-thumb on every primary

Done here: The hero ask carries data-cta="o11y.hero" data-thumb="View on GitHub" data-cursor=""; the close carries o11y.close with the same thumb, and nothing else on the page uses those words, so the site's bar rises after the hero (seen in look2.cjs frames 2–11) and steps aside at the close. data-ask-name="Hanzo O11y" is on the hero section inside <main>. Second review (7/10) answered: the hero ask's hover fills to the deck's #e4e4e7 and its arrow steps 4px (measured with a fine-pointer Chromium: rgb(250,250,250) → rgb(228,228,231), translateX 4); on phone the hero ask is a white hairline so the header's "Try Hanzo" is the one solid on the first screen (probe: 1 solid at 375×812, 1 at 1470×801).

5. Trust and proof

  • No logo without documented permission; no seal; no invented number
  • Every figure traces to Hanzo's copy; qualifier beside the number
  • Marquees pause, freeze under reduced motion, hide duplicates (n/a: no marquee)
  • Privacy link and owner line beside every submit (n/a: no form)

Done here: The figures are Hanzo's: 4317 and 4318 (chapter 06, set once as the OTLP room's figures; chapter 06's pane shows the wire instead), "a thousand of the same stack trace" (chapter 04, shown as 1,000), "4 stars" and "Apache-2.0". Span names, log lines and the query are labelled examples in the file header. No proof or objection strip: the live page has no FAQ, compliance or proof copy to draw one from.

6. Content presentation (copy untouched)

  • No text under 13px (14px phone) except mono capitals
  • Measures held; no orphan word in a heading
  • Tables, FAQ, tabs and code use the kit parts (the suite is an illustration, aria-hidden; the code is Frame's Paste)
  • python3 scripts/parity.py /o11y: 0 missing

Done here: Parity 58/58 text and 12/12 links. jx-audit.cjs finds no text under 13px on desktop and none under 14px on phone: the page's mono captions (.ob-k, "if you already have it", the chapter numbers, "Related capabilities") are 13px desktop / 14px phone, and the close's facts are lifted to 14px on phone. Chapter numbers sit under their h3 as captions, not above. "What you keep" now answers with the part's title and an object (the query, the endpoint figures underlined, the route list), never a reprinted paragraph.

7. Visual design system

  • python3 scripts/taste.py <files> passes; no literal hex outside the deck
  • No label, tag, badge or pill above a headline
  • Radii, shadows and sizes from tokens; never box plus shadow
  • One icon set; no icon in a rounded box
  • Differs from neighbours in hero medium and room order

Done here: taste.py OK and jx-audit.cjs reports 0 computed colours off the deck and 0 off-deck radii (desktop and phone). One black room (#000, the hero); the product window is flat graphite #171717 (hero and suite) with no hairline; inner cards are flat #262626; the exceptions row is a 1px hairline; no shadow on anything that does not float. Radii 24 (suite), 16 (cards, console, paste), 12 (rows), 6 (bars), full (pills). Neighbours: /metrics opens on a chart tile on white and pins a white table; /registry pins a white repository window; /o11y keeps its dark trace window from hero to suite.

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading
  • Focus ring visible on every stop of a Tab crawl (kit: 2px ink with a white halo, white with a black halo in the black room)
  • Dialogs are native, trap focus and return it (n/a: no dialog; the SpecDrawer has no sheet here)
  • Inputs 16px or larger; no bare :hover (n/a for inputs: none)
  • Forks this page deleted: listed at the top

Done here: jx-hover.cjs hovers every control: each changes fill or ink (span rows: fill + ink + bar fill; suite tabs: ink + fill; chips: hairline and word ink; cards: fill; console title, paste Copy and text links: ink or underline; the lit tab, the lit rail tick and the chosen chip answer too: underline, a thicker tick, a hairline; console links and the repo link press .97), no layout jump, no opacity-only hover, no cursor label. Presses are scale .97 for 90 ms (console icons too). Suite tabs are real buttons that scroll the pinned scene to their chapter; spans and chips have aria-pressed; disabled and loading do not arise (nothing is fetched).

9. Motion and interaction

  • One signature, at most 3 supporting techniques, at most 2 fade-ups
  • At least 3 kinds of movement; scroll-linked is half or less
  • Something moves without input; every control answers
  • Reduced motion shows the final state; no setInterval
  • Sound only on the listed moments, through the one kit (n/a: the shared sound kit has not landed)

Done here: Signature: the pivot (spans open into their logs every 3 s while a playhead sweeps the request, once, 9 s, then it rests; play replays). Supporting (3): the line-masked h1; the pinned suite, where each pane draws as it arrives (six wires into one query, trace bars, the chart line, log lines streaming, four rows folding into one while 1,000 settles from big, routes, the OTLP wire); the timed wipe into the OTLP room. While a chapter is read the suite stays live (re-walk 7 Nov 16:20, motion.mjs: 0 STILL screens of 11 desktop and 14 phone, was 6 and 11): a UTC clock ticks in the window bar (chained setTimeout, only on screen), a playhead hairline sweeps the Traces and Metrics panes (6 s, linear), a caret waits under the Logs; all stop under reduced motion. Kinds: idle, pointer (span preview, magnetic close ask ≤22px), state (tabs, chips, held span, pause/replay), arrival, scroll (settle 1.06 → 1, pinned suite, "Get O11y" grows 26 → 64). No springs; durations 90/150/300/400/500 (+ 900 ms line art); variety.py OK; one Rise (Frame's Paste).

10. Media

  • Film and Pic only; sizes and posters set (n/a: Hanzo has no O11y photo or film)
  • At most 2 videos playing; pause button on loops over 5 s (no video; the waterfall loop has a 44px LivePause, first in its bar)
  • Budgets met; nothing missing; alt on every image (n/a: no images)
  • No dimmed or filtered photo; 4+ real visuals together where the page has them (n/a: no Hanzo media for O11y)

Done here: Every object is product UI (waterfall, suite, console, agent prompt) or the page's Sigil drawn from its own figures [4317, 4318, 4].

11. Mobile and responsive

  • 375×812 and 1470×801 pass with no overlap
  • No horizontal scroll at 320
  • Every target 44px or more; every hover has a tap path
  • Primary ask above the fold at 375×667

Done here: At 375×812 the h1, lede, ask and six span rows of the waterfall share the first screen; the suite sits above each chapter at 38svh and pinchk.cjs passes 7/7 chapters (text clears the bottom bar). Span rows 46px, chips 44px, console icons 44px; hover previews have a tap equivalent (tap a span to hold it). jx-audit.cjs: no sideways scroll. jx-cls.cjs: CLS 0.0000 over 15 s with the hero in view at 375×812 and 1470×801 (the logs card always holds three lines). The query breaks only between its tokens (<wbr> after rate( and before [5m], word-break: keep-all), never mid-word; the keep chips are a stacked list (pills on one line on desktop, 12px-radius rows on phone, so no pill wraps). Third review (7/10) answered: the suite no longer tucks under the hero, so the first screen holds one dark window. Every chapter's pane fills one fixed stage (400px desktop, the kit's 38svh object minus the bar on phone): measured content/stage 86–100% at every step at 1470×801 and 375×812 (Exceptions gains the trace it links to, the hero's waterfall drawn small with the db span lit; Alerts gains the saved query's line and its dashed threshold; OTLP gains the endpoint variable line). The wires share one grid row with their labels, which split it into equal rows, so every curve leaves the vertical centre of its label and lands on the query or the endpoint: measured offset 0px for all 6 intro wires and both OTLP wires at both sizes. Tab hover is an ink word with a hairline; only the lit tab sits on the pill. The related cards follow the paste room without a second section gap (44px), and the close sits 72px above the footer. Copy question: the reviewer asked to replace the console's deploy list (gateway Ready, payments-api, checkout-web Building, docs-site); those rows are Hanzo's live /o11y copy (content/live/o11y.json), so copy-first precedence keeps the console.

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured, text at 4.5:1 or better
  • Pause control on every moving item
  • Forms labelled; first error focused (n/a: no form)
  • One h1; no heading skips; names start with visible text
  • Keyboard reaches every control

Done here: Measured: #a3a3a3 on #171717 7.11:1, on #262626 6.0:1; white 78% on #000 12.4:1 and on #262626 8.7:1; #525252 on #f5f5f5 7.17:1; #737373 on white 4.74:1 (used only on white). jx-audit.cjs finds 0 failures inside the page's own surfaces. Headings: h1, h2 (intro), h3 ×6, h2 (OTLP), h2 (close). The opened logs are aria-live; the suite illustration is aria-hidden.

13. Performance and engineering

  • h1 and LCP element in server HTML
  • JS and CSS inside budget; every image and video sized (n/a for media: none)
  • No poller; no third-party request before consent
  • Nothing heavy run on James's laptop

Done here: The h1 cuts in by CSS at first paint and is in the server HTML. Timers are useSteps timeouts that stop off screen, on hover and on pause; motion animates transform, opacity and clip-path only. Filming and audits ran in the cloud container.

14. SEO and machine files

  • Title and description match live (or are listed for James)
  • Canonical equals og:url equals the live URL (owned by the shared layout)
  • <JsonLd route> parses; no broken URL
  • Every card is a real link

Done here: app/o11y/page.jsx takes metadata from content/pages.json unedited and renders <JsonLd route="/o11y" />. The Logs and Metrics cards are real <a href>.

15. Catalogue and product pages

  • Model card matches SPEC.md (n/a: not a catalogue or model page)
  • Every card opens by Morph (both related titles carry data-morph)
  • Every maker and model page linked in the DOM (n/a)
  • One price figure everywhere (n/a: no prices)

Done here: A cloud product on the shared anatomy: identity (h1, address in the window), the console (LaunchConsole), openable features (six pinned chapters), a 2-fact spec (4317 gRPC, 4318 HTTP), and the close.

16. Developer experience

  • One CodeBlock; copy equals display (the agent prompt via Frame's Paste copies exactly what it shows)
  • Config blocks parse on their own (n/a: no config block)
  • Terminal pauses and ends on a static frame (n/a: no terminal; the waterfall has a pause and rests on the slow span)
  • No hand-typed version number

Done here: The one code surface is the agent prompt; its Copy writes exactly the displayed string. PromQL shows in the suite as an example; no version numbers appear.

17. States and resilience

  • Loading, empty, error and offline states designed (n/a: nothing is fetched; complete at first paint)
  • Blocked live data leaves a complete page, no console errors
  • A failed submit keeps its values and shows no success (n/a: no form)
  • A thrown island does not blank the page (Sigil, Phone and Cursor boundaries belong to the shared layer)

Done here: look2.cjs and jx-audit.cjs log 0 console errors. The demo's states are designed: running (playhead), hovered preview, held (clicked span, no sweep), paused (playhead frozen), at rest (slow span open, play icon replays), reduced motion (bars drawn, slow span open, no sweep), JS off (waterfall drawn, intro wires drawn).

18. Measurement and handover

  • data-cta on every primary; events only through lib/track.js (n/a for the file: it does not exist yet; ids are in place)
  • Nothing identifier-bearing before consent; no field value in a payload
  • V2: <score>/10 <one line> in the page file's top comment
  • Review read: docs/build-notes/review/o11y.md verdict 8 or more (read: 7/10 on the earlier build; every one of its seven fixes is answered here, awaiting the re-review)

Done here: o11y.hero and o11y.close are set. Gallery: docs/gallery/o11y/d.mp4 (whole-page scroll), d.jpg, p.jpg. Review 7/10 answered: (1) no jump, CLS 0; (2) header override deleted, one ask via hero, site bar, close; (3) tabs are real buttons; (4) the suite is the hero's dark window walking the request, the paste moved into the OTLP room; (5) ports once, keep answers with objects; (6) panes draw, the pivot runs once and rests; (7) floors 13/14px, link hover, console press.