Skip to content

docs(#1799): add CycloneDX/SPDX parity checklist item - #1800

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/1799-add-parity-checklist
Open

docs(#1799): add CycloneDX/SPDX parity checklist item#1800
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/1799-add-parity-checklist

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

What:

Add a CycloneDX/SPDX parity checklist item to the "Review Checklist for New Policy Rules" section of AGENTS.md.

Why:

PR #1796 added a new deny rule to both sbom_cyclonedx and sbom_spdx with different levels of strictness in the helper functions used. Multiple reviewers (automated and human) did not catch the asymmetry because AGENTS.md lacked guidance to check for parity between CycloneDX and SPDX implementations. The new checklist item instructs reviewers to verify equivalent behavior, matching helper strictness, and test coverage across attribution sources when rules span both SBOM format paths.

Tickets:


Closes #1799

Post-script verification

  • Branch is not main/master (agent/1799-add-parity-checklist)
  • Secret scan passed (gitleaks — 7c9b0e0f9032fb1345ec191be9126963d5a92453..HEAD)
  • PR body secret scan passed (gitleaks — no-git)

Add a new review checklist item to the "Review Checklist for New
Policy Rules" section of AGENTS.md. The item instructs reviewers
to verify equivalent behavior when a deny/warn rule is implemented
in both sbom_cyclonedx and sbom_spdx paths.

This addresses a gap identified by retro analysis of PR #1796,
where reviewers did not verify parity between CycloneDX and SPDX
implementations of the hermeto_attribution_required rule.

Closes #1799
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 11, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 5:53 PM UTC · Completed 6:03 PM UTC

Commit: 87c4a29 · View workflow run →

@codecov

codecov Bot commented Aug 11, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

Flag Coverage Δ
unit-tests 100.00% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

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

@fullsend-ai-review

Copy link
Copy Markdown

Review

Findings

Medium

Low

  • [placement coherence] AGENTS.md:102 — Issue Add CycloneDX/SPDX implementation parity review checklist to AGENTS.md #1799 proposes adding the parity checklist item "after the existing effective_on checklist item," but the diff places it after the "Test coverage" item (the last existing item). The issue was written when effective_on was the only checklist item — "after it" effectively meant "at the end of the list." Two items (Collection membership, Test coverage) were added subsequently, so appending to the current end is consistent with the original intent. The placement is defensible.

Labels: PR is a documentation-only change to AGENTS.md

@fullsend-ai-review fullsend-ai-review 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.

See the review comment for full details.

Comment thread AGENTS.md
the pattern.
- **Test coverage:** Every new rule needs tests in a corresponding `_test.rego` file. CI enforces
100% coverage.
- **CycloneDX/SPDX parity:** When a rule is implemented in both `sbom_cyclonedx` and `sbom_spdx`,

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[low] placement coherence

Issue #1799 proposes adding the parity checklist item 'after the existing effective_on checklist item,' but the diff places it after the 'Test coverage' item (the last existing item). The issue was written when effective_on was the only checklist item — 'after it' effectively meant 'at the end of the list.' Two items (Collection membership, Test coverage) were added subsequently, so appending to the current end is consistent with the original intent. The placement is defensible.

@fullsend-ai-review fullsend-ai-review Bot added requires-manual-review Review requires human judgment documentation Improvements or additions to documentation labels Aug 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation requires-manual-review Review requires human judgment size: XS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add CycloneDX/SPDX implementation parity review checklist to AGENTS.md

0 participants