Skip to content

Conversation

@jswrenn
Copy link
Collaborator

@jswrenn jswrenn commented Jan 22, 2026

This change anticipates two improvements to our validity typestate:

  1. The introduction of a BitValid typestate that does not
    promise that library-safety invariants are also upheld.

  2. The introduction of a Valid trait, which encodes when a
    validity typestate is in a bit-valid state. This will become
    essential in an upcoming PR, where validity may be specified
    either atomically or on a per-field basis.


Latest Update: v14 — Compare vs v13

📚 Full Patch History

Links show the diff between the row version and the column version.

Version v13 v12 v11 v10 v9 v8 v7 v6 v5 v4 v3 v2 v1 Base
v14 v13 v12 v11 v10 v9 v8 v7 v6 v5 v4 v3 v2 v1 Base
v13 v12 v11 v10 v9 v8 v7 v6 v5 v4 v3 v2 v1 Base
v12 v11 v10 v9 v8 v7 v6 v5 v4 v3 v2 v1 Base
v11 v10 v9 v8 v7 v6 v5 v4 v3 v2 v1 Base
v10 v9 v8 v7 v6 v5 v4 v3 v2 v1 Base
v9 v8 v7 v6 v5 v4 v3 v2 v1 Base
v8 v7 v6 v5 v4 v3 v2 v1 Base
v7 v6 v5 v4 v3 v2 v1 Base
v6 v5 v4 v3 v2 v1 Base
v5 v4 v3 v2 v1 Base
v4 v3 v2 v1 Base
v3 v2 v1 Base
v2 v1 Base
v1 Base

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @jswrenn, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request implements a significant refactoring by renaming the Valid type within the invariant module to Safe. This change is a strategic move to pave the way for upcoming enhancements to the validity typestate system, which will introduce a distinct BitValid state and a Valid trait. The goal is to provide a more nuanced approach to defining and enforcing data validity, distinguishing between bit-level validity and broader library-safety invariants.

Highlights

  • Renaming invariant::Valid to invariant::Safe: The primary change across the codebase is the renaming of the Valid enum variant within the invariant module to Safe. This affects type parameters, function signatures, and macro expansions where invariant::Valid was previously used.
  • Preparation for new validity typestates: This renaming is a foundational step anticipating the introduction of a BitValid typestate (which will not guarantee library-safety invariants) and a new Valid trait, allowing for more flexible and granular validity specifications in the future.
  • Updated documentation and comments: Relevant documentation and inline comments have been updated to reflect the new Safe terminology, ensuring consistency and clarity for developers.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request is a large-scale refactoring that renames invariant::Valid to invariant::Safe. The changes are mostly consistent across all modified files. I found one critical issue in a test file that seems to be a syntax error introduced during the refactoring. Once that is fixed, this will be a good preparatory change for the upcoming improvements mentioned in the description.

@codecov-commenter
Copy link

codecov-commenter commented Jan 22, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.02%. Comparing base (c6a9490) to head (2cf6e37).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2913   +/-   ##
=======================================
  Coverage   92.02%   92.02%           
=======================================
  Files          19       19           
  Lines        6029     6029           
=======================================
  Hits         5548     5548           
  Misses        481      481           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@jswrenn jswrenn force-pushed the Gb6fa34cec5080caffa0980ed1d3e1ae273550f44 branch from 86ed3f5 to 0208eba Compare January 23, 2026 12:39
@jswrenn jswrenn force-pushed the G0f139a4a1ea20e62488df402468293623a806667 branch 2 times, most recently from 135b042 to 1173bdb Compare January 23, 2026 16:54
@jswrenn jswrenn force-pushed the Gb6fa34cec5080caffa0980ed1d3e1ae273550f44 branch from 0208eba to 7f5262d Compare January 23, 2026 16:54
Copy link
Member

@joshlf joshlf left a comment

Choose a reason for hiding this comment

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

Are there places where we should update doc comments?

Copy link
Member

@joshlf joshlf left a comment

Choose a reason for hiding this comment

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

Are there places where we should update doc comments?

@jswrenn jswrenn force-pushed the G0f139a4a1ea20e62488df402468293623a806667 branch from 1173bdb to 86490b0 Compare January 26, 2026 14:42
@jswrenn jswrenn force-pushed the Gb6fa34cec5080caffa0980ed1d3e1ae273550f44 branch 2 times, most recently from c28cac9 to 2974513 Compare January 26, 2026 14:53
@jswrenn jswrenn force-pushed the G0f139a4a1ea20e62488df402468293623a806667 branch 2 times, most recently from ca073fd to 6ede450 Compare January 26, 2026 15:11
Base automatically changed from Gb6fa34cec5080caffa0980ed1d3e1ae273550f44 to main January 26, 2026 15:42
@jswrenn jswrenn enabled auto-merge January 26, 2026 15:59
@jswrenn jswrenn force-pushed the G0f139a4a1ea20e62488df402468293623a806667 branch 2 times, most recently from ca20651 to 3bbe0e5 Compare January 26, 2026 16:04
@jswrenn jswrenn disabled auto-merge January 26, 2026 16:09
@jswrenn jswrenn force-pushed the G0f139a4a1ea20e62488df402468293623a806667 branch 3 times, most recently from 132d6be to 15daa98 Compare January 26, 2026 19:10
@joshlf joshlf enabled auto-merge January 26, 2026 19:10
@jswrenn jswrenn force-pushed the G0f139a4a1ea20e62488df402468293623a806667 branch 2 times, most recently from ee4e404 to cab8ea8 Compare January 30, 2026 19:45
This change anticipates two improvements to our validity typestate:

1. The introduction of a `BitValid` typestate that does *not*
   promise that library-safety invariants are also upheld.

2. The introduction of a `Valid` trait, which encodes when a
   validity typestate is in a bit-valid state. This will become
   essential in an upcoming PR, where validity may be specified
   either atomically or on a per-field basis.

gherrit-pr-id: G0f139a4a1ea20e62488df402468293623a806667
@jswrenn jswrenn force-pushed the G0f139a4a1ea20e62488df402468293623a806667 branch from cab8ea8 to 2cf6e37 Compare January 30, 2026 20:09
[[package]]
name = "zerocopy"
version = "0.8.36"
version = "0.8.37"
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

@joshlf A downside of committing the Cargo.lock is that releases are going to churn the lockfile, even if no third-party dependencies actually change.

Copy link
Member

Choose a reason for hiding this comment

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

Yeah, this is a bummer. I wonder if we can automate bumping this.

Copy link
Member

Choose a reason for hiding this comment

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

#2958 should automate this going forward.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants