Files
site/docs/build-notes/coverage/security.md
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

14 KiB
Raw Permalink Blame History

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

Page file: components/pages/Security.jsx · gallery: docs/gallery/security/ · metric id: contact_sales_submit (cta_click on security.hero, security.band)

Open copy questions for James: none decided. MASTER §4.2 lists "DPA and subprocessors, security.txt link" for /security, but on hanzo.ai those live on /trust; no copy or link was added here, and /security links /trust ("The controls, and how to check them"). Shared changes requested (docs/build-notes/requests/<page>.md): docs/build-notes/requests/security.md — restore the native-dialog components/v2/DetailSheet.jsx (a merge left the JSX and CSS mismatched); the page uses a local copy, components/pages/security/Sheet.jsx, until then. Forks this page deleted: the page-level AskBar pill (the shared ask bar in components/Ask.jsx carries the ask), the self-advancing 3D layer zoom and its spring physics, the looping hero pulse, the rack's dark chassis. Conflict noted (MASTER §0.6): §4.2 says "no signature"; James's motion map (7 Nov) overrides it with decode, used once on the controls' names and mechanism terms as the six layers check themselves on arrival, then rest.

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
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; prices from lib/plans.js
  • Open copy questions for James listed, none decided

Done here: One ask, Hanzo's "Talk to Security Team" (/contact), solid in the hero and again in the closing band; "Security Documentation", "The controls, and how to check them" and "Schedule Security Review" are text links. lib/cta.js has no System entry for /security yet, so the label is the page's own (no prices on this page).

2. Information architecture and navigation

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

Done here: One <main> after the layout's #main skip target; links use A/More (the mailto is a plain <a>); parity links 6/6.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero; 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
  • Card-to-page links use Morph; title lands within 12px n/a: no cards lead to pages here

Done here: The h1 (52px, line-mask cut-in), caption, lede, ask and the honest status row fit the first screen; the six-layer map starts its one-time check pass at 0.4 s. PageHero is not merged yet, so the hero is built from the kit (MaskLines). The shared <NoJs> rule (no <noscript>, so no hydration badge) stacks every control with JS off; checked headless with JavaScript disabled, no text is invisible.

4. Conversion system

  • <Cta> only; no raw .x-btn
  • Sticky ask in header and bar after the hero, same label
  • Copy button copies exactly the displayed text; failure never says Copied n/a: the only copy is the kit's Copy of [email protected], which copies the displayed address
  • data-cta and data-thumb on every primary

Done here: Both asks are the kit <Cta> (security.hero with thumb, security.band). On desktop the shared header takes the hero's label ("Talk to Security Team", checked at 1470); on phones the shared header still reads "Try Hanzo" — that is the shared header's choice, not this page's file.

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 status is Hanzo's sentence only ("Continual internal audits, with the report on request."); no seal, mark or uptime. The only numerals are the controls' own "01 / 06" counts and "U1–U4" rack labels.

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
  • python3 scripts/parity.py /security: 0 missing

Done here: Parity text 60/60, links 6/6. The controls are an APG tablist (arrow keys, roving tabindex) with every panel in the HTML; the eight Enterprise items sit in the kit's DetailSheet.

7. Visual design system

  • python3 scripts/taste.py <files> passes; no literal hex outside tokens
  • 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 on both files; only deck values (#0a0a0a, #525252, #737373, #f5f5f5, #ededed, #e4e4e7, #a3a3a3, #000, white steps), radii 6/12/16/20/24, no shadows on tiles. tokens.css does not exist yet, so the deck hexes are page variables on .xsc. Captions ("Security Architecture", "Infrastructure", "Enterprise") sit under their headings. Rhythm via ProofRhythm.css (pf-r): h1 52, headings 26, figures 64, one 84px moment (the closing line).

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading
  • Focus ring visible on every stop of a Tab crawl
  • Dialogs are native, trap focus and return it
  • Inputs 16px or larger; no bare :hover n/a: no inputs; every hover sits inside @media (hover:hover)
  • Forks this page deleted: listed below

Done here: Tabs, map labels, worksheet toggles, rack rows and the email answer hover with a transform, press at scale .97 in 90 ms, focus with a 2px ink ring (white in the black room). The sheet is a native <dialog> opened with showModal() (page-local security/Sheet.jsx): focus trapped, Esc and the scrim close it, focus returns to the button (checked headless: activeElement pf-plus after Esc, scroll position unchanged on open). Deleted: the page-level AskBar and the auto-advancing zoom.

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 is not merged; the page plays none

Done here: Signature decode (MOTION-MAP, components/pages/security/Decode.jsx), used on the controls' names and mechanism terms only, never on headings: in the hero the six names wait as still scrambles and each resolves out of scrambled letters (480 ms, left to right with jitter, a new glyph every ~45 ms, case and digits kept) as the status pass checks its layer; in "The controls, named" the chosen layer's name and its terms (HKDF-SHA256, TLS 1.3, ML-KEM-768, Hanzo Base; HMAC signature / refused; organization → workspace → project …) resolve each time it is chosen (560 ms); a fine pointer over a hero row or a term scrambles it again and lets it resolve. The real words stay in place under the scramble (aria-hidden overlay, one line kept on one line), so nothing reflows: CLS while scrolling 0.0008 at 1470, 0 at 375 and 320. Supporting: line-mask cut-in on the h1 and the closing line only (the two other headings that cut in are now plain), the one-time status pass (300 ms steps), the gliding layer pill and plate crossfade (300 ms ease-emphasis, no springs); the black room's entry is the only scroll-linked move. variety.py OK. Reduced motion shows all six checked and every word plain at once (0 console errors at 1470 and 375); JS off shows the words (42 of 42 visible). Headless Chrome reports (hover: none), so the film lists hover-gated controls as dead; with --blink-settings=primaryHoverType=2 every control answered (map labels, tabs, rack rows, worksheet toggle, email).

10. Media

  • Film and Pic only; sizes and posters set
  • At most 2 videos playing; pause button on loops over 5 s n/a: no video
  • Budgets met; nothing missing; alt on every image
  • No dimmed or filtered photo; 4+ real visuals together where the page has them

Done here: One Hanzo image (koma.webp) on the organization's-file layer, with width and height and alt="" (decorative). Pic is not merged yet, so it is a sized <img>. Only a gradient sits under the plate's text.

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: Headless probe after the sheet fix: scrollWidth equals the viewport at 1470, 375 and 320; the closed sheet is a native <dialog> and draws nothing at rest. On phones the six-layer stack now sits inside the first 812px under the ask, the controls are a snap rail of 48px pills above the lifted-layer stack; the ask sits at about y 430 at 375.

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured, text at 4.5:1 or better
  • Pause control on every moving item n/a: nothing moves for more than 2 s (the status pass ends at rest)
  • 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: Text is #0a0a0a or #525252 on white and #f5f5f5, #fafafa or white 78% on black. Tablist with arrow keys; inactive panels inert; the worksheet count is aria-live; a hero layer label moves focus to its tab.

13. Performance and engineering

  • h1 and LCP element in server HTML
  • JS and CSS inside budget; every image and video sized
  • No poller; no third-party request before consent
  • Nothing heavy run on James's laptop

Done here: Transform, opacity and clip-path only; timers stop at rest (the status pass runs once). Filming ran in the cloud session.

14. SEO and machine files

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

Done here: app/security/page.jsx keeps the metadata and <JsonLd route="/security" /> unchanged.

15. Catalogue and product pages

  • Model card matches SPEC.md n/a: not a catalogue or model page
  • Every card opens by Morph n/a
  • Every maker and model page linked in the DOM n/a
  • One price figure everywhere n/a

Done here: n/a: /security is a System page with no cards, models or prices.

16. Developer experience

  • One CodeBlock; copy equals display n/a: no code on the page
  • Config blocks parse on their own n/a
  • Terminal pauses and ends on a static frame n/a
  • No hand-typed version number n/a

Done here: n/a: no code blocks; the security documentation link is kept.

17. States and resilience

  • Loading, empty, error and offline states designed
  • 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

Done here: Static Hanzo copy with no live fetch, so nothing loads or fails; the worksheet survives reloads (localStorage in try/catch) and works without storage. JS off and reduced motion each show the final state.

18. Measurement and handover

  • data-cta on every primary; events only through lib/track.js
  • Nothing identifier-bearing before consent; no field value in a payload
  • V2: <score>/10 <one line> in the page file's top comment
  • Slice D entrances (MOTION-MAP row, page-local security/enter.js + enter.css, in page order): shutter on the hero's six layers (two grey bars grow from the edges, meet, open on the stack; CSS from first paint), depth-parallax on the controls (list near, stack far, ±28/48px meeting at mid-screen), squash-land on the rack (individual translate/scale, so its power-on grow is untouched), scroll-tilt on the place switcher (arrives tilted 48° and levels; afterwards leans up to 7° with scroll speed, measured ~3-4° on a fast wheel, back to 0 at rest), slot-roll on "Ask us the hard question" (each line rolls down its reel, the reel faces exist only while it rolls). Scroll-linked: depth and tilt only, against decode, the status pass, the rack, the switcher, the tabs and the sheet. Probe after a slow scroll at 1470 and 375: all fired and ended visible; reduced motion 0 errors.
  • Review read: docs/build-notes/review/security.md (7/10); marked Ready in slice D, 7 Nov, after re-checking every fix: tab 06 keeps the Koma plate dark and lifted above the stack, the band ask presses to .98, the three place labels sit on one line at 375, the audit link aligns with its text, and the hero h1 now cuts in on CSS from first paint (no hydration wait).

Done here: data-cta="security.hero" and "security.band"; the page fires nothing itself. V2 line present. docs/build-notes/review/security.md read (7/10 on the walk before this build); its fixes are in: the chosen plate now rises above the stack on every tab (z-index), the rack grows to its moment as its units power on, the place stack moves at full size on desktop, the band ask presses to .98, the phone place labels stay on one line, and reduced motion no longer mismatches on hydration (page-local proof/MaskLines and proof/SceneWipe).