#235 — given column-header tooltips restored + model-badge tooltip styling aligned

[cmbays]

Root cause

The JS binder never regressed — the given-side payload never carried column metadata for non-model given sources. Bisecting the suspects (#201/#217 layout rework, #230, #234) against live DOM probes of the goldens at #166 (cba790f), #230 (f86b68e), and main (65cac5f) shows identical behavior at every commit: the decorateColHeader/#col-tooltip binder fires correctly for any given whose payload carries column_meta. What was broken is the (b) arm — the payload side, since the feature shipped in #165/#166: build_test_payload's given arm resolved only ref()-to-model (via resolve_target_model, which filters resource_type == "model") and this. Two whole classes of given input therefore never received column metadata:

• seed-ref givens — the committed jaffle-shop fixture's ref('raw_customers') is exactly this wire shape; dbt's ref() resolves over the refable set (models, seeds, snapshots)
• source('a','b') givens — the domain SourceNode didn't even ingest the source columns block, although both engines emit it (fusion ManifestSource.columns via serialize_dbt_columns, dbt-schemas manifest/manifest_nodes.rs @ 9977b6cb; verified on the committed playground fixture's synthea_raw.patients.Id description)

The review surfaces for PR #230 happened to consist entirely of such givens (jaffle's seed given; diff-showcase's only changed test, whose given fixture columns are undeclared on the input model) — so every given header was bare while every expected header tooltipped, reading as a one-sided regression.

RED evidence (unmodified main, 65cac5f):

• 2 new render payload tests fail: build_test_payload_attaches_seed_column_meta_for_a_seed_ref_given, build_test_payload_attaches_source_column_meta_for_a_source_given (assertion left == right failed — column_meta empty)
• DOM probe of a main-built report (seed + source + model givens): seed given 0/2 decorated headers, source given 0/2; expected headers decorated. Model tip anatomy: .dt-row/.dt-key ×2, .ct-test/.ct-key/.ct-val ×0
• New headless guards assert exactly these facts and pass only with the fix

Before / after

Surface	Before	After
Seed-ref given header (described + tested column)	no trigger, no tooltip	hover and keyboard focus reveal description + test chips (the #146/#161 contract the th trigger already carries)
source(...) given header	no trigger ever (source columns not even ingested)	source column descriptions + source-attached column tests tooltip; visible in the regenerated playground golden (synthea_raw.patients → Id — "Unique patient identifier (UUID)")
Model-ref given header	worked	unchanged
Model-name badge tip (given gt-model pill + expected badge)	model tests rendered in the shelf card's .dt-row/.dt-key/.dt-val dress — metrics/spacing diverged from the column tooltip	test rows ride the column tooltip's own .ct-tests/.ct-test/.ct-key/.ct-vals/.ct-val anatomy via a shared ctTestHtml builder (no parallel chip system); test names keep the readable-on-dark color-mix(in oklab, var(--accent) 60%, white) accent treatment

Honest degrade

A given column whose source genuinely lacks per-column metadata (undeclared column, metadata-less seed, csv/sql given without declarations) renders no trigger at all — no has-col-meta class, and no empty bubble can open. Pinned by given_header_honest_degrade_metadata_less_given_has_no_triggers plus inline assertions on the undocumented/undescribed columns in the seed/source test. (DataTables still gives orderable headers keyboard focus for sorting — the degrade contract is no-tooltip-affordance, not non-focusability.)

Scope guard (#233)

.col-tooltip rules untouched — the .col-tooltip .ct-key pass-1→pass-2 color fix and the .ct-test gap value remain #233's lane. This PR only adds the model-scoped .model-tooltip .ct-key color-mix override (same specificity, later in file) and retires the now-dead .model-tooltip .mt-mtests/.dt-key/.dt-val rules. The shelf card keeps its light-surface .dt-* chips.

Changes

• src/domain/manifest.rs — SourceNode gains column_descriptions (tolerant #[serde(default)], with_column_descriptions builder — the Node precedent; POD-only, std+serde)
• src/adapters/manifest.rs — WireSource parses the columns map (reusing WireColumn); empty-string unset descriptions dropped (the feature: column-header tooltips on unit-test tables — authored descriptions + column-level data tests #165 rule)
• src/adapters/render.rs — resolve_given_ref_node (givens resolve over model | seed | snapshot, deterministic under leaf-name collision), column_meta_for_source, shared attached_column_tests; build_test_payload given arm wires this → ref → source
• templates/interaction.js — shared ctTestHtml builder (column tooltip markup byte-identical); showModelTip model tests render .ct-tests/.ct-test rows
• templates/report.css — .model-tooltip .ct-key accent override; dead .model-tooltip .mt-mtests/.dt-* rules retired
• tests/headless_toggle.rs — 3 new guards + the feature: design-2 integration PR-5 — rich hover cards: ref()/Expected model pills, format-badge fixture reconstruction, overrides badge, info tips #202 model-tip pin updated to the new anatomy
• Goldens regenerated with the exact CI commands (jaffle-shop, playground, diff-showcase, explore); git diff --text -- examples/ audited — only this lane's engine deltas (the shared CSS/JS blocks + the playground/explore payload gaining the source-given column_meta)
• tests/snapshots/render_integration__rendered_chrome_jaffle_shop.snap rebaselined (embeds the engine CSS/JS blocks)

Guards

• given_header_tooltips_resolve_seed_and_source_metadata — seed + source given headers tooltip on hover AND focus; bubble carries the owner's description + test chips; undeclared columns get no affordance
• given_header_honest_degrade_metadata_less_given_has_no_triggers — zero triggers, no empty bubble
• model_badge_tooltip_rides_column_tooltip_chip_anatomy — .ct-tests/.ct-test rows, .ct-key names, .ct-val chips, computed accent color matches an in-page color-mix reference, zero .dt-*/.mt-mtests remnants
• Render payload: seed attach, source attach, empty-source honest degrade; adapter: source column parsing with empty-description drop; domain: builder + serde round-trip/absence tolerance
• All existing pins kept green: the polish: pass-2 conformance — tooltip edge-flip, expected badges left (Given pattern), tooltip text size #232 edge/size pins, polish: latte suppress-chip 4.37 sub-AA + suppressed-row opacity vs AA (design decision) #227/#206 — Solarized tier-high chip contrast: chip-scoped accent override (3.41 → 5.00) #228 contrast guards, the feature: column-header tooltips on unit-test tables — authored descriptions + column-level data tests #165/feature: design integration PR-2 — engine merge (settings panel, unified/split diffs) + port-forward of post-fork behaviors #178 column tooltip suite, zero-egress

Gates (direct, by exit code)

cargo fmt --check 0 · cargo clippy --all-targets --locked -- -D warnings 0 · cargo nextest run 1228 passed · cargo test --test bdd 160 scenarios / 1032 steps passed · cargo test --test headless_zero_egress --locked -- --ignored 10 passed · cargo test --test headless_toggle --locked -- --ignored 53 passed · RUSTDOCFLAGS="-D warnings" cargo doc --no-deps --locked 0 · cargo deny check ok

Closes #235

🤖 Generated with Claude Code

---

Summary by CodeRabbit

• New Features

  • Source and seed column descriptions now display in tooltips
  • Column tests for seed and source references are now properly surfaced

• Improvements

  • Test styling unified across model and column tooltips for consistent visual presentation

[ghost]

Ready to review this PR? Stage has broken it down into 6 individual chapters for you:

	Title
1	Ingest source column descriptions into domain
2	Resolve column metadata for all given types
3	Unify model and column tooltip anatomy
4	Verify tooltip fixes with headless tests
5	Regenerate example reports with fixes
6	Other changes

_{Chapters generated by Stage for commit 92c4cb6 on Jun 11, 2026 5:57pm UTC.}

[github-actions]

📄 Rendered report preview

All golden examples regenerated cleanly.

🟡 Golden examples

Committed to examples/ and byte-identity gated — the canonical reports contributors and consumers browse. Stable across PRs.

Report	View	Download
playground-report.html	▶ Open ↗	⬇ Download
diff-showcase-report.html	▶ Open ↗	⬇ Download
jaffle-shop-report.html	▶ Open ↗	⬇ Download

🐶 Live dogfood preview

This PR doesn't touch dbt-project/, so there's no live dogfood preview.

▶ Open ↗ opens the report in your browser in one click —
published to this repo's GitHub Pages under /pr-236/.
⬇ Download fetches the same self-contained HTML as a workflow
artifact (auth-gated; works fully offline). Either way the report
makes zero external resource requests.

The Pages preview may take ~1 min to update after this comment
posts. On PRs from forks the Open link is unavailable (read-only
token) — use Download.

Alternative: GitHub CLI

# gh CLI >= 2.63 extracts into ./report-preview-playground/.
gh run download 27366841747 -R breezy-bays-labs/cute-dbt -n report-preview-playground
open report-preview-playground/playground-report.html

---

_{Posted by report-preview.yml for 92c4cb6397787cf77be445e8d208258e3cec0d64. Affordance only — never blocks merge.}

[gemini-code-assist]

Code Review

This pull request implements support for displaying column-header tooltips (descriptions and attached data tests) for seed and source inputs in unit-test given tables (addressing cute-dbt#235). It updates the manifest parser to extract source column descriptions, refactors the test payload builder to resolve column metadata for seeds, snapshots, and sources, and unifies the visual anatomy of model-level tests in tooltips with column-level tests using a shared JS builder. Comprehensive unit and headless integration tests have been added to verify these changes. No review comments were provided, so there is no feedback to address.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

PR #236 fixes given-table column-header tooltip regression (dropped in a prior change) and unifies model-badge tooltip styling with the column tooltip anatomy. It adds source column description support to the domain, extracts descriptions from the dbt manifest, refactors given metadata resolution to handle seeds and sources alongside models, and replaces scattered test-chip rendering with a shared ctTestHtml helper using consistent .ct-* CSS anatomy.

Changes

Feature #235: Given Column Tooltips and Unified Tooltip Styling

Layer / File(s)	Summary
Source column descriptions domain contract src/domain/manifest.rs	SourceNode gains a column_descriptions: BTreeMap<String, String> field with builder (with_column_descriptions) and accessor (column_descriptions()) methods; unit tests verify empty default, builder attachment, and backward-compatible deserialization.
Source column description ingestion from manifest src/adapters/manifest.rs	WireSource deserializes a columns map; into_domain filters each column's description to non-empty strings and passes them to SourceNode via with_column_descriptions; unit test validates extraction and omission of empty/missing descriptions.
Given column metadata resolution for models, seeds, and sources src/adapters/render.rs	Introduces attached_column_tests helper to deterministically collect column-scoped generic tests (reused for both models and sources); adds resolve_given_ref_node to resolve ref('NAME') across full refable set (models, seeds, snapshots) by matching leaf segment and breaking ties via smallest node id; refactors build_test_payload to branch on given type (this/ref/source) and merge descriptions + tests for column metadata; unit tests cover seed-ref and source-given resolution, including honest degrade for metadata-less sources.
Unified test-chip rendering with shared ctTestHtml helper templates/interaction.js, templates/report.css, examples/diff-showcase-report.html, examples/jaffle-shop-report.html	Introduces shared ctTestHtml(t) helper that renders one test row as .ct-test with .ct-key name and .ct-vals chips (from t.values or comma-split t.detail); updates model-ref and column tooltips to use the helper; replaces model-tooltip CSS to override .model-tooltip .ct-key color (accent treatment), removing retired .mt-mtests/.dt-key styling. Applied identically in both template files and example reports.
Headless test coverage for given-side and model-badge tooltips tests/headless_toggle.rs	Adds helpers to render reports with sources and construct seed nodes; comprehensive headless tests verify given-column header tooltips for seed-ref and source givens (presence, content, keyboard focus, honest degrade for metadata-less columns); validates model-badge tooltip anatomy (.ct-tests .ct-test rows, .ct-key/.ct-vals .ct-val content, accent color via computed styles, no legacy .dt-*/.mt-mtests remnants).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

The PR spans domain, adapter, template, and test layers with moderate logic density. The core logic changes (given metadata resolution, manifest ingestion) are straightforward but require understanding the new field threading and reference resolution strategy. The refactoring of test-chip rendering is mostly mechanical duplication removal. The headless tests are comprehensive but repetitive assertions. Low risk of unintended side effects due to structured test coverage.

Possibly related PRs

• breezy-bays-labs/cute-dbt#188: Introduced the client-side tooltip contract update in templates/interaction.js and templates/report.css; this PR (#236) aligns the model-badge tooltip styling to the column tooltip's .ct-* anatomy established in #188.

🐰 Hop, hop! The givens now have tales to tell,
Their column tips shine in a unified spell,
Badges and chips dance in accent-hued grace,
While tooltips degrade with honest-faced space. ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly references issue #235 and clearly summarizes the two main changes: restoring given column-header tooltips and aligning model-badge tooltip styling with column tooltip anatomy.
Linked Issues check	✅ Passed	All four acceptance criteria from #235 are met: given-header tooltips restored with proper styling, model-badge tooltip anatomy aligned to column tooltip, root cause identified (payload missing column metadata for non-model givens), headless guards added, and goldens regenerated.
Out of Scope Changes check	✅ Passed	All changes are tightly scoped to #235: domain/adapter updates for source column descriptions, render layer resolution for seeds/sources, template unification of test rendering via ctTestHtml, and CSS styling fixes. No unrelated modifications detected.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ 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 adapters-235-given-tooltips

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ast-grep (0.43.0)

examples/diff-showcase-report.html

examples/jaffle-shop-report.html

---

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 and usage tips.}