Skip to content

deep-review: add convergent round thresholds - #28

Open
stbenjam wants to merge 1 commit into
mainfrom
deep-review-convergent-round-thresholds
Open

deep-review: add convergent round thresholds#28
stbenjam wants to merge 1 commit into
mainfrom
deep-review-convergent-round-thresholds

Conversation

@stbenjam

@stbenjam stbenjam commented Sep 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add a round-aware convergence policy: baseline, then 2x, 4x, 8x, doubling thereafter for newly discovered blockers.
  • Keep unresolved blockers from earlier rounds blocking without requalification.
  • Carry round context through setup, specialist dispatch, arbitration, and verdict output.
  • Preserve below-threshold findings as suggestions or notes instead of hiding them.

Validation

  • uvx skillsaw==0.18.0 lint plugins/reviews/skills/deep-review — A+, zero findings
  • make lint — A+, zero errors or warnings

Validator note

The generic skill-creator quick_validate.py rejects the existing argument-hint frontmatter key. The same failure reproduces unchanged on origin/main; the repository-pinned skillsaw validation passes.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 1, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-01T16:19:47.376637Z c8f783a PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c8f783aeb2

ℹ️ 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".

Comment on lines +48 to +49
Reproducer confirmation strengthens the evidence side of the threshold but
does not bypass the multiplier for a new finding. An unresolved blocker from an

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Reproduce candidates before applying the elevated threshold

On round 2 or later, a new bug whose static evidence does not yet clear the multiplier is downgraded to SUGGESTION/NOTE by step 5, but Phase 4 of SKILL.md launches reproducers only for findings already classified as BLOCKING. Such a candidate can therefore never obtain the confirmation that this paragraph says strengthens its evidence, allowing a reproducible bug to remain non-blocking and the review to approve. Reproduce eligible reproducer_needed candidates before final threshold classification, or introduce a provisional-candidate state.

Useful? React with 👍 / 👎.

Comment on lines +84 to +86
After collecting this context, read
[iterative-reviews.md](iterative-reviews.md) to determine the review round,
threshold multiplier, carried blockers, and new candidates. For a local branch

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Match the GitLab filter to the emitted footer

For GitLab MRs, the context collected before this newly required round calculation excludes verdicts produced by the skill itself: setup.md line 73 searches for Generated by /...deep-review, while SKILL.md line 190 mandates the footer Generated by the deep-review skill; the literal footer does not match that regex. Consequently repeated GitLab reviews are treated as round 1 and previously blocking findings are not carried forward. Update the GitLab filter to recognize the actual footer, retaining any legacy marker if needed.

Useful? React with 👍 / 👎.

Comment on lines +23 to +25
or repost of one verdict does not create another round. If the user explicitly
supplies a round, use it. Without review history or explicit round context, use
round 1.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Expose and parse the explicit round input

The fallback for local branches depends on the user explicitly supplying a round, but Step 1.1 and the skill's argument table define no round option; moreover, a bare integer is parsed as a PR identifier. Thus a user cannot reliably invoke a local second-round review through the documented command interface, and it silently remains at round 1. Add a documented, validated option such as --round N and include it in argument parsing.

Useful? React with 👍 / 👎.

Comment on lines +21 to +23
For a PR/MR, count completed deep-review panel verdicts from earlier
invocations; the current invocation is the next round. A retry, duplicate post,
or repost of one verdict does not create another round. If the user explicitly

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Authenticate verdicts before incrementing the round

On GitHub, the setup query treats every PR comment containing the public footer text as a prior panel verdict, without checking its author or validating the verdict structure. Any participant who quotes or copies that footer can therefore inflate the count used here; several such comments can push the review to a very high multiplier and cause legitimate new blockers to be downgraded. Count only comments created by the expected reviewer identity and matching a complete verdict, or store a verifiable invocation identifier.

Useful? React with 👍 / 👎.

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.

1 participant