Skip to content

Move the Hub-Tooling Disproved Claims Entries Into the Code They Constrain - #2742

Merged
ptr727 merged 3 commits into
developfrom
feature/disproved-claims-into-code
Oct 10, 2026
Merged

ptr727 merged 3 commits into
developfrom
feature/disproved-claims-into-code

Conversation

@ptr727

@ptr727 ptr727 commented Oct 10, 2026 •

Copy link
Copy Markdown
Owner

Summary

Part of #2680. The "Disproved Claims" preamble in .github/copilot-instructions.md says an entry is never about hub-hosted machinery, and that a constraint on that tooling is recorded in that tooling's code. Four entries still contradicted it. This change deletes them and keeps each constraint beside the code it constrains:

  • keys_unsorted on jq 1.5 moves to a comment beside the norm filter in repo-config/configure.sh. I re-ran it this session on jq-1.5-1-a5b5cbe (ubuntu:18.04): keys_unsorted evaluates and walk(.) answers jq: 1 compile error.
  • The bare-SHA claims method. The BODY_CLAIM comment in scripts/pr_review.py already carried this disproof, so the only addition is the rejected path-arm measurement. The deleted entry was its only record.
  • Hyphenated inputs in dot notation move to the header of .github/workflows/merge-bot-task.yml, with the full property-name rule (a leading letter or _) and the steps.app-token.outputs.token usage the same file already resolves.
  • sudo_implementations()'s --query slave format moves beside the function in host-setup/linux/install-tools.sh. The --query format was re-checked on this host: space-separated name path, no colon. host-setup/ is hub-local, so the rule covers it.

The STANDUP.md subject-verb entry stays. It is prose rather than tooling, so the rule does not reach it.

The preamble sentence opening "Each names a file and a revision" ran to 43 words. It is now three sentences, each under the 25-word limit.

Comments label

This change exists to record constraints as code comments, which is the case the comments label covers. The rule in the preamble requires those comments.

Local review

Two local-strict-review passes ran. The first raised seven findings: the split sentence was still 27 words, the new pronoun bound to the wrong subject, the configure.sh line broke a causal chain, the merge-bot rule left out the leading-character condition and attached its evidence to the wrong claim, and the path-arm measurement was not carried over. All were fixed in 1fc367b. One finding was declined as pre-existing: TODO.md's decision-cluster "Checked" line cites the deleted keys_unsorted entry, but it is history pinned to 7bc6978. The second pass found nothing.

Test plan

  • prose_lint.py --diff (with --allow-comments, and with --check sentence-length)
  • repo_gate.py, spec/validate.py
  • docker_lint.py (all linters, then actionlint, shellcheck, and shfmt after the fix round)

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Improved how repository checks compare ruleset parameters and identify commit references in pull request descriptions.
  • Documentation

    • Clarified supported expression property-name syntax and documented the format of system command output used by setup checks.

ptr727 and others added 2 commits October 10, 2026 11:23
…train

The Disproved Claims preamble now says an entry is never about hub-hosted
machinery, so the four entries about the configuration script, the review
digest, the merge-bot reusable workflow, and the host installer move out of
the ledger. Each constraint now sits beside the code it constrains, where the
claims check already carried its own.

The STANDUP.md entry stays, since it is prose rather than tooling. The
preamble's 43-word sentence is split in two.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Name the repository as the subject of the split preamble sentence and bring
its first half under the sentence limit. Keep the walk/1 comment chain in
configure.sh unbroken. State the full property-name rule in the merge-bot
comment, with its evidence on the dot-notation claim. Carry the rejected
path-arm measurement into the claims comment, since the deleted entry was
its only record.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings October 10, 2026 18:26
@ptr727 ptr727 added the comments Permits the comment lines the pull request adds or edits, which the prose gate otherwise refuses label Oct 10, 2026
@coderabbitai

coderabbitai Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Repository: ptr727/ProjectTemplate/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: e1cad84d-990a-4f02-a29f-e54303314668

📥 Commits

Reviewing files that changed from the base of the PR and between 043a10e and 254237f.


📒 Files selected for processing (5)
  • .github/copilot-instructions.md
  • .github/workflows/merge-bot-task.yml
  • host-setup/linux/install-tools.sh
  • repo-config/configure.sh
  • scripts/pr_review.py

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



📝 Walkthrough

Walkthrough

The pull request updates repository-specific guidance and adds or revises comments in a workflow and scripts. The supplied line-range summaries describe documentation changes; they do not report executable behavior changes.

Changes

Guidance and comment clarifications

Layer / File(s) Summary
Repository-scope guidance
.github/copilot-instructions.md
The guidance now applies the copy-and-record rule to findings. It adds an entry about STANDUP.md wording and removes four disproved-claim entries.
Workflow and script comments
.github/workflows/merge-bot-task.yml, host-setup/linux/install-tools.sh, repo-config/configure.sh, scripts/pr_review.py
Comments clarify workflow expression property names, the output parsed by awk, jq compatibility, and a path-based scan result.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~8 minutes


Merge Risk: ⚪ Minimal · up to 25423

This change clarifies repository guidance and code comments; no material merge-blocking risk is established.

Pre-merge checks | Passed 4 | Failed 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage Warning Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 2 functions across 3 files. (2 skipped: 2… Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title clearly and specifically describes the main change: moving hub-tooling disproved-claim entries into comments beside the code they constrain.
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.

Full details: Docstring Coverage

Explanation

Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 2 functions across 3 files. (2 skipped: 2 unsupported.)


  • Fix all pre-merge checks with AI
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Commit to this branch
  • Create a new PR




🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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.

@ptr727

ptr727 commented Oct 10, 2026

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Oct 10, 2026 •

Copy link
Copy Markdown
⚠️ Action not completed

Pull request base or head changed.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

The new configure.sh comment includes a commit hash that the repository's comment rules prohibit.

1 open finding
What changed in this PR

This PR moves four hub-tooling disproved claims out of the shared Copilot instructions and places their constraints beside the code they describe.

Changes:

  • Adds compatibility and parsing explanations near the relevant code and workflow.
  • Removes the four ledger entries and shortens a long preamble sentence.
File Description
scripts/​pr_review.py Records the rejected path-matching measurement.
repo-config/​configure.sh Explains jq compatibility beside the normalizer.
host-setup/​linux/​install-tools.sh Documents the --query slave format.
.github/​workflows/​merge-bot-task.yml Documents hyphenated expression properties.
.github/​copilot-instructions.md Removes the four entries and revises the preamble.

🧠 Review effort: Lite


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread repo-config/configure.sh Outdated
@codecov

codecov Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 59.83%. Comparing base (043a10e) to head (254237f).

Additional details and impacted files
@@           Coverage Diff            @@
##           develop    #2742   +/-   ##
========================================
  Coverage    59.83%   59.83%           
========================================
  Files           16       16           
  Lines         8368     8368           
========================================
  Hits          5007     5007           
  Misses        3361     3361           
Flag Coverage Δ
python-3.13 59.83% <ø> (ø)

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

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

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

…mment

A code comment names no commit, and the build string's suffix is one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ptr727

ptr727 commented Oct 10, 2026

Copy link
Copy Markdown
Owner Author

A recorded local strict-review pass covers head 254237f0be520d9ac933e1f34eeb1db89a5db5cb, the content this pull request carries at that commit against develop, and it recorded 0 findings.

@ptr727

ptr727 commented Oct 10, 2026

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Oct 10, 2026 •

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@ptr727

ptr727 commented Oct 10, 2026

Copy link
Copy Markdown
Owner Author

Declining the CodeRabbit "Docstring Coverage" pre-merge warning. This diff adds no function and changes no function body. It adds comment lines beside sudo_implementations() (a Bash function, which has no docstring form) and above the BODY_CLAIM regex constant in scripts/pr_review.py, which is not a function. git diff 043a10eb..254237f0 -- scripts/pr_review.py is one added # comment line. No function touched here gains or loses a docstring.

@ptr727
ptr727 merged commit 3e9e2e8 into develop Oct 10, 2026
13 checks passed
@ptr727
ptr727 deleted the feature/disproved-claims-into-code branch October 10, 2026 18:44
ptr727 added a commit that referenced this pull request Oct 10, 2026
…2744)

## Summary

Fixes a finding Copilot raised on promotion #2743. The comment line
#2742 added to `.github/workflows/merge-bot-task.yml` ran to 27 words,
over the 25-word limit for new prose. The prose gate's sentence-length
check reads Markdown only, so it did not catch this.

The line now reads "A property name may start with a letter or `_` and
continue with letters, digits, `-`, and `_`, so these names need no
index syntax." That is 25 words, and the leading-character condition is
still there. A hand count of every comment sentence that develop adds
over main found none over 25.

Part of #2680.

## Test plan

- [x] `prose_lint.py --diff` (with `--allow-comments`, and with `--check
sentence-length`)
- [x] `local-strict-review` pass, attested, 0 findings

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
ptr727 added a commit that referenced this pull request Oct 10, 2026
## Summary

Promotes 2 changes from `develop` to `main`:

- #2744: Bring the Merge-Bot Property-Name Comment Under the Sentence
Limit
- #2742: Move the Hub-Tooling Disproved Claims Entries Into the Code
They Constrain

Closes #2680

## Review coverage

#2742 was reviewed in full on its final head `254237f0`:

- Copilot raised one finding, which was fixed.
- CodeRabbit reviewed the whole range `043a10eb..254237f` and generated
no actionable comments.
- A local strict-review pass was attested on that head.

Copilot's round on this promotion's first head (`3e9e2e88`, identical in
tree to #2742's reviewed head) raised one nit, a 27-word comment
sentence. #2744 fixed it, and on `ade2beb1` it was covered by Copilot (0
findings) and an attested local pass. CodeRabbit was rate-limited on
#2744 and on this promotion. Its one included review this hour went to
#2742.

Any reader can re-run these checks:

- `git rev-parse 5147099^{tree}` and `git rev-parse ade2beb^{tree}`
both print `eb1a3da64295fe32ac086a34b0a08ff2206482e1`.
- `git rev-parse 254237f^{tree}` and `git rev-parse 3e9e2e8^{tree}`
both print `6a11deed1f69494f15f12e60e4bb87c0a59aaa86`.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comments Permits the comment lines the pull request adds or edits, which the prose gate otherwise refuses

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants