Skip to content

test(viewer): tokens SSOT proptest surface (WBS-6.2 #450) - #456

Closed
KooshaPari wants to merge 1 commit into
mainfrom
fix/viewer-tokens-properties-20260808
Closed

test(viewer): tokens SSOT proptest surface (WBS-6.2 #450)#456
KooshaPari wants to merge 1 commit into
mainfrom
fix/viewer-tokens-properties-20260808

Conversation

@KooshaPari

@KooshaPari KooshaPari commented Aug 9, 2026

Copy link
Copy Markdown
Owner

User description

Summary

Adds crates/sl-viewer/tests/properties_viewer_tokens.rs with 10 proptest properties pinning the tokens module SSOT invariants (WBS-6.2 #450).

lab_coat::* (4 properties)

  • Every hex is a well-formed #RRGGBB (7-char lowercase ASCII hex).
  • Every hex is non-empty.
  • All 16 documented hex constants are pairwise distinct.
  • Every hex appears in TOKENS_CSS.

REQUIRED_CSS_VARS (4 properties)

  • Every entry starts with --.
  • Every entry is non-empty.
  • The set is duplicate-free.
  • Every entry appears in TOKENS_CSS.

VIEWER_COLOR_SCHEME (2 properties)

  • Declares both :root and :root[data-theme="dark"] selectors.
  • Uses color-scheme exactly twice.

Validation

  • cargo test -p sl-viewer --test properties_viewer_tokens --features "desktop parquet" --locked — 10 passed
  • cargo fmt --all --check — clean

WBS / TRACEABILITY

WBS-6.2 evidence list and TRACEABILITY.json gain crates/sl-viewer/tests/properties_viewer_tokens.rs. CHANGELOG Unreleased documents the new surface.


CodeAnt-AI Description

Add property coverage for viewer color-token consistency

What Changed

  • Added 10 property checks covering viewer color values, required CSS variables, and light/dark color-scheme declarations
  • Tests now detect malformed or duplicate colors, missing CSS variables, and mismatches between Rust color definitions and the CSS token source
  • Documented the new token checks in the changelog and WBS traceability records

Impact

✅ Fewer theme token mismatches
✅ Safer light and dark theme updates
✅ Earlier detection of invalid viewer colors

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

Adds crates/sl-viewer/tests/properties_viewer_tokens.rs with 10
proptest properties pinning the design-token SSOT invariants:

* lab_coat::*:
  * Every hex is a well-formed #RRGGBB (7-char lowercase ASCII hex).
  * Every hex is non-empty.
  * All 16 documented hex constants are pairwise distinct.
  * Every hex appears in TOKENS_CSS so the Rust mirror and the
    CSS SSOT stay in sync.
* REQUIRED_CSS_VARS:
  * Every entry starts with --.
  * Every entry is non-empty.
  * The set is duplicate-free.
  * Every entry appears in TOKENS_CSS.
* VIEWER_COLOR_SCHEME:
  * Declares both :root and :root[data-theme dark] selectors.
  * Uses color-scheme exactly twice.

Updates WBS-6.2 evidence list, TRACEABILITY.json, and CHANGELOG.
Copilot AI lite review requested due to automatic review settings August 9, 2026 21:14
@codeant-ai

codeant-ai Bot commented Aug 9, 2026

Copy link
Copy Markdown

🤖 CodeAnt AI — Review Status

Status Commit Started (UTC) Finished (UTC)
✅ Reviewed your PR 11d6caf Aug 09, 2026 · 21:14 21:16

@codeant-ai

codeant-ai Bot commented Aug 9, 2026

Copy link
Copy Markdown

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@coderabbitai

coderabbitai Bot commented Aug 9, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@KooshaPari, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 41 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 9a1937a9-cd73-41c0-bd00-2668753e6c03

📥 Commits

Reviewing files that changed from the base of the PR and between 2041480 and 11d6caf.

📒 Files selected for processing (4)
  • CHANGELOG.md
  • crates/sl-viewer/tests/properties_viewer_tokens.rs
  • docs/ops/TRACEABILITY.json
  • docs/ops/WBS.md

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

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

@codeant-ai codeant-ai Bot added the size:L This PR changes 100-499 lines, ignoring generated files label Aug 9, 2026
Comment on lines +114 to +118
let hex = lab_coat_hex_list()[i];
prop_assert!(
TOKENS_CSS.contains(hex),
"TOKENS_CSS missing lab_coat hex {:?}",
hex,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: This only checks that each hex string occurs somewhere in the entire stylesheet, not that it is assigned to the corresponding token. A token declaration can be changed or removed while the same color remains in another declaration, a comment, or an unrelated selector, and this property will still pass. Validate the expected variable-to-hex assignment on the same declaration line, as the existing unit test does. [api mismatch]

Severity Level: Major ⚠️
- ❌ Rust palette and CSS token assignments can silently diverge.
- ⚠️ Viewer colors can change for affected theme controls.
- ⚠️ `ThemeColors` users can receive mismatched CSS/Rust colors.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** crates/sl-viewer/tests/properties_viewer_tokens.rs
**Line:** 114:118
**Comment:**
	*Api Mismatch: This only checks that each hex string occurs somewhere in the entire stylesheet, not that it is assigned to the corresponding token. A token declaration can be changed or removed while the same color remains in another declaration, a comment, or an unrelated selector, and this property will still pass. Validate the expected variable-to-hex assignment on the same declaration line, as the existing unit test does.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +155 to +159
let var = REQUIRED_CSS_VARS[i];
prop_assert!(
TOKENS_CSS.contains(var),
"TOKENS_CSS missing required CSS var {:?}",
var,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: This accepts a required variable when its name appears only in a comment, a var(...) reference, or another non-declaration context. Consequently, removal of the actual custom-property definition can go undetected even though REQUIRED_CSS_VARS documents variables that must exist. Check for a CSS declaration of the form var: rather than an arbitrary substring. [api mismatch]

Severity Level: Major ⚠️
- ❌ Missing viewer variables can invalidate theme styles.
- ⚠️ CSS fallbacks may alter backgrounds, text, or accents.
- ⚠️ Required-token regression can pass CI unnoticed.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** crates/sl-viewer/tests/properties_viewer_tokens.rs
**Line:** 155:159
**Comment:**
	*Api Mismatch: This accepts a required variable when its name appears only in a comment, a `var(...)` reference, or another non-declaration context. Consequently, removal of the actual custom-property definition can go undetected even though `REQUIRED_CSS_VARS` documents variables that must exist. Check for a CSS declaration of the form `var:` rather than an arbitrary substring.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +172 to +173
prop_assert!(VIEWER_COLOR_SCHEME.contains(":root"));
prop_assert!(VIEWER_COLOR_SCHEME.contains("[data-theme=\"dark\"]"));

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: The two independent substring checks do not require the dark selector to be the exact :root[data-theme="dark"] selector. The fragments could occur in separate or malformed selectors and the property would still pass, allowing the selector consumed by the viewer to be missing. Assert the complete selector string or parse the selector block. [incorrect condition logic]

Severity Level: Major ⚠️
- ❌ Dark-mode selector regressions can escape the token test.
- ⚠️ Viewer dark-theme switching may stop applying color-scheme.
- ⚠️ Browser controls may retain the wrong light/dark styling.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** crates/sl-viewer/tests/properties_viewer_tokens.rs
**Line:** 172:173
**Comment:**
	*Incorrect Condition Logic: The two independent substring checks do not require the dark selector to be the exact `:root[data-theme="dark"]` selector. The fragments could occur in separate or malformed selectors and the property would still pass, allowing the selector consumed by the viewer to be missing. Assert the complete selector string or parse the selector block.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +181 to +184
prop_assert!(VIEWER_COLOR_SCHEME.contains("color-scheme"));
// Both modes must set the property.
let occurrences = VIEWER_COLOR_SCHEME.matches("color-scheme").count();
prop_assert_eq!(occurrences, 2);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: Counting textual occurrences does not prove that light and dark selectors each contain one color-scheme declaration. Occurrences in comments, duplicate declarations within one rule, or two declarations using the same value all satisfy this assertion while one theme mode remains incorrect. Validate the declarations associated with each selector and their expected values. [incorrect condition logic]

Severity Level: Major ⚠️
- ❌ Browser controls can use the wrong theme color scheme.
- ⚠️ Dark-mode scrollbar and form-control styling may regress.
- ⚠️ Viewer theme switching can pass CI with incomplete CSS.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** crates/sl-viewer/tests/properties_viewer_tokens.rs
**Line:** 181:184
**Comment:**
	*Incorrect Condition Logic: Counting textual occurrences does not prove that light and dark selectors each contain one `color-scheme` declaration. Occurrences in comments, duplicate declarations within one rule, or two declarations using the same value all satisfy this assertion while one theme mode remains incorrect. Validate the declarations associated with each selector and their expected values.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

@KooshaPari

Copy link
Copy Markdown
Owner Author

Closing due to merge conflicts.

@KooshaPari KooshaPari closed this Aug 9, 2026
@KooshaPari
KooshaPari deleted the fix/viewer-tokens-properties-20260808 branch August 9, 2026 21:16
/// starting with `#`. Since we can't introspect Rust modules at runtime,
/// we hard-code the list (mirroring `tokens.rs`). The constants are
/// public — any new addition requires also extending this list, which
/// the `proptest` exhaustiveness check below will catch.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WARNING: The lab_coat_hex_list() doc promises an 'exhaustiveness check' that does not exist.

The doc comment (lines 45–50) claims the list is derived via a 'reflection-on-source approach' over every pub const in lab_coat, and that any new constant addition 'will [be] catch[ed] by the proptest exhaustiveness check below.' Neither is true: the list is hand-maintained (no reflection), and none of the 10 properties cross-checks lab_coat_hex_list() against the full set of lab_coat constants. A new lab_coat::* constant added without extending this list would silently escape coverage — precisely the drift this SSOT test surface is meant to prevent.

Suggested fix: either (a) add a property asserting lab_coat_hex_list().len() equals the documented count (16) and that every lab_coat::* value is present, or (b) reword the doc to state the list must be updated manually and the suite does not assert completeness.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

@kilo-code-bot

kilo-code-bot Bot commented Aug 9, 2026

Copy link
Copy Markdown

Code Review Summary

Status: 1 Issue Found | Recommendation: Address before merge

Note: PR #456 is CLOSED (closed by author for merge conflicts). Findings below are advisory against the current diff (HEAD 11d6caf) and should be resolved before reopening.

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
crates/sl-viewer/tests/properties_viewer_tokens.rs 50 lab_coat_hex_list() doc claims a "reflection-on-source approach" and an "exhaustiveness check below will catch" new constants, but no such check exists; a new lab_coat::* constant would silently escape SSOT coverage.
Consider / Notes (click to expand)
  • Redundant proptest usage: lab_coat_hexes_distinct (L103), required_css_vars_unique (L136), viewer_color_scheme_declares_both_selectors (L171), and viewer_color_scheme_declares_color_scheme_property (L180) use an unused _i in 0u8..4 strategy, so proptest re-runs identical assertions 256× with no randomness. These are plain invariants better expressed as #[test].
  • Non-exhaustive random coverage: the indexed strategies 0..16 / 0..17 (L80, L95, L113, L129, L145, L154) give probabilistic, not deterministic, coverage of every array entry per run. For an SSOT invariant suite, a for ... in loop or an exhaustive strategy is more appropriate.
  • Corroborated pre-existing findings (CodeAnt, not re-commented per dedup): L118 lab_coat_hex_in_tokens_css only checks the hex is a substring of TOKENS_CSS (not assigned to the token); L159 required_css_var_in_tokens_css accepts a var name appearing only in a var(...) reference/comment (substring match); L173 asserts the two selector fragments independently rather than the full :root[data-theme="dark"] selector; L184 counts color-scheme occurrences rather than per-selector declarations. (Prefix-collision note: --sl-text/--sl-text-muted and --lc-cobalt/--lc-cobalt-on-dark make the L159 substring check even weaker.) All are valid.
  • Build/lint: per the read-only, non-interactive sandbox constraints I did not execute cargo; I relied on the author's stated cargo test (10 passed) / cargo fmt --check (clean) plus static review. proptest = "1.11.0" is confirmed present in crates/sl-viewer [dev-dependencies] (Cargo.toml:45).
Files Reviewed (4 files)
  • crates/sl-viewer/tests/properties_viewer_tokens.rs — 1 issue (WARNING L50); 4 corroborated existing findings; 2 test-design Consider items
  • CHANGELOG.md — no issues
  • docs/ops/TRACEABILITY.json — no issues
  • docs/ops/WBS.md — no issues

Fix these issues in Kilo Cloud


Reviewed by laguna-s-2.1:free · Input: 195.1K · Output: 26.2K · Cached: 259.6K

KooshaPari added a commit that referenced this pull request Aug 10, 2026
* test(viewer): help_overlay shortcut proptest surface (WBS-6.2 #455)

Adds crates/sl-viewer/tests/properties_viewer_help_overlay.rs with
13 proptest properties pinning the keyboard help SSOT:

* SHORTCUTS is non-empty.
* Every shortcut has non-empty keys / scope / action.
* Every action is descriptive (has at least one ASCII letter) and
  human-readable (no ERR_ / error code leaks).
* Every (keys, scope) pair is unique so the rendered table does
  not collide on its React key.
* The ?, Escape, and Cmd+K / Ctrl+K shortcuts are present.
* Every scope is one of the documented panel scopes.
* Every keys is non-blank.

Updates WBS-6.2 evidence list, TRACEABILITY.json, and CHANGELOG.

* test(viewer): settings_tab HealthStatus proptest surface (WBS-6.2 #456)

Adds crates/sl-viewer/tests/properties_viewer_settings_tab.rs with
11 proptest properties pinning the settings tab SSOT:

* HealthStatus::Unknown.label() is , Healthy is ,
  Unreachable is .
* Every label is non-empty, distinct across variants, single-line,
  and lowercase ASCII.
* label() is deterministic across calls.
* THEME_RADIO_GROUP_ID is non-empty, kebab-case ASCII, and distinct
  from FORGE_DB_HINT_STORAGE_KEY.

Updates WBS-6.2 evidence list, TRACEABILITY.json, and CHANGELOG.

* test(viewer): menu id taxonomy proptest surface (WBS-6.2 #457)

Adds crates/sl-viewer/tests/properties_viewer_menu.rs with 5 proptest
properties pinning the desktop menu id SSOT:

* Every documented menu id (9 of them: ID_APP_ABOUT,
  ID_APP_SETTINGS, ID_FILE_RELOAD_DISCOVERY, ID_FILE_SETTINGS,
  ID_EDIT_FIND, ID_VIEW_RELOAD, ID_VIEW_TOGGLE_THEME,
  ID_VIEW_COMMAND_PALETTE, ID_HELP_TOGGLE) is non-empty.
* Every id is kebab-case ASCII so muda / JS / serde round-trips
  are safe.
* Every id carries the documented sl-viewer. prefix.
* Every id is unique across the documented set.
* The menu taxonomy has exactly 9 documented ids.

Updates WBS-6.2 evidence list, TRACEABILITY.json, and CHANGELOG.

---------

Co-authored-by: SessionLedger Bot <team@sessionledger.local>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants