Benchmarks Website Version 3#7643
Draft
connortsui20 wants to merge 20 commits intodevelopfrom
Draft
Conversation
Merging this PR will degrade performance by 26.23%
|
| Mode | Benchmark | BASE |
HEAD |
Efficiency | |
|---|---|---|---|---|---|
| ⚡ | Simulation | new_bp_prim_test_between[i16, 32768] |
134.1 µs | 121.5 µs | +10.31% |
| ⚡ | Simulation | new_bp_prim_test_between[i64, 32768] |
236 µs | 176.7 µs | +33.55% |
| ❌ | Simulation | bitwise_not_vortex_buffer_mut[1024] |
307.8 ns | 366.1 ns | -15.93% |
| ❌ | Simulation | bitwise_not_vortex_buffer_mut[128] |
246.1 ns | 333.6 ns | -26.23% |
| ❌ | Simulation | bitwise_not_vortex_buffer_mut[2048] |
371.4 ns | 429.7 ns | -13.57% |
Comparing ct/benchmarks-v3 (f8d6d64) with develop (140eec6)
Footnotes
-
33 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩
1c1bcd1 to
2eb6c73
Compare
Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
…pt (#7638) ## Summary Implements the alpha **emitter** component for `bench.vortex.dev` v3, per [`benchmarks-website/planning/components/emitter.md`](https://github.com/vortex-data/vortex/blob/ct/benchmarks-v3/benchmarks-website/planning/components/emitter.md). **Purely additive** to v2's emission path — the existing `-d gh-json -o ...` form is untouched. ### Rust emitter (`vortex-bench`) - New `vortex-bench/src/v3.rs` module with one record type per `kind` (`query_measurement`, `compression_time`, `compression_size`, `random_access_time`, `vector_search_run`) plus serde-tagged `V3Record` enum. Field shapes match [`02-contracts.md`](https://github.com/vortex-data/vortex/blob/ct/benchmarks-v3/benchmarks-website/planning/02-contracts.md); dataset/variant/scale-factor mapping follows [`benchmark-mapping.md`](https://github.com/vortex-data/vortex/blob/ct/benchmarks-v3/benchmarks-website/planning/benchmark-mapping.md). - Each benchmark binary gains a `--gh-json-v3 <PATH>` flag that writes bare records as JSONL (no envelope), alongside the legacy `--display-format gh-json -o ...` flow: - `compress-bench` — `compression_time` (encode/decode) + `compression_size`. Cross-format ratios are **not** emitted; ratios are computed read-side per `decisions.md`. - `datafusion-bench`, `duckdb-bench`, `lance-bench` — `query_measurement`, with optional memory fields populated when `--track-memory` is on. `QueryMeasurement` and the paired `MemoryMeasurement` collapse into one record (`SqlBenchmarkRunner::v3_records`). - `random-access-bench` — `random_access_time`, with the dataset name plumbed alongside `TimingMeasurement`. - `vector-search-bench` — `vector_search_run`, with `dataset`, `layout`, `threshold`, `iterations` plumbed in (they don't live on `ScanTiming`). - `insta` snapshot tests cover one record per `kind`, scrubbing `commit_sha` and `env_triple`. ### Post-ingest script `scripts/post-ingest.py` (Python 3, stdlib only — `urllib`, `json`, `subprocess`): - reads JSONL of records, - fills the `commit` envelope from `git show` for the SHA passed in, - wraps in `{run_meta, commit, records}` per the contract, - POSTs to `<server>/api/ingest` with `Authorization: Bearer ...` from `INGEST_BEARER_TOKEN`, - exits non-zero on 4xx/5xx. **No retries, no spool, no S3 outbox** — deferred per the alpha plan. ### Out of scope (deferred) CI workflow integration, dual-write, `bench-orchestrator` updates, retry/spool/outbox, replacing the v2 CLI form. All listed in [`deferred.md`](https://github.com/vortex-data/vortex/blob/ct/benchmarks-v3/benchmarks-website/planning/deferred.md). ## Test plan - [x] `cargo test -p vortex-bench --lib` — 48 passed (7 new `v3` tests, one snapshot per kind plus a JSONL round-trip). - [x] `cargo build -p vortex-bench -p compress-bench -p datafusion-bench -p duckdb-bench -p lance-bench -p random-access-bench -p vector-search-bench` — all clean. - [x] `cargo clippy --all-targets` on changed crates (skipping `duckdb-bench`, blocked by an unrelated pre-existing `cognitive_complexity` lint in `vortex-duckdb` on `ct/benchmarks-v3`). - [x] `cargo +nightly fmt --all`. - [x] End-to-end smoke: `scripts/post-ingest.py` against a Python `http.server` mock — 200 → exit 0 with `{"inserted":1,"updated":0}`; 400 → exit 1 with the server body on stderr. - [ ] Real round-trip against an actual alpha server — blocked on the server component landing (acceptance criterion 3 in the emitter plan; verifiable once the server PR exists). https://claude.ai/code/session_017qh4ju4FtkizW6s67JEhPW --- _Generated by [Claude Code](https://claude.ai/code/session_017qh4ju4FtkizW6s67JEhPW)_ --------- Signed-off-by: Claude <noreply@anthropic.com> Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
…7637) ## Summary Implements the alpha server for `bench.vortex.dev` v3 per [`benchmarks-website/planning/components/server.md`](../tree/ct/benchmarks-v3/benchmarks-website/planning/components/server.md). A single Rust binary that owns a DuckDB file on local disk, accepts authenticated `/api/ingest` POSTs, and serves a small read API plus a placeholder HTML route the web-ui PR will replace. - **Schema** (`src/schema.rs`): `commits` dim + the five fact tables from `01-schema.md`. DDL is applied on boot; no migration framework at alpha. - **Ingest** (`src/ingest.rs`): bearer-auth middleware, all-or-nothing transactions, idempotent upsert via per-table xxhash64 `measurement_id`, full HTTP matrix from `02-contracts.md` (200 / 400 / 401 / 409 / 500). - **Read API** (`src/api.rs`): `/api/groups`, `/api/chart/:slug`, `/health`. Slugs are opaque base64url-encoded JSON (`src/slug.rs`) so the web-ui treats them as strings per the contract. - **Records** (`src/records.rs`): per-`kind` discriminated union with `deny_unknown_fields`, so unknown `kind`s and unknown fields fail loudly. - **HTML** (`src/html.rs`): placeholder root route - replaced by web-ui. ## Stack Pinned in `benchmarks-website/server/Cargo.toml`: - `axum = "=0.7.9"` (`http1`, `json`, `tokio`, `query`) - `maud = "=0.26.0"` with `axum` - `duckdb = "=1.4.1"` with `bundled` - `tower-http = "=0.6.8"` for tracing - `subtle = "=2.6.1"` for constant-time bearer compare - `twox-hash = "=2.1.0"` for the `measurement_id` xxhash64 - workspace `anyhow` + `thiserror` for errors The crate is a leaf binary outside the `vortex-*` public-API surface, so `./scripts/public-api.sh` is intentionally skipped per the task brief. ## Routes | Method | Path | Auth | |---|---|---| | `POST` | `/api/ingest` | bearer | | `GET` | `/api/groups` | none | | `GET` | `/api/chart/:slug` | none | | `GET` | `/health` | none | | `GET` | `/` | none (placeholder, web-ui replaces) | ## Test plan - [x] `cargo build -p vortex-bench-server` - [x] `cargo test -p vortex-bench-server` - 14 tests pass (4 unit + 10 integration) - [x] `cargo clippy -p vortex-bench-server --all-targets -- -D warnings` - [x] `cargo fmt -p vortex-bench-server` - [x] Manual `cargo run` smoke: `/health`, `POST /api/ingest` (with and without bearer), `/api/groups`, `/api/chart/:slug` round-trip. Acceptance criteria from `components/server.md`: - [x] `cargo build` succeeds for the server crate. - [x] Integration test: POST with valid bearer → 200; re-POST → 200 with `updated > 0, inserted = 0`; no/wrong bearer → 401; unknown `kind` → 400. - [x] `GET /health` returns coherent shape after an ingest (db_path, schema_version, latest_commit_timestamp, per-table row counts). - [x] `cargo run` against a fresh DuckDB file serves both read routes. ## Coordination The skeleton commit (`3266b87`) was pushed before the integration test commit so the web-ui agent can rebase onto the workspace member without waiting for tests. Branch: `claude/benchmarks-v3-server` → `ct/benchmarks-v3` (not develop, not main). --- _Generated by [Claude Code](https://claude.ai/code/session_01MPMnGUzXCUQvdkwbhSU9HR)_ --------- Signed-off-by: Claude <noreply@anthropic.com> Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
Adds --gh-json-v3 plumbing through vx-bench and post-ingest steps in bench.yml, sql-benchmarks.yml, plus a v3-commit-metadata workflow. All v3 ingest is gated on vars.V3_INGEST_URL and continue-on-error, so it's a clean no-op until the deploy track sets the variable. v2's cat-s3.sh path is unchanged. Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
## Summary Implements the alpha web UI for `bench.vortex.dev` v3 per [`benchmarks-website/planning/components/web-ui.md`](../tree/claude/vortex-benchmarks-ui-v3-QxRCK/benchmarks-website/planning/components/web-ui.md). Replaces the placeholder `html.rs` router introduced in #7637 with two real pages backed by Maud templates and a vendored Chart.js bundle. - `GET /` — landing page that lists every group + chart link from `/api/groups`, rendered via `maud`. - `GET /chart/{slug}` — single Chart.js line chart. Payload is fetched server-side via the same `api::collect_chart` helper used by `/api/chart/:slug`, then embedded inline as a JSON `<script id="chart-data">` block. No client-side round-trip after page load. - `GET /static/...` — vendored `chart.umd.js` (Chart.js 4.4.4, MIT), `chart-init.js`, and `style.css`. All bundled into the binary via `include_bytes!`. Slugs are treated as opaque per [`02-contracts.md`](../tree/claude/vortex-benchmarks-ui-v3-QxRCK/benchmarks-website/planning/02-contracts.md): the chart handler echoes whatever `/api/groups` returned straight into `ChartKey::from_slug` without parsing or constructing them itself. `api::collect_groups` and `api::collect_chart` are now `pub(crate)` so the HTML handlers reuse the same row collectors that back the JSON read routes — no second SQL implementation. The chart-init script and the embedded JSON payload between them satisfy the "no network round-trip after page load" criterion. Inside the JSON `<script>` block, `</`, `<!--`, and `<script` are escaped via JSON-safe string escapes so that benign payload contents can never break out of the script element. ## Tests `tests/web_ui.rs` (new, 6 tests): - `landing_page_snapshot` — `insta` snapshot of `GET /` after seeding three envelopes with distinct `commit.sha` / `commit.timestamp` values. - `chart_page_snapshot` — `insta` snapshot of the rendered tpch-Q1 chart page; exercises multi-series rendering (`datafusion:vortex-file-compressed` + `duckdb:parquet`) and verifies both the inline `<script id="chart-data">` block and the `/static/chart.umd.js` reference. - `chart_page_round_trips_every_slug` — every slug returned by `/api/groups` resolves to a 200 chart page with inline data. - `unknown_slug_renders_404` — bogus slug → 404 HTML page. - `empty_landing_page_renders` — empty DB → "No data ingested yet." - `static_assets_are_served` — content-type checks for the three `/static/*` files. Pre-existing `tests/ingest.rs` still passes (10 tests). ## Stack inheritance Inherits the version pins set by #7637 in `benchmarks-website/server/Cargo.toml`. The only Cargo change is `insta = { workspace = true }` under `[dev-dependencies]`. ## Verified locally - `cargo build -p vortex-bench-server` - `cargo test -p vortex-bench-server` — 10 ingest + 6 web-ui tests pass. - `cargo +nightly fmt -p vortex-bench-server -- --check` — clean. - `cargo clippy -p vortex-bench-server --all-targets` — clean. - End-to-end smoke test against a running server: `INGEST_BEARER_TOKEN=test` + `cargo run`, POST two envelopes with different commit shas, verified `/`, `/chart/{slug}`, the three `/static/*` routes, and the invalid-slug 404 path with `curl`. ## Test plan - [ ] Reviewer runs `cargo test -p vortex-bench-server` locally. - [ ] Reviewer starts the server (`INGEST_BEARER_TOKEN=test cargo run -p vortex-bench-server`), POSTs `benchmarks-website/server/fixtures/envelope.json`, and visits `http://127.0.0.1:3000/` in a real browser to confirm the chart hydrates (this PR was developed in a headless sandbox so visual verification was not possible here). - [ ] CI green. ## Out of scope (deferred per `web-ui.md` + `deferred.md`) Per-commit page, filter UI, full-screen modal, deep links, LTTB downsampling, lookup-table-driven engine names / colours, chartjs-plugin-zoom, ratio rendering on compression-size charts, and geomean summary cards are explicitly deferred and not touched here. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- _Generated by [Claude Code](https://claude.ai/code/session_01UjgnLq5MCmcpyv6PXC5oLv)_ --------- Signed-off-by: Claude <noreply@anthropic.com> Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
… hash (#7642) Without commit_sha in the hash input, every (dim tuple) collapses to one row across commits via INSERT ... ON CONFLICT DO UPDATE, so the chart pages render at most one point per series. Adding commit_sha to the per-table hashers makes each (commit, dim) pair its own row, which is the time series the UI is built around. Re-emission of the same (commit, dim) is still the upsert case. The web-ui chart_page_query snapshot now correctly shows three commits with three points per series, matching the test fixture. No public API change; measurement_id is server-internal. <!-- Thank you for submitting a pull request! We appreciate your time and effort. Please make sure to provide enough information so that we can review your pull request. The Summary and Testing sections below contain guidance on what to include. --> ## Summary <!-- If this PR is related to a tracked effort, please link to the relevant issue here (e.g., `Closes: #123`). Otherwise, feel free to ignore / delete this. In this section, please: 1. Explain the rationale for this change. 2. Summarize the changes included in this PR. A general rule of thumb is that larger PRs should have larger summaries. If there are a lot of changes, please help us review the code by explaining what was changed and why. If there is an issue or discussion attached, there is no need to duplicate all the details, but clarity is always preferred over brevity. --> Closes: #000 <!-- ## API Changes Uncomment this section if there are any user-facing changes. Consider whether the change affects users in one of the following ways: 1. Breaks public APIs in some way. 2. Changes the underlying behavior of one of the engine integrations. 3. Should some documentation be updated to reflect this change? If a public API is changed in a breaking manner, make sure to add the appropriate label. You can run `./scripts/public-api.sh` locally to see if there are any public API changes (and this also runs in our CI). --> ## Testing <!-- Please describe how this change was tested. Here are some common categories for testing in Vortex: 1. Verifying existing behavior is maintained. 2. Verifying new behavior and functionality works correctly. 3. Serialization compatibility (backwards and forwards) should be maintained or explicitly broken. --> Signed-off-by: Claude <noreply@anthropic.com> Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
This PR introduces the deployment infrastructure for vortex-bench-server v3, a new benchmarking server that runs alongside the existing v2 instance. The v3 server provides an ingest endpoint for benchmark results with bearer token authentication and uses DuckDB for data storage. 1. **GitHub Actions workflow** (`publish-bench-server.yml`): New CI pipeline that builds and publishes the vortex-bench-server Docker image to GHCR on changes to the server code, vortex-bench crate, or Cargo.lock. 2. **Dockerfile** (`benchmarks-website/server/Dockerfile`): Multi-stage Docker build that: - Compiles vortex-bench-server in a Rust 1.91 environment - Packages it with DuckDB CLI tools in a minimal Debian image - Targets ARM64 architecture for EC2 deployment 3. **Backup script** (`benchmarks-website/server/scripts/backup.sh`): Daily backup utility that: - Exports the DuckDB database from the running container - Uploads backups to S3 (`vortex-ci-benchmark-results/v3-backups/`) - Manages local disk space by retaining only the latest backup 4. **Docker Compose configuration**: Added vortex-bench-server service that: - Runs on port 3001 (v2 remains on port 80) - Mounts EBS-backed data directory for DuckDB persistence - Loads bearer token from `/etc/vortex-bench/secrets.env` - Integrates with existing watchtower for automatic image updates 5. **EC2 initialization guide** (`ec2-init.txt`): Comprehensive setup documentation covering: - Bearer token secret management - EBS volume preparation - Service startup and health checks - Cron-based backup scheduling - Token rotation procedures The v3 server is designed to run additively alongside v2, allowing for gradual DNS migration and dual-write support from CI. The Docker image build is validated by the GitHub Actions workflow on each push to develop. The backup script can be tested manually on the EC2 host before cron scheduling. Smoke tests are documented in the setup guide (curl against `/health` endpoint on port 3001). https://claude.ai/code/session_019mBcBdF4LhKDXyKwuKRAPV --------- Signed-off-by: Claude <noreply@anthropic.com> Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
This is a one-shot migration binary to take all of the data from `data.json.gz` and bring it into a duckdb database. Simply gathers and aggregates everything into memory and writes data in chunks with arrow arrays. Insert row-by-row took way too long, and the appender API in duckdb does not support `BIGINT[]` for some reason... --------- Signed-off-by: Claude <noreply@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com> Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
Six small fixes left over from the v3 migration alpha. All paths relative to `benchmarks-website/migrate/` unless noted. ## Fixes - **Scale-factor canonicalization** (`src/classifier.rs::bin_compression_size`, `src/migrate.rs::migrate_file_sizes`, helper in `src/v2.rs`): both paths now route the v2 SF string through `canonical_scale_factor`, which parses to `f64` and formats with no trailing zeros. Without this, `"1"` vs `"1.0"` and `"10"` vs `"10.0"` would produce different `dataset_variant` strings and prevent the data.json.gz and file-sizes-*.json.gz rows from sharing a `measurement_id`. - **Summary counter timing** (`src/migrate.rs::run`): per-fact counters used to be set from accumulator length *before* the flush, so a flush failure would print a summary that lied. Refactored into a `flush_all` helper that bumps `summary.<fact>_inserted` from the flushed `RecordBatch::num_rows()` only after each `Appender::append_record_batch` succeeds. - **Empty-string normalization in commits** (`src/commits.rs`, `benchmarks-website/server/src/schema.rs`, `benchmarks-website/server/src/api.rs`): `message`, `author_name`/`email`, `committer_name`/`email` now bind as `Option<String>` and store SQL `NULL` when v2 supplied an empty or whitespace-only string. Schema columns made nullable; server reads use `COALESCE(c.message, '')` so the existing `String` decoder still works. - **Orphan WAL cleanup** (`src/migrate.rs::open_target_db`): the existing code already attempts `remove_if_exists` on the `.wal` regardless of whether the main file was present; pinned the behavior with a regression test that stages an orphan `.wal` (no main file) and asserts the orphan bytes don't survive `open_target_db`. - **Random-access dataset extraction** (`src/classifier.rs::bin_random_access`): 4-part records `random-access/<dataset>/<pattern>/<format>-tokio-local-disk` continue to extract `dataset/pattern` from the raw name. 2-part legacy records carry no dataset and used to render under the placeholder `"random access"`; they're now dropped to keep the v3 dataset column meaningful. - **`migrate_file_sizes` dataset fallback** (`src/migrate.rs::migrate_file_sizes`): when the matrix id stripped from `file-sizes-<id>.json.gz` isn't on the `KNOWN_FILE_SIZES_SUITES` allowlist, the fallback now emits `unknown:<id>` so the UI clearly flags it instead of presenting it as a real dataset. ## Tests Each fix has a focused regression test (`rstest` parametrization where useful): - `tests/classifier.rs::compression_size_scale_factor_canonicalizes` covering `"1"`, `"1.0"`, `"10"`, `"10.0"`, `"0.1"`, whitespace, and `""`. - `tests/classifier.rs::unmapped_records_yield_none` extended with `random_access_2_part_legacy` and `random_access_3_part`. - `migrate::tests::flush_all_does_not_overcount_on_failure` (private unit test that drops `compression_times` to force the second flush to fail and asserts only the queries counter is set). - `tests/end_to_end.rs::summary_counts_match_actual_rows_on_success` (sister invariant for the success path). - `tests/end_to_end.rs::empty_author_email_stored_as_null`. - `tests/end_to_end.rs::open_target_db_removes_orphan_wal`. - `tests/end_to_end.rs::file_sizes_unknown_id_falls_back_to_unknown_prefix` and `file_sizes_known_id_uses_id_directly`. - `tests/end_to_end.rs::compression_size_data_and_file_sizes_merge_with_canonical_sf` (cross-path SF canonicalization end to end). ## Verification - `cargo build -p vortex-bench-migrate` — clean. - `cargo test -p vortex-bench-migrate` — 7 unit + 46 classifier + 12 end-to-end tests all pass. - `cargo test -p vortex-bench-server` — 6 unit + 10 ingest + 6 web_ui tests pass; schema and `COALESCE` changes are server-safe. - `cargo clippy -p vortex-bench-migrate --all-targets` — clean. - `cargo fmt` on changed files (nightly fmt unavailable in this sandbox; ran with stable, which is a no-op for the imports-granularity options the repo's `rustfmt.toml` gates on nightly). - Skipped `./scripts/public-api.sh`: migrate is a leaf binary outside the public-api lockfile set, and the only newly `pub` item is the internal `canonical_scale_factor` helper. Signed-off-by: Claude <noreply@anthropic.com> --- _Generated by [Claude Code](https://claude.ai/code/session_012XyYJRpcGFxmJXdTJuW8Ff)_ --------- Signed-off-by: Claude <noreply@anthropic.com> Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
…7681) ## Summary Brings the v3 benchmarks website to a demo-ready state focused on the historical-comparison use case (Vortex vs other engines on the same commit, HEAD vs N commits ago, latest vs first as % delta). Single process, single binary; SSR `maud` + inline JSON `<script>` + Chart.js — no client-side framework, no build step, no post-load API round-trips. > Branch note: this PR was developed on the harness-assigned branch > `claude/demo-ready-benchmarks-v3-H5ECI` rather than the > `claude/benchmarks-v3-ui-historical-comparison` branch the task > request mentioned, because the session's harness pins the working > branch (`Develop on branch …`, `NEVER push to a different branch > without explicit permission`). ## CI note The `Rust tests (windows-x64)` job is failing on this PR but the **same job is also failing on the merge commit at the tip of `ct/benchmarks-v3`** (PR #7671's run, job id `73229326105`, the commit `8697731` we branched from). The base branch shipped with that failure tolerated, and our diff only touches `benchmarks-website/server/` (no Windows-specific paths, no FFI, no new dependencies on Windows-fragile crates), so this failure is pre-existing and not caused by the PR. CodSpeed flagged two `varbinview_zip` regressions in `vortex-array/` — also untouched by this PR. ## What's new * **Scoped commit window** — `?n=25|50|100|250|all`, default 100, server-side clamp to `[1, 1000]`. SQL splices in a `LIMIT ?` filter and binds the value as a parameter (consistent with the rest of the file's `params!`-style use); the unbounded path is a separate query so the plan stays clean. * **Group page** — `GET /group/{slug}` renders every chart in one group on a single screen. Each card embeds its own `<script id="chart-data-N">` payload + sibling `<canvas data-chart-index="N">`. `IntersectionObserver` defers `Chart` construction until the canvas scrolls into view (mobile-friendly + cheap for 22-chart TPC-H groups). * **Toolbar** — same component on `/chart/{slug}` and `/group/{slug}`. Scope buttons + slider, linear/log Y-axis, absolute / `% of baseline` mode. URL query string is canonical state; subtitle mirrors active state. Slider step is `5` so it can land on every preset value (`25`, `50`, `100`, `250`). * **Rich tooltip** — custom external HTML tooltip with `<short-sha> · YYYY-MM-DD` title; per-series rows render value with friendly unit (ns→µs→ms→s, B→KiB→MiB→GiB) and a coloured `% delta` vs the prior visible commit; footer carries the truncated commit message + a GitHub link. Document-level click closes. * **Legend → URL** — clicking a legend item rewrites `?hidden=engine:format|…` via `history.replaceState` (no back-button hostility). Permalinks reproduce the view. Delimiter is `|` so series names can contain `:` and `,` without escaping. * **Mobile** — `@media (max-width: 768px)`: single-column chart grid, toolbar wraps with ≥ 40 px touch targets, slider expands to fill the row, legend pops to the *top* of the chart so it doesn't push the chart off-screen on a phone. * **Landing search** — client-side filter input above the group list. * **/api/group/{slug}** — JSON sibling to the HTML route, returns every chart in the group with payloads inlined. ## What was *not* picked up from `planning/components/web-ui.md`'s deferred list Done now (moved out of deferred): - mobile redesign basics (single column, ≥ 40 px tap targets, toolbar wrap) - engine + series toggling (legend ↔ URL) - deep-link state (every toolbar control is URL-canonical) - group landing with the start of "filters" (client-side search) Still deferred (intentional): - per-commit drill-down page - ad-hoc SQL page - LTTB downsampling - engine name lookup table + curated colour palettes - summary cards (geomean ratios, rankings) - full-screen modal / zoom-pan - `?mode=delta` (compare-to-main) — parser branch dropped pending data shape work; toolbar surface today is only `abs / rel` ## Repro INGEST_BEARER_TOKEN=$(openssl rand -hex 32) \ VORTEX_BENCH_DB=./bench.duckdb \ cargo run --release -p vortex-bench-server Then open `http://localhost:3000/`, click any group name (now a link to `/group/{slug}`), or any chart inside, and play with the toolbar. Toggle a series in the legend and notice `?hidden=…` appear in the URL. Resize to phone width to confirm single-column layout, sticky toolbar wrapping, and legend-on-top. ## Snapshot diffs Three `.snap` files refreshed by this PR: - `landing_page.snap` — group names now link to `/group/{slug}`, search input added, `data-group-name` for client filter. - `chart_page_query.snap` — toolbar + indexed `<script id="chart-data-0">` + tooltip host element. - `group_page_query.snap` (new) — group page rendered against the fixture DB, `?n=100` pinned for stability. Run `INSTA_UPDATE=always cargo test -p vortex-bench-server` (or `cargo insta accept`) to refresh. ## Test plan - [x] `cargo build -p vortex-bench-server` - [x] `cargo test -p vortex-bench-server` — 41 tests pass (22 unit + 10 ingest + 9 web_ui) - [x] `cargo clippy -p vortex-bench-server --all-targets -- -D warnings` — clean - [x] `cargo +nightly fmt` — no diff - [ ] `./scripts/public-api.sh` — skipped per CLAUDE.md (leaf binary, not in workspace public-api lockfile set) - [ ] Manual screenshots — couldn't capture from the sandbox; the reviewer or follow-up should record landing / single chart with toolbar / group desktop / group mobile / tooltip open / log+rel. ## Follow-up review fixes (commits `7042f0d` … `da668a4`) - `7042f0d` — `LIMIT` value travels as a bound parameter (`LIMIT ?`) via `params_from_iter` instead of being interpolated into SQL. - `9c80bce` — drop the unused `?mode=delta` parser branch in both `UiQuery::mode` and `chart-init.js::parseUrl`. - `d156ab8` — `?hidden=` delimiter is now `|`; new test pins the server/client wire agreement. - `da668a4` — slider `step` lowered to 5 so it can land on every preset (`25/50/100/250`). ## Things explicitly NOT changed - `/api/ingest`, auth, schema, write paths. - DB migration (none added). - Existing routes (no renames). - v2 site at `benchmarks-website/server.js` etc — untouched. - Single-chart page still works; reuses the same `chart-init.js`. https://claude.ai/code/session_015Nc73ihs9TUdx7QzLUZudK --------- Signed-off-by: Claude <claude@anthropic.com> Co-authored-by: Claude <claude@anthropic.com> Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
7106686 to
706df38
Compare
Removes the click-through landing page and the full-page reload that
gated every toolbar interaction in the v3 site.
Landing page (`/`) now renders every chart inline using the same
`chart-card` markup as `/group/{slug}`, with a smaller default commit
window (50, vs 100 on the per-chart routes) so the cold payload stays
cheap. The existing `IntersectionObserver` lazy-construct path means
offscreen charts don't pay the Chart.js cost up front.
Toolbar (Scope / Y / Mode) now updates in place:
- Scope: `fetch('/api/chart/{slug}?n=...)` per card, swap `chart.data`,
`chart.update("none")`. Per-card "loading…" + error overlays.
- Y axis: client-side `chart.options.scales.y.type` swap, no fetch.
- Mode (abs/rel): client-side `buildDatasets` recompute, no fetch
(server already returns absolute values; the rel transform was
already client-side).
URL stays in sync via `history.replaceState` so deep links keep
working, and the existing permalinks (`/chart/{slug}`,
`/group/{slug}`) are untouched for SEO and sharing.
`api::collect_chart` is preserved as a thin wrapper around the new
`api::chart_payload` helper; chart-card markup grows
`data-chart-slug` + `data-permalink` attributes that the toolbar
reads when refetching.
Tests: snapshots refreshed where markup intentionally changed; new
tests cover `GET /api/chart/{slug}` JSON shape + `?n=` narrowing,
plus the landing-page n=50 default.
Signed-off-by: Claude <noreply@anthropic.com>
https://claude.ai/code/session_01NhtGnaLstPEAh7cRJ4qDFt
…psible groups
Replaces the page-level toolbar (which controlled every chart together)
with a per-chart toolbar that the user reported as the main UX
complaint, and switches the scope mechanism from "refetch on change" to
"zoom over a single fetched slice" so the slider is fluid at 60fps.
## Per-chart toolbar
Every `.chart-card` now carries its own compact `.toolbar.toolbar--card`
with Show / Y / Mode controls. There is no page-level toolbar on `/`,
`/chart`, or `/group`. Toolbar buttons are `<button type="button">`
(not `<a>`): they manipulate Chart.js state in place rather than
navigating.
## Zoom-as-scope
Each chart fetches up to 1000 commits once. The "Show" buttons and
slider set `chart.options.scales.x.min/max` to a window of the
fetched slice; no refetch on scope change. The slider fires on
`input` throttled to 16ms (~60fps, matches v2's `ZOOM_THROTTLE_DELAY`)
so dragging is continuous. Drag-pan and drag-rectangle-zoom are wired
through `chartjs-plugin-zoom`; mouse wheel pans horizontally via a
manual canvas listener calling `chart.pan()` because the plugin
doesn't expose pan-on-wheel.
The zoom plugin UMD is bundled locally
(`static/chartjs-plugin-zoom.umd.min.js`, MIT-licensed). hammerjs is
intentionally not bundled — touch gestures are nice-to-have, the
plugin's mouse path works without it (guarded by `if (Hammer)`).
## Tooltip flicker fix + crosshair
The tooltip host is now permanently `pointer-events: none`. The
previous code flipped it to `auto` while visible, which produced a
flicker loop: cursor on tooltip → mouseout on canvas → tooltip hides
→ mousein on canvas → tooltip shows. Cost: tooltip-internal links are
no longer clickable; the chart-card title already links to the
permalink.
The tooltip is offset 12px from the cursor and flips to the left when
within 24px of the right edge. Interaction mode is
`{ mode: "index", intersect: false, axis: "x" }` so hover anywhere
over the chart snaps to the nearest commit. A custom inline plugin
(`afterDatasetsDraw`) draws a 1px dashed `--muted` vertical crosshair
at the active hover index.
## Collapsible groups, v2 ordering
Landing page wraps each group in `<details>` with a `<summary>` that
shows the group name + chart-count badge. Only the first group is
`open` by default; closed groups render only the chart-card shells
(no inline JSON), and `chart-init.js` fetches their payloads via
`/api/chart/{slug}?n=1000` on the first `details.toggle` event.
Group naming was rewritten to match v2's hard-coded list:
- `tpch sf=1 [nvme]` → `TPC-H (NVMe) (SF=1)`
- `tpcds sf=10 [nvme]` → `TPC-DS (NVMe) (SF=10)`
- `clickbench [nvme]` → `Clickbench`
A new `pub const GROUP_ORDER` + `pub fn group_sort_key` in `api.rs`
sort discovered groups into the canonical order; unknown groups sort
last by alphabetical fallback. Option (1) from the task brief — the
rename was a clean change inside `group_name_query` only, no need for
the option-(2) sort-key fallback.
## URL state
URL writeback for per-chart toolbar state was deliberately dropped.
The user's feedback emphasised local-and-immediate UX, not "share a
perfect view via URL"; permalinks (`/chart/{slug}`, `/group/{slug}`)
are the sharing mechanism. `?n=` on the landing route is still
honoured as a power-user override on the initial fetch size.
## Tests
- Snapshots refreshed for all three pages (markup change is large).
- Added: `landing_groups_render_in_v2_order` — fixture covers Random
Access / Compression / Compression Size / TPC-H / vector-search and
the rendered order matches the canonical list.
- Added: `details_first_group_open_others_closed`.
- Added: `chart_card_carries_per_chart_toolbar` (every card).
- Updated `static_assets_are_served` to cover the new
`/static/chartjs-plugin-zoom.umd.min.js` route.
## Out of scope (per task brief)
- Zoom-sync across charts in a group (v2's `zoom-sync.js` pattern) —
follow-up PR.
- LTTB downsampling.
- "Compare to main" delta mode.
- The `collect_group_charts` N+1 in `api.rs`.
- Mobile legend resize handler.
- Replacing the inline crosshair plugin with `chartjs-plugin-crosshair`.
Signed-off-by: Claude <noreply@anthropic.com>
https://claude.ai/code/session_01NhtGnaLstPEAh7cRJ4qDFt
Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
918fea3 to
2d9b05e
Compare
The previous "fix CI lints" commit accidentally clobbered planning/README.md with planning/AGENTS.md content, leaving the two files byte-for-byte identical. Restore README.md to its intended planning content (status, production-readiness checklist, open product decisions, deferred UI follow-ups, components, branch conventions). AGENTS.md is unchanged. Signed-off-by: Claude <noreply@anthropic.com>
Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
- AGENTS.md: bullet 4 now lists all four JSON routes (groups, chart,
group, health), not just chart.
- 02-contracts.md: Read API section adds /api/group/:slug and /health,
drops the "two routes" framing.
- 01-schema.md: relax commits.{message,author_name,author_email,
committer_name,committer_email} to optional, matching schema.rs DDL.
- README.md: remove "/health endpoint" from the not-yet-done list
(it's implemented in api.rs and routed in app.rs), refresh the
line range for the collect_group_charts N+1 reference.
Signed-off-by: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rewrites the benchmarks website (again).
Design
Instead of a single
data.json.gzfile that we CAS from the benchmarks, this is a full server binary that manages a duckdb database and allowsPOST /api/ingestfrom each of the benchmarks via an emitter. The website itself is then SSR with hydration. I believe that this is the design that we actually want the website to be in, as it is much more maintainable and extensible than previous iterations.Mostly llm-engineered but with a lot of manual direction:
include_bytes!into the binary.POST /api/ingestwhich accepts versioned JSON envelopes, bearer-token gated. CI pushes results.<prefix>.<base64url(serde_json(ChartKey|GroupKey))>. Round-trips through the URL with no DB lookup./(landing),/chart/{slug}and/group/{slug}(permalinks). One JSON route:GET /api/chart/{slug}.INGEST_BEARER_TOKENenv var. SSR means no frontend build step; the only client-side JS is the singlechart-init.js.UI/UX (TBD, the new relational database backend gives us a lot more options now so this could be better):
<details>per group, ordered to match v2. The first group opens by default with its chart data inlined for fast first paint; the rest lazy-fetch via the JSON API the first time they're expanded.<script id="chart-data-N">JSON paired with<canvas data-chart-index="N">. AnIntersectionObserveronly constructs the Chart.js instance once the canvas scrolls into view.chart.update("none"). Mouse wheel pans through history.?n=&y=&mode=&hidden=) is honored only on the permalink pages. The landing page always opens at defaults; if you want to share a specific view, share the chart permalink.Still some work to do, will update this design list later.
Testing
Snapshot testing with
instaand seeded by hitting the ingest endpoint that is in-process.