Skip to content

test(viewer): bundle_diff proptest surface (WBS-6.2 #434) - #434

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

test(viewer): bundle_diff proptest surface (WBS-6.2 #434)#434
KooshaPari wants to merge 1 commit into
mainfrom
fix/viewer-bundle-diff-properties-20260808

Conversation

@KooshaPari

@KooshaPari KooshaPari commented Aug 8, 2026

Copy link
Copy Markdown
Owner

User description

Summary

Adds crates/sl-viewer/tests/properties_viewer_bundle_diff.rs with 10 proptest properties pinning the bundle_diff::diff_fields and OkfBundle::from_bundle reductions (WBS-6.2 #434).

diff_fields (6 properties)

  • Returns the documented 9-field set in stable order (guards against UI row-count drift when fields are added)
  • diff_fields(a, a) is reflexive: no fields differ on equal inputs
  • diff_fields(a, a.clone()) is idempotent: clone-mirror produces no differences
  • diff_fields(a, b) is value-flipped symmetric: diff_fields(b, a) swaps value_a/value_b per field but the differs set is identical
  • FieldDiff::differs matches value_a != value_b per field (catches drift where the boolean is computed independently of values)
  • Option<String> fields (model, created_at, goal) render the em-dash fallback () when both sides are None, and the resulting diff is not a difference

OkfBundle::from_bundle (4 properties)

  • message_count equals the input slice count
  • has_acceptance / has_contract reflect presence of those kinds (any-of) in the input continuation
  • token_count falls back to 0 when no Intent slice carries a numeric user_turn_count (3-variant: missing slice / missing field / non-numeric field)
  • source_id carries through from the continuation unchanged

Validation

  • cargo test -p sl-viewer --test properties_viewer_bundle_diff --features "desktop parquet" --locked — 10 passed
  • cargo clippy -p sl-viewer --test properties_viewer_bundle_diff --features "desktop parquet" --locked -- -D warnings — clean
  • cargo fmt --all --check — clean

WBS / TRACEABILITY

WBS-6.2 evidence list and TRACEABILITY.json gain crates/sl-viewer/tests/properties_viewer_bundle_diff.rs. Status stays partial (fuzzing cadence, full loom/shuttle, perf-budget gates remain). CHANGELOG Unreleased documents the new surface.


CodeAnt-AI Description

Add property coverage for viewer bundle comparisons and bundle summaries

What Changed

  • Adds 10 generated-input tests covering stable bundle-diff fields, matching values, symmetric comparisons, missing-value display, and difference indicators
  • Verifies bundle summaries preserve source IDs, count messages correctly, detect acceptance and contract entries, and default missing or invalid token counts to zero
  • Records the new test surface in the WBS evidence list, traceability data, and changelog

Impact

✅ Stable bundle comparison rows
✅ Clear em-dash display for missing values
✅ Reliable bundle summary counts and flags

💡 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_bundle_diff.rs` with
10 proptest properties pinning the `bundle_diff::diff_fields` and
`OkfBundle::from_bundle` reductions:

* `diff_fields` returns the documented 9-field set in stable order
  (guards against UI row-count drift when fields are added).
* `diff_fields(a, a)` is reflexive: no fields differ on equal inputs.
* `diff_fields(a, a.clone())` is idempotent: clone-mirror produces no
  differences.
* `diff_fields(a, b)` is value-flipped symmetric:
  `diff_fields(b, a)` swaps `value_a`/`value_b` per field but the
  `differs` set is identical.
* `FieldDiff::differs` matches `value_a != value_b` per field
  (catches drift where the boolean is computed independently of values).
* `Option<String>` fields (model, created_at, goal) render the em-dash
  fallback (`—`) when both sides are `None`, and the resulting diff
  is not a difference.
* `OkfBundle::from_bundle`:
  * `message_count` equals the input slice count.
  * `has_acceptance`/`has_contract` reflect presence of those kinds
    (any-of) in the input continuation.
  * `token_count` falls back to 0 when no Intent slice carries a
    numeric `user_turn_count` (3-variant: missing slice / missing field
    / non-numeric field).
  * `source_id` carries through from the continuation unchanged.

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

codeant-ai Bot commented Aug 8, 2026

Copy link
Copy Markdown

🤖 CodeAnt AI — Review Status

Status Commit Started (UTC) Finished (UTC)
✅ Reviewed your PR 80e1706 Aug 08, 2026 · 23:41 23:43

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.

@codeant-ai

codeant-ai Bot commented Aug 8, 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

@coderabbitai

coderabbitai Bot commented Aug 8, 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: 49 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: 7cee2776-82f1-4c53-b847-82d19ff943e9

📥 Commits

Reviewing files that changed from the base of the PR and between 5a2e08e and 80e1706.

📒 Files selected for processing (4)
  • CHANGELOG.md
  • crates/sl-viewer/tests/properties_viewer_bundle_diff.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 8, 2026
Comment on lines +160 to +168
let diffs = diff_fields(&a, &b);
for d in &diffs {
prop_assert_eq!(
d.differs,
d.value_a != d.value_b,
"{}.differs ({}) must match value_a != value_b ({} != {})",
d.name, d.differs, d.value_a, d.value_b,
);
}

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 diff properties compare diff_fields outputs only against each other, so they do not independently verify that each named row reads the corresponding OkfBundle member. A consistently wrong mapping, such as emitting token_count under another field's name while preserving the same values on both sides, can satisfy reflexivity, symmetry, and differs == value_a != value_b. Add fixtures that assign distinct values to every field and assert each row's expected values. [incomplete implementation]

Severity Level: Major ⚠️
- ⚠️ Diff UI rows could display the wrong bundle fields.
- ⚠️ Duration, timestamps, goals, and flags lack mapping coverage.
- ⚠️ Future refactors could pass relational properties incorrectly.

Fix in Cursor Fix in VSCode Claude

(Use Cmd/Ctrl + Click for best experience)

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

**Path:** crates/sl-viewer/tests/properties_viewer_bundle_diff.rs
**Line:** 160:168
**Comment:**
	*Incomplete Implementation: The diff properties compare `diff_fields` outputs only against each other, so they do not independently verify that each named row reads the corresponding `OkfBundle` member. A consistently wrong mapping, such as emitting `token_count` under another field's name while preserving the same values on both sides, can satisfy reflexivity, symmetry, and `differs == value_a != value_b`. Add fixtures that assign distinct values to every field and assert each row's 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
👍 | 👎

Comment on lines +209 to +211
let bundles: Vec<Bundle> = (0..slice_count)
.map(|i| Bundle::new(BundleKind::Intent, serde_json::json!({"i": i})))
.collect();

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 from_bundle properties never construct Context or populated Intent bodies, so regressions in duration_ms, model, created_at, or goal extraction will pass all these tests despite those fields being part of the reduced OkfBundle consumed by the diff UI. Add cases with populated and missing values for each reducer field. [incomplete implementation]

Severity Level: Major ⚠️
- ⚠️ Bundle comparison can lose model and timestamp metadata.
- ⚠️ Goal values may disappear from the diff UI.
- ⚠️ Duration extraction regressions remain undetected.

Fix in Cursor Fix in VSCode Claude

(Use Cmd/Ctrl + Click for best experience)

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

**Path:** crates/sl-viewer/tests/properties_viewer_bundle_diff.rs
**Line:** 209:211
**Comment:**
	*Incomplete Implementation: The `from_bundle` properties never construct `Context` or populated `Intent` bodies, so regressions in `duration_ms`, `model`, `created_at`, or `goal` extraction will pass all these tests despite those fields being part of the reduced `OkfBundle` consumed by the diff UI. Add cases with populated and missing values for each reducer field.

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 +253 to +266
let bundles: Vec<Bundle> = match variant {
0 => Vec::new(),
1 => vec![Bundle::new(BundleKind::Intent, serde_json::json!({"goal": "x"}))],
_ => vec![Bundle::new(
BundleKind::Intent,
serde_json::json!({"user_turn_count": "not-a-number"}),
)],
};
let cb = ContinuationBundle {
source_id: "test".into(),
bundles,
};
let okf = OkfBundle::from_bundle(&cb);
prop_assert_eq!(okf.token_count, 0, "token_count must default to 0 when missing/non-numeric");

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 property does not verify the documented aggregation contract for token_count: every generated case contains zero or one Intent bundle, so an implementation that uses only the first Intent bundle instead of summing user_turn_count across all Intent bundles will pass. Generate multiple Intent bundles with numeric counts and assert their sum. [incomplete implementation]

Severity Level: Major ⚠️
- ❌ Bundle comparison can display an undercounted token total.
- ⚠️ Multi-message viewer sessions can expose incorrect token counts.
- ⚠️ The documented aggregation contract remains untested.

Fix in Cursor Fix in VSCode Claude

(Use Cmd/Ctrl + Click for best experience)

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

**Path:** crates/sl-viewer/tests/properties_viewer_bundle_diff.rs
**Line:** 253:266
**Comment:**
	*Incomplete Implementation: The property does not verify the documented aggregation contract for `token_count`: every generated case contains zero or one `Intent` bundle, so an implementation that uses only the first `Intent` bundle instead of summing `user_turn_count` across all `Intent` bundles will pass. Generate multiple `Intent` bundles with numeric counts and assert their sum.

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 +284 to +290
/// Compile-time guarantee that the FieldDiff-derived constants stay in sync.
/// If the impl adds a field, this test fails to compile until EXPECTED_FIELD_NAMES
/// is updated, prompting the reviewer to confirm the UI row count.
#[allow(dead_code)]
const fn _assert_field_count_fits_diff(diff: &[FieldDiff], expected_len: usize) -> bool {
diff.len() == expected_len
}

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 is not a compile-time guarantee because _assert_field_count_fits_diff is never invoked; defining a const fn does not evaluate it or enforce its result. The documented synchronization protection therefore does nothing, and only the runtime property test checks the count. Replace this unused helper with an actually evaluated compile-time assertion or remove the misleading comment. [comment mismatch]

Severity Level: Minor 🧹
- ⚠️ Claimed compile-time synchronization protection is absent.
- ⚠️ Field-count drift is detected only when tests execute.
- ⚠️ The helper can mislead maintainers reviewing coverage.

Fix in Cursor Fix in VSCode Claude

(Use Cmd/Ctrl + Click for best experience)

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

**Path:** crates/sl-viewer/tests/properties_viewer_bundle_diff.rs
**Line:** 284:290
**Comment:**
	*Comment Mismatch: This is not a compile-time guarantee because `_assert_field_count_fits_diff` is never invoked; defining a `const fn` does not evaluate it or enforce its result. The documented synchronization protection therefore does nothing, and only the runtime property test checks the count. Replace this unused helper with an actually evaluated compile-time assertion or remove the misleading comment.

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 unresolved conflicts. Cannot auto-rebase.

@KooshaPari KooshaPari closed this Aug 8, 2026
@KooshaPari
KooshaPari deleted the fix/viewer-bundle-diff-properties-20260808 branch August 8, 2026 23:47
KooshaPari added a commit that referenced this pull request Aug 9, 2026
Adds `crates/sl-viewer/tests/properties_viewer_bundle_diff.rs` with
10 proptest properties pinning the `bundle_diff::diff_fields` and
`OkfBundle::from_bundle` reductions:

* `diff_fields` returns the documented 9-field set in stable order
  (guards against UI row-count drift when fields are added).
* `diff_fields(a, a)` is reflexive: no fields differ on equal inputs.
* `diff_fields(a, a.clone())` is idempotent: clone-mirror produces no
  differences.
* `diff_fields(a, b)` is value-flipped symmetric:
  `diff_fields(b, a)` swaps `value_a`/`value_b` per field but the
  `differs` set is identical.
* `FieldDiff::differs` matches `value_a != value_b` per field
  (catches drift where the boolean is computed independently of values).
* `Option<String>` fields (model, created_at, goal) render the em-dash
  fallback (`—`) when both sides are `None`, and the resulting diff
  is not a difference.
* `OkfBundle::from_bundle`:
  * `message_count` equals the input slice count.
  * `has_acceptance`/`has_contract` reflect presence of those kinds
    (any-of) in the input continuation.
  * `token_count` falls back to 0 when no Intent slice carries a
    numeric `user_turn_count` (3-variant: missing slice / missing field
    / non-numeric field).
  * `source_id` carries through from the continuation unchanged.

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