Skip to content

feat(db): make store sort comparators contract-safe #135

Open
halibobo1205 wants to merge 2 commits into
developfrom
feat/fix_sort
Open

feat(db): make store sort comparators contract-safe #135
halibobo1205 wants to merge 2 commits into
developfrom
feat/fix_sort

Conversation

@halibobo1205

@halibobo1205 halibobo1205 commented Jul 17, 2026

Copy link
Copy Markdown
Owner

User description

What does this PR do?

  • Replaces invalid comparators in AssetIssueStore, ExchangeStore, and
    ProposalStore with standard Comparator implementations.
  • Orders equal-expiration proposals by proposal ID descending, preserving the
    expected price-history reconstruction behavior.
  • Adds an ErrorProne checker that detects comparator implementations which cannot
    return 0, including lambdas and method declarations.

Why is this required?

Comparators that never return 0 violate the comparator contract and may cause
List.sort to throw IllegalArgumentException.

Proposal ordering also affects energy and bandwidth price-history reconstruction.
The descending-ID tie-break ensures proposals with the same expiration time produce
the same final value as live proposal execution.

The custom ErrorProne checker prevents the invalid comparator pattern from being
introduced again and covers lambda comparators that the built-in checker does not.

How was this tested?

  • ErrorProne checker unit tests
  • Store ordering and equal-key tests
  • End-to-end equal-expiration energy price-history test
  • Project compilation, lint, and Checkstyle

CodeAnt-AI Description

Make store sorting contract-safe and preserve equal-expiration proposal order

What Changed

  • Store lists now sort with standard comparison rules, so equal values are handled cleanly instead of risking sort errors.
  • Asset issues are returned by name, then by order.
  • Exchanges and proposals are returned newest first by creation time.
  • Proposals with the same expiration time now stay in descending ID order, which keeps energy and bandwidth price history aligned with live execution.
  • Added regression tests for store ordering, equal-time proposal handling, and the new comparator check.

Impact

✅ Fewer sort crashes on large result lists
✅ Correct energy price history when proposals expire at the same time
✅ Stable asset, exchange, and proposal ordering for users

💡 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.

The getAll*/getSpecified* store methods sorted with hand-rolled
comparators (`a <= b ? 1 : -1`) that never return 0, violating the
Comparator contract: List.sort can throw IllegalArgumentException and
the sort intent is unclear. Replace them with Comparator.comparingLong /
comparing so equal keys return 0.

getSpecifiedProposals must additionally keep equal-expiration proposals
in descending-id order. Live execution applies the highest id first and
the lowest id last (final value), and the energy/bandwidth price-history
loaders rebuild from the tail, so the lowest id must be last. The old
never-return-0 comparator produced this order by accident; plain
ascending expiration order inverts it and reconstructs the wrong price.
Add an explicit descending-id tie-break to preserve the behavior.
Add a custom ErrorProne BugChecker that flags Comparator/compareTo
bodies which can never return 0 (e.g. `? 1 : -1`). The built-in
ComparisonContractViolated inspects only method declarations, so it
cannot see the lambda comparators this repo actually uses; this checker
covers the lambda form and method declarations, matching genuine
overrides via findSuperMethods so same-named overloads are not flagged.

It is a conservative syntactic check (direct constant or ternary-of-
constant returns only, no data-flow). Enable it as ERROR in the
allowlist, and add the test-helper dependencies to verification-metadata
so the checker tests run under strict dependency verification.
@codeant-ai

codeant-ai Bot commented Jul 17, 2026

Copy link
Copy Markdown

CodeAnt AI is reviewing your PR.

@codeant-ai

codeant-ai Bot commented Jul 17, 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

@codeant-ai codeant-ai Bot added the size:XL This PR changes 500-999 lines, ignoring generated files label Jul 17, 2026
@halibobo1205

Copy link
Copy Markdown
Owner Author

@codex: review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Swish!

Reviewed commit: 88f1be127d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@codeant-ai

codeant-ai Bot commented Jul 17, 2026

Copy link
Copy Markdown

CodeAnt AI finished reviewing your PR.

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

Labels

size:XL This PR changes 500-999 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant