docs(ui): capture Crew token and series coverage

[zacjones93]

Summary

• verify the five remaining Crew public-token, volunteer-signup, and series-pool routes at desktop and mobile widths
• add 10 exact-revision browser captures with accessibility, DOM/overflow, console, network, and screenshot evidence
• update the page-coverage plan and generated ledgers from 178 to 188 verified scenarios
• document reusable presentation candidates while keeping token, consent, signup, and series behavior route-owned

Evidence

Captured from exact base revision b241ddfc4c3a023669c1604147e3bda3ce8343a5 with agent-browser 0.26.0 against a fresh isolated local MySQL fixture:

• /e/:slug/confirm/:token
• /e/:slug/consent/:token
• /e/:slug/schedule/:token
• /e/:slug/volunteer
• /series/:groupId/crew

Each route has desktop 1440×900 and mobile 390×844 light evidence. All 10 scenarios matched their requested URL, viewport, and theme; had no page or console errors, no network responses at or above 400, and no horizontal overflow.

The recapture verifies the accessibility fixes in the preceding stack slice: distinct primary and series navigation landmarks, an h1 on volunteer signup, and assignment/event dates that align in the configured local timezone.

The isolated series fixture contains 18 unique Crew demo volunteers. Text artifacts scrub the deterministic fixture token and synthetic emails; no cookies, headers, session values, form values, database URLs, local paths, query values, or production credentials are serialized.

Validation

• pnpm check:page-coverage
• lat check
• manifest artifact hash, capture-reference, and orphan validation through the coverage checker
• privacy scan across the evidence directory; only the manifest retains the deterministic repository-owned fixture path required for route provenance
• visual review of all representative desktop/mobile screenshots, including a clean recapture after detecting a transient Chromium screenshot artifact
• focused Crew accessibility and fixture tests: 4/4 passing
• GitNexus exact-worktree change detection: low risk, 0 affected execution processes

Coverage after this slice: 350 total / 188 verified / 26 blocked / 136 pending.

Stacked on #639.

• main
  • feat(ui): consolidate Storybook and shared UI library #615
    • feat(ui): add shared package foundation #616
      • feat(ui): extract shared form and overlay primitives #617
        • Fix semantic contrast and Storybook Canvas themes #618
          • UI library: add exhaustive page coverage contract #619
            • UI Library Stack 06 — Public Entry Browser Evidence #620
              • Fix dark button hover contrast #621
                • Extract shared feedback and navigation primitives #622
                  • UI Library Stack 08 — Docs and Auxiliary App Evidence #623
                  • feat(ui): add auth entry composition #624
                  • docs(ui): capture protected athlete coverage #625
                  • fix(settings): render profile email outside form field #626
                  • fix(settings): render athlete stats outside form fields #627
                  • fix(series): render movement collection heading #628
                  • feat(ui): add field composition primitives #629
                  • docs(ui): capture Crew organizer coverage #630
                  • refactor(settings): adopt shared field composition #631
                  • fix(crew): contain mobile route layouts #632
                  • fix(judges): compose rotation collection field group #633
                  • docs(ui): capture Crew admin coverage #634
                  • fix(scaling): compose levels field groups #635
                  • fix(registration): compose option field groups #636
                  • feat(ui): add empty state composition #637
                  • fix(crew): align token route accessibility #639
                  • docs(ui): capture Crew token and series coverage 👈
                  • fix(start): correct organizer panel semantics #640
                  • refactor(ui): adapt organizer empty states #641
                  • fix(start): stabilize admin sidebar hydration #642
                  • fix(start): add admin dashboard heading hierarchy #643
                  • fix(start): correct demo competition semantics #644
                  • docs(ui): capture Start admin coverage #645
                  • refactor(ui): compose organizer empty states directly #646
                  • feat(ui): add metric composition #647
                  • refactor(crew): adopt shared Metric summaries #648
                  • refactor(ui): compose Crew preview metrics #649

[coderabbitai]

Walkthrough

The PR adds deterministic browser evidence for five Crew route groups across desktop and mobile light scenarios, records the captures in a hashed manifest, documents the audit, and promotes matching coverage-plan and ledger entries to verified route-specific coverage.

Changes

Crew evidence audit

Layer / File(s)	Summary
Audit scope and evidence contract docs/ui-library/crew-token-series-coverage-audit.md, lat.md/ui-library.md	Documents the ten-route audit, capture provenance, evidence handling rules, observed behavior, reusable patterns, and coverage results.
Capture manifest docs/ui-library/evidence/crew-token-series/2026-07-10/capture-manifest.json	Defines ten hashed desktop/mobile captures for confirm, consent, schedule, signup, and series organizer scenarios.
Volunteer token and signup fixtures docs/ui-library/evidence/crew-token-series/2026-07-10/{confirm,consent,schedule,signup}-*	Adds accessibility, DOM, console, and successful network evidence for volunteer token workflows and anonymous signup.
Series organizer fixtures docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-*	Adds desktop and mobile evidence for the authenticated series crew pool view.
Coverage promotions docs/ui-library/page-coverage.plan.json, docs/ui-library/page-coverage-ledger.json, docs/ui-library/page-coverage-ledger.md	Replaces unassessed placeholders with verified route-specific scenarios and updates coverage rollups and tables.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Poem

I’m a rabbit with snapshots tucked neat,
Ten little routes made evidence complete.
Tokens and crews hop through the light,
Hashes keep every capture right.
The coverage ledger now blooms bright.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: capturing Crew token and series coverage evidence in the UI docs.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/ui-crew-token-series-coverage

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[zacjones93]

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

Actionable comments posted: 8

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/ui-library/crew-token-series-coverage-audit.md`:
- Line 15: Clarify the observation date in the audit document’s introductory
capture statement by specifying its timezone; since the manifest timestamps are
UTC on 2026-07-11, either label 2026-07-10 with its intended timezone or update
the date to 2026-07-11 UTC.

In
`@docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-desktop-light.network.json`:
- Around line 1095-1099: The network artifact inconsistently classifies
/src/styles.css as JavaScript. Update the recorder or normalizer responsible for
generating the artifact to preserve its stylesheet resource type and correct
MIME type, or remove the stale duplicate entry; verify all occurrences are
consistent before using the artifact.

In
`@docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-mobile-light.a11y.txt`:
- Around line 61-75: The fixture’s assignment date conflicts with the event
window: the schedule in the accessibility snapshot starts on July 10, while
“Event dates” begins July 11. Update the relevant volunteer-token fixture or
accessibility capture so the dates align, or explicitly label the assignment as
pre-event judging if that timing is intentional.

In
`@docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-desktop-light.a11y.txt`:
- Around line 5-8: The navigation landmarks in the rendered UI are unlabeled,
preventing users from distinguishing global and series navigation. Add distinct
accessible names, such as “Primary navigation” and “Series navigation,” to the
corresponding navigation elements, then recapture the affected accessibility
evidence snapshots.

In
`@docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-desktop-light.dom.json`:
- Around line 112-118: The checkbox represented in the captured evidence has no
accessible name because both its name and label are empty. Locate the route UI
that renders this checkbox, add a meaningful visible label or programmatic label
association, then regenerate the corresponding evidence so the updated DOM
includes the accessible name.

In
`@docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-desktop-light.a11y.txt`:
- Around line 12-15: Expose “Volunteer for E2E Crew Demo Throwdown” as an
accessible h1 heading instead of generic text. Locate the page component
rendering this route title and replace or wrap its title element with a semantic
h1, ensuring the rendered accessibility tree reports one heading while
preserving the existing visible text.

In
`@docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-desktop-light.network.json`:
- Around line 1-1808: The evidence only captures the initial render and does not
demonstrate volunteer signup behavior. Update the network fixture associated
with the volunteer signup flow to include the form submission request and its
resulting success or error response, using the volunteer signup interaction
covered by VolunteerSignupForm; alternatively, relabel the artifact as
initial-render coverage and remove any claim that it validates signup.

In `@lat.md/ui-library.md`:
- Line 405: Replace the Markdown link in the cross-reference sentence with the
repository’s required wiki-link syntax, preserving the existing target document
and link text.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 5623f000-6cf2-4317-bc02-697e1a86ce3b

📥 Commits

Reviewing files that changed from the base of the PR and between 961d818 and fa99cdd.

⛔ Files ignored due to path filters (10)

• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-desktop-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-mobile-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-desktop-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-mobile-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-desktop-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-mobile-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-desktop-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-mobile-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-desktop-light.png is excluded by !**/*.png
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-mobile-light.png is excluded by !**/*.png

📒 Files selected for processing (46)

• docs/ui-library/crew-token-series-coverage-audit.md
• docs/ui-library/evidence/crew-token-series/2026-07-10/capture-manifest.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-desktop-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-desktop-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-desktop-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-desktop-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-mobile-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-mobile-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-mobile-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/confirm-volunteer-volunteer-token-mobile-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-desktop-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-desktop-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-desktop-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-desktop-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-mobile-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-mobile-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-mobile-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/consent-volunteer-volunteer-token-mobile-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-desktop-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-desktop-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-desktop-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-desktop-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-mobile-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-mobile-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-mobile-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/schedule-volunteer-volunteer-token-mobile-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-desktop-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-desktop-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-desktop-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-desktop-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-mobile-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-mobile-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-mobile-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/series-crew-organizer-mobile-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-desktop-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-desktop-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-desktop-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-desktop-light.network.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-mobile-light.a11y.txt
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-mobile-light.console.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-mobile-light.dom.json
• docs/ui-library/evidence/crew-token-series/2026-07-10/signup-volunteer-anonymous-mobile-light.network.json
• docs/ui-library/page-coverage-ledger.json
• docs/ui-library/page-coverage-ledger.md
• docs/ui-library/page-coverage.plan.json
• lat.md/ui-library.md

[zacjones93]

LGTM — no findings in the docs/evidence-only review of exact base 961d818f216c078aeaa7abd20e76ad006f8fa099 through exact head fa99cdd64aa8f05320af98ca4a4ddbf0d1974ce8.

Verified:

• linear one-commit diff; all 56 changed paths are under docs/ui-library/ or lat.md/ui-library.md
• 10 manifest captures and 50 unique hash-pinned artifacts; every artifact SHA-256 and every plan capture-manifest reference matches; all captures name deployment revision 961d818f216c078aeaa7abd20e76ad006f8fa099
• all 10 plan/manifest route, scenario, requested/final URL, viewport (1440×900 or 390×844), and light-theme combinations match
• scenario totals reconcile to 350 total / 188 verified / 26 blocked / 136 pending
• privacy scan: the deterministic repo-owned fixture token occurs only in the six manifest requested/final URL fields that require it; text artifacts scrub it and synthetic emails; no cookie/header/session/form values, DB URLs, local filesystem paths, authorization/password fields, or network query values are serialized
• zero console errors, zero network statuses >=400, the audit records zero uncaught page errors, all 10 DOM artifacts report zero horizontal overflow, and all 50 physical artifacts are referenced with no orphans
• all five route dispositions are route-specific; the audit's library-candidate/shared/app-owned pattern boundaries are consistent with the evidence
• generated plan/ledger and LAT documentation are current
• visual inspection of all 10 screenshots found no blank, torn, duplicated, or otherwise corrupted rendering

Checks passed:

• pnpm check:page-coverage
• lat check
• git diff --check 961d818f216c078aeaa7abd20e76ad006f8fa099..fa99cdd64aa8f05320af98ca4a4ddbf0d1974ce8

[zacjones93]

Follow-up triage after CodeRabbit completed: this supersedes my earlier LGTM. I checked all 8 live comments against exact source/evidence revision 961d818f216c078aeaa7abd20e76ad006f8fa099.

Valid docs/evidence fix in PR #638

1. Clarify the capture-date timezone — valid.
   • All manifest timestamps are 2026-07-11T01:15–01:16Z, which is July 10 in the capture's local MDT timezone.
   • Recommendation: say 2026-07-10 MDT (UTC-06:00) or 2026-07-11 UTC consistently in the audit.

Valid source/fixture defects requiring a separate preceding fix and recapture

2. Assignment date versus event window — valid fixture/timezone defect, not an evidence-text typo.

   • The seed derives competition start_date from now.toISOString().slice(0, 10) but writes shift timestamps from the same instant and renders them in America/Denver.
   • During this capture, UTC was July 11 while Denver was July 10, producing Fri, Jul 10 7:15 PM against event dates 2026-07-11 to 2026-07-12.
   • Recommendation: fix the seed's event-local date derivation (or intentionally schedule/labeled pre-event work) in a preceding source PR, then reseed and recapture affected token evidence.

3. Distinguish the two navigation landmarks on the series page — valid accessibility defect.

   • The series accessibility tree contains two unnamed navigation landmarks.
   • Exact source has unlabeled <nav> elements in the global Crew root and the series route.
   • Recommendation: add stable distinct accessible names in a preceding source PR, then recapture. Because the global nav appears throughout this slice, refresh all affected accessibility/DOM artifacts and hashes.

4. Expose the volunteer signup page title as a heading — valid accessibility defect.

   • The signup accessibility tree has no heading and the DOM summary reports headings: [].
   • Exact source renders the title through CardTitle, whose shared implementation is a <div>.
   • Recommendation: give this route a semantic h1 without globally changing every CardTitle, then recapture both signup viewports.

Invalid / no change

5. /src/styles.css has inconsistent resource types — invalid.

   • Every one of the 10 network logs consistently contains the same two observations: one Stylesheet/text/css request and one Script/text/javascript request.
   • Source imports styles.css?url as a Vite module and then uses the returned URL as a stylesheet link. Privacy normalization intentionally strips query values, so the distinct module and stylesheet URLs collapse to the same recorded path while their browser-observed resource types/MIME types correctly remain distinct. This is neither a stale duplicate nor recorder corruption.

6. Series checkbox lacks an accessible name — invalid false positive.

   • The DOM summary's raw name/label fields are not the computed accessible name.
   • The authoritative accessibility snapshot exposes checkbox "E2E Crew Demo Throwdown 2026-07-11 to 2026-07-12 -18 rostered".
   • Exact source wraps the checkbox and its visible competition text in a <label>.

7. Capture the signup submission interaction — invalid / out of scope.

   • This is visual initial-render page coverage, not behavioral signup-flow evidence.
   • The audit explicitly says the browser navigated directly and did not submit the volunteer form; its claim is that the populated form fields render and remain contained, not that submission succeeds.

8. Replace the LAT Markdown link with a wiki link — invalid.

   • lat check passes.
   • This file already uses the same Markdown-link form for the preceding four external audit documents. Wiki links are used for LAT sections and validated code-symbol references; a repository document outside lat.md/ is intentionally linked as Markdown here.

Recommendation: do not merge this evidence slice as-is. Land the three source/fixture accessibility/date fixes in a preceding PR, recapture/re-hash the affected evidence, then apply the timezone wording fix in #638 and rerun pnpm check:page-coverage, lat check, privacy/orphan validation, and screenshot inspection.

[zacjones93]

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[zacjones93]

LGTM on the force-pushed exact range b241ddfc4c3a023669c1604147e3bda3ce8343a5..8717ec9d70aca1f07bebad48d6e86160b81ffdda. No remaining findings.

Re-review results:

• live PR base/head match the requested SHAs; the range is one linear docs/evidence commit with 56 changed files
• all prior valid findings are resolved in both base source and refreshed evidence:
  • audit says 2026-07-10 MDT (UTC-06:00; July 11 UTC in the manifest)
  • schedule assignment Fri, Jul 10 8:15 PM–9:25 PM is contained by event dates 2026-07-10 to 2026-07-11
  • every capture exposes Primary navigation; series captures also expose distinct Series navigation
  • both signup captures expose Volunteer for E2E Crew Demo Throwdown as level-1 heading
• 10 captures / 50 unique hash-pinned artifacts / 50 physical artifact files; every artifact hash, plan reference, and capture-manifest reference matches
• all 10 captures name exact deployment revision b241ddfc4c3a023669c1604147e3bda3ce8343a5
• all route/scenario/requested+final URL/viewport/theme/DOM combinations match the plan
• totals reconcile to 350 scenarios: 188 verified / 26 blocked / 136 pending
• privacy scan is clean: the deterministic fixture token appears only in the six manifest requested/final URL pairs; text evidence scrubs it and fixture emails; no cookie/header/session/form values, DB URLs, local paths, authorization/password fields, or network query values are serialized
• zero console errors, zero network statuses >=400, audit records zero uncaught page errors, all 10 DOM captures report zero horizontal overflow, and there are no missing/orphan artifacts
• visual review of all 10 desktop/mobile screenshots found no blank, torn, duplicated, or corrupted rendering
• all 8 CodeRabbit threads are now resolved (3 outdated after rewrite, 0 unresolved); the four valid findings are fixed and the four rejected findings remain soundly rejected

Checks passed:

• pnpm check:page-coverage
• lat check
• git diff --check b241ddfc4c3a023669c1604147e3bda3ce8343a5..8717ec9d70aca1f07bebad48d6e86160b81ffdda