Skip to content

review: require a concrete failure_scenario on every finding#226

Open
jwbron wants to merge 1 commit into
mainfrom
review-failure-scenario
Open

review: require a concrete failure_scenario on every finding#226
jwbron wants to merge 1 commit into
mainfrom
review-failure-scenario

Conversation

@jwbron

@jwbron jwbron commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Summary

First of three PRs split out of #224 (stack: this PR, then #227 provenance gate, then #228 prompt disciplines). Each lands independently revertable; the three together are byte-identical to #224.

Every finding (not just blocking ones) now carries a concrete failure_scenario: the specific inputs or state and the wrong outcome they produce. The field is required in the structured finding schema (FINDING_SCHEMA_VERSION bumped to 2), emitted by every producer (label-shape reviewers and all 11 specialist lenses), and carried verbatim into claims.json. The claim-validator now attacks exactly that stated scenario: confirmed means the named scenario occurs on the cited lines, and a scenario too vague to check caps at plausible.

FINDING_SCHEMA_VERSION is now 2 (a required field invalidates previously serialized findings, per the schema module's own rule); every corpus fixture is migrated with a hand-written failure scenario.

cc @jeresig

Testing

  • npx vitest run workflows/review: 410 tests green, including the smoke set.
  • npx tsc --noEmit clean.

Every finding (not just blocking ones) now carries a failure_scenario:
the specific inputs or state and the wrong outcome they produce. The
field is required in the structured finding schema
(FINDING_SCHEMA_VERSION bumped to 2), emitted by every producer
(label-shape reviewers and all 11 specialist lenses), and carried
verbatim into claims.json. The claim-validator attacks exactly that
stated scenario: confirmed means the named scenario occurs on the cited
lines, and a scenario too vague to check caps at plausible.

Every corpus fixture is migrated with a hand-written failure scenario,
per the schema module's rule that a required field invalidates
previously serialized findings.
@changeset-bot

changeset-bot Bot commented Jul 9, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 8306d13

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
review Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@jeresig jeresig left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Great!

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.

2 participants