Skip to content

T180: the DCO changelog entry is about a git signature, not a receipt - #13

Merged
arpanghoshal merged 2 commits into
mainfrom
fix/t180-allowlist-dco
Sep 13, 2026
Merged

arpanghoshal merged 2 commits into
mainfrom
fix/t180-allowlist-dco

Conversation

@arpanghoshal

@arpanghoshal arpanghoshal commented Sep 13, 2026

Copy link
Copy Markdown
Member

docs main is red right now, and the last green run on it predates the cause.

CTRLRun/ctrlrun#169 added a CHANGELOG entry explaining why the DCO check refused every Dependabot pull request. It says "signs its commits off" and "GitHub's own signature", and T180 scans the kernel's release documents for exactly those words. The docs CI run that went green on main checked out the kernel before #169 merged; the next run against current kernel main fails.

Both phrases are ANOTHER_SUBJECT's case, which is what that half of the allow-list exists for: the Developer Certificate of Origin trailer on a git commit, and GitHub's signature on that commit read back through its API. Neither is a signature on a receipt, which is the thing SPEC-v0.6.md §6.4 says this project does not do.

scripts/check.sh green against current kernel main: 1,686 tests, every generator, lint and links.

Summary by CodeRabbit

  • Tests
    • Updated release-document validation to correctly handle legitimate references to commit verification terminology.
    • Added coverage for a v0.9 changelog entry involving Developer Certificate of Origin and GitHub commit signatures.
    • This prevents valid documentation from being incorrectly flagged by automated checks.

CTRLRun/ctrlrun#169 added a CHANGELOG entry explaining why the DCO check refused every
Dependabot pull request. It says signs off and GitHub's own signature, and T180 scans the
kernel's release documents for exactly those words, so docs main went red against a kernel main
that had merged an hour earlier. The last green run predates that merge.

Both phrases are ANOTHER_SUBJECT's case, which is what that half of the allow-list is for: the
Developer Certificate of Origin trailer on a git commit, and GitHub's signature on that commit
read back through its API. Neither is a signature on a receipt, which is the thing SPEC-v0.6
§6.4 says this project does not do.

Signed-off-by: arpan <contact@arpanghoshal.com>
@mintlify

mintlify Bot commented Sep 13, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
ctrlrun 🟢 Ready View Preview Sep 13, 2026, 11:07 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Sep 13, 2026

Copy link
Copy Markdown

Review Change StackReview Change Stack

Warning

Review limit reached

Next included review available in 34 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 98007f80-38ff-49ad-ab62-c627b6827146

📥 Commits

Reviewing files that changed from the base of the PR and between 75d2902 and 6eb732e.

⛔ Files ignored due to path filters (4)
  • generated/readiness.full.mdx is excluded by !**/generated/**
  • generated/readiness.json is excluded by !**/generated/**
  • generated/readiness.mdx is excluded by !**/generated/**
  • generated/readiness.readme.md is excluded by !**/generated/**
📒 Files selected for processing (2)
  • docs.mdx
  • docs/production/index.mdx

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 966ef107-97e2-4712-9f39-c22aa46fd1f7

📥 Commits

Reviewing files that changed from the base of the PR and between 9ea35e5 and 75d2902.

📒 Files selected for processing (1)
  • tests/test_release_documents.py

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

The release document test allowlist now includes a v0.9 changelog entry about the DCO check. Comments identify its sign-off and GitHub signature terms as non-receipt references.

Changes

Release Document Validation

Layer / File(s) Summary
DCO changelog allowlist
tests/test_release_documents.py
Adds the v0.9 DCO check entry to the CHANGELOG.md allowlist. Comments explain why its signed, signs off, and signature terms are allowed.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Bug fix

Merge Risk: ⚪ Minimal · up to 75d29

No actionable merge-blocking risk is identified.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly identifies the T180 allow-list change and distinguishes the Git signature from a receipt signature.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 1…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/t180-allowlist-dco

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

arpanghoshal added a commit that referenced this pull request Sep 13, 2026
The conflicts were all in generated files, so they are resolved by running the generators
rather than by hand-merging two renders. The Python line this branch adds survives it:
'Python 3.11 and later, tested on 3.11 to 3.14'.

T180 still fails here for a reason that belongs to main, not to this branch: the DCO entry
CTRLRun/ctrlrun#169 added to the kernel's CHANGELOG trips the signature scan. PR #13
allow-lists it.

Signed-off-by: arpan <arpanghoshalwork@gmail.com>
CTRLRun/ctrlrun#150 put the postgres extra in the docs lock so that job collects the suite the
check job runs. It collects five more tests than the block recorded, which the audit does not
fail on, because it only fails when the block claims MORE than the suite collects. Understating
is still not the number.

Signed-off-by: arpan <contact@arpanghoshal.com>
@arpanghoshal
arpanghoshal merged commit 351ef20 into main Sep 13, 2026
3 checks passed
@arpanghoshal
arpanghoshal deleted the fix/t180-allowlist-dco branch September 15, 2026 19:15
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