Visitar URL original
Fix a Registry Entry, a Shared Branch's End, and Spec Issue References by ptr727 · Pull Request #4155 · ptr727/ProjectTemplate · GitHub
Skip to content

Fix a Registry Entry, a Shared Branch's End, and Spec Issue References - #4155

Merged
ptr727 merged 4 commits into
developfrom
burndown/spec-registry-upstream-fixes
Nov 13, 2026
Merged

ptr727 merged 4 commits into
developfrom
burndown/spec-registry-upstream-fixes

Conversation

@ptr727

@ptr727 ptr727 commented Nov 13, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • Registry: add SourceReader to the HomeAutomation-Config entry's pythonDirectories. That repository's validate callers in test-pull-request.yml and publish-release.yml pass it on both main and develop, re-read live for this change, while the registry listed every directory but this one.
  • upstream-contribution-workflow: the contribution now ends once the pull request of every clean branch the dirty branch feeds is merged or closed, with no slice left to cut. Read literally, the old singular wording deleted a shared dirty branch, and closed its iteration pull request, at the first upstream merge. That left any other upstream pull request it fed with no branch to take reviewer fixes through. Generated trees regenerated with scripts/build_dist.py.
  • Unfiled defect this run found: three why texts in spec/host-tools.json (the docker and ripgrep entries) cited bare hub issue numbers. Carried spec/ files reference no coordination machinery, and a bare number resolves to an unrelated issue in any other repository. The references are dropped, and each sentence keeps the evidence it cited in its own words. No issue was filed for it.

Verification

  • spec/validate.py, scripts/build_dist.py --check, and the prose gate against develop pass.
  • tests/test_host_gate.py, tests/test_spec_validate.py, tests/test_audit_helpers.py, and tests/test_build_dist.py pass.

Local Review Findings Fixed After the Opening Push

  • .agents/skills/upstream-contribution-workflow/SKILL.md, the new end condition (class introduced): a clean branch superseded under step 5, or a slice the maintainer withdraws, has a pull request upstream neither merged nor declined, so the condition never holds. Fixed in the second push, which counts any closed pull request as ended. A further local pass over that push raised nothing.

Local Review Findings Declined

  • registry/repos.json, the HomeAutomation-Config drift note counting the Python directories its CI gated on 2026-10-27 (class pre-existing): declined as not false. SourceReader first appears in that repository's test-pull-request.yml list on 2026-10-30, so the count was right on the date the note records.

Closes on promotion: #4050, #4016

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated contribution guidance to account for all related branches before closing the iteration PR and deleting branches.
    • Clarified notes about observed Docker and ripgrep behavior.
  • Chores
    • Updated the HomeAutomation-Config repository’s Python directory list.

ptr727 and others added 3 commits November 13, 2026 08:27
Add SourceReader to the HomeAutomation-Config registry entry's Python
directories, matching the list its validate callers pass.

State that a dirty branch feeding several clean branches ends only when
upstream merges or declines the last upstream pull request it feeds.

Drop the bare issue numbers from three host-tools.json reasons, keeping
the evidence each one cited.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings November 13, 2026 16:33
@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

A recorded local strict-review pass covers head 50342bdf06db071ef21f94fd5dd44a5437335e69, the content this pull request carries at that commit against develop, and it recorded 1 finding.

@coderabbitai

coderabbitai Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Explain Change →

No actionable comments were generated in the recent review.

Walkthrough

The workflow completion condition now covers clean branches and remaining slices. The HomeAutomation-Config Python directory list adds SourceReader. Docker and ripgrep explanations describe observations without issue references.

Changes: Contribution workflow

Layer / File(s) Summary
Update workflow completion condition
.agents/skills/upstream-contribution-workflow/SKILL.md
Completion now requires every clean branch fed by the dirty branch to be merged or closed, with no remaining slice to cut. The workflow then closes the iteration PR without merging and deletes both branches.

Repository registry

Layer / File(s) Summary
Update Python directory list
registry/repos.json
The HomeAutomation-Config entry adds SourceReader to its pythonDirectories list.

Host-tool explanations

Layer / File(s) Summary
Revise host-tool explanations
spec/host-tools.json
The Docker explanation describes the Engine version and differing CLI/daemon probe results as observations from specific hosts. The ripgrep explanation states the Debian 13 package comparison directly.

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

Merge Risk: Minimal · up to 0a781

This change adjusts documentation text, a workflow end condition, and one registry directory entry. No behavior-affecting risk is evident, so it looks ready to merge.

Pre-merge checks: Passed 4

Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title names three changes: a registry entry fix, a shared branch end condition, and spec issue references. The changeset does contain all three: SourceReader added to HomeAutomation-Config pythonD…
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: Title check

Explanation

The title names three changes: a registry entry fix, a shared branch end condition, and spec issue references. The changeset does contain all three: SourceReader added to HomeAutomation-Config pythonDirectories, the upstream-contribution-workflow end condition change, and removal of bare issue numbers from three why texts in spec/host-tools.json. The title is specific and concise, though it lists three items rather than naming the single most important change, which is acceptable. The title is a fully accurate summary of the PR's changes.

Finishing Touches

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

Recent review info

Run configuration

Commits

Reviewing files that changed from the base of the PR and between 376d69f and 0a781e0.

Files ignored due to path filters: 3

  • .claude-plugin/fleet-skills/.source-digests/upstream-contribution-workflow is excluded by !.claude-plugin/fleet-skills/**
  • .claude-plugin/fleet-skills/skills/upstream-contribution-workflow/SKILL.md is excluded by !.claude-plugin/fleet-skills/**
  • .github/skills/upstream-contribution-workflow/SKILL.md is excluded by !.github/skills/**
Files selected for processing: 3

  • .agents/skills/upstream-contribution-workflow/SKILL.md
  • registry/repos.json
  • spec/host-tools.json

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

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

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

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

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

A moderate active bug remains in the contribution workflow because superseded or withdrawn slices are excluded from terminal-state handling, preventing cleanup when no active slice remains.

1 open issue
What changed in this PR

This pull request updates registry metadata, removes invalid issue references from host-tool specifications, and synchronizes the upstream contribution workflow guidance across generated distributions.

Changes:

  • Adds SourceReader to the HomeAutomation-Config Python directory registry.
  • Removes bare issue references from Docker and ripgrep rationale text.
  • Updates the canonical and generated workflow skills and refreshes the source digest.
  • The workflow termination condition still excludes superseded or withdrawn slices, which can prevent cleanup.
File Description
spec/​host-tools.json Removes bare issue references from Docker and ripgrep rationale while preserving the supporting evidence.
registry/​repos.json Adds SourceReader to the HomeAutomation-Config Python directory list.
.github/​skills/​upstream-contribution-workflow/​SKILL.md Updates the generated GitHub Copilot upstream contribution workflow guidance.
.claude-plugin/​fleet-skills/​skills/​upstream-contribution-workflow/​SKILL.md Updates the generated Claude plugin upstream contribution workflow guidance.
.claude-plugin/​fleet-skills/​.source-digests/​upstream-contribution-workflow Refreshes the source digest for the upstream contribution workflow skill.
.agents/​skills/​upstream-contribution-workflow/​SKILL.md Updates the canonical upstream contribution workflow termination condition.

Review effort: Lite

@codecov

codecov Bot commented Nov 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 76.80%. Comparing base (b38e084) to head (0a781e0).
⚠️ Report is 190 commits behind head on develop.

Additional details and impacted files
@@             Coverage Diff             @@
##           develop    #4155      +/-   ##
===========================================
- Coverage    81.60%   76.80%   -4.81%     
===========================================
  Files           26       41      +15     
  Lines         9070    14203    +5133     
===========================================
+ Hits          7402    10908    +3506     
- Misses        1668     3295    +1627     
Flag Coverage Δ
python-3.13 76.80% <ø> (-4.81%) ⬇️

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.

@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

/review

@coderabbitai

coderabbitai Bot commented Nov 13, 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 merged commit 815c5ff into develop Nov 13, 2026
13 checks passed
@ptr727
ptr727 deleted the burndown/spec-registry-upstream-fixes branch November 13, 2026 17:19
ptr727 added a commit that referenced this pull request Nov 13, 2026
… Rules (#4189)

## Summary

Promotes the backlog-burndown rounds and changes from other hub sessions
from `develop` to `main`.

- Hooks and the prose gate: #4132, #4134, #4136, #4145, #4152, #4184.
The Husky hook reads its path list once and diffs a merge against
`MERGE_HEAD`. Interrupts re-raise their signal, a Markdown code span
reads as quoted data, and the gate picks a commit's diff base and
recognizes a conflicted promotion's branch cut from `main`.
- Procedures and carried rules: #4133, #4139, #4141, #4149, #4166,
#4177, #4179, #4183, #4185. Resync, audit and check-this-repo procedure
gaps, code style and shell interrupt rules, review-loop gaps across four
skills, the context and delegation section of `AGENTS.md`, question
rules in governance, the promotion line in pull request bodies,
closing-keyword behavior on promotion, and the history-rewrite premise.
- Review and cleanup tooling: #4138, #4148, #4154, #4156, #4157, #4163,
#4164, #4168, #4174, #4180. Cleanliness reads, parked handoffs, the
backlog report's JSON output, exact inline script pins, trusted inputs,
env-file includes, the bounded review wait, side-reviewer matching, and
a Copilot billing-failure notice read as a refusal.
- Workflow and runbook contract: #4153, #4155, #4169, #4171, #4178,
#4182. The runtime-secrets check, a registry entry and spec references,
the Copilot runbook pointers, credential-free checkout steps, and the
deploy-key and runner wording.
- From other hub sessions: #4159 (a repository's own .NET line under a
fleet default), #4161 (the 1Password CLI as an optional host tool),
#4162 (Codex's Windows installer and one managed opencode copy). These
carry no promotion line.

#4182 carries no promotion line by design, and #4175 holds the split-out
part of #4057's scope. Both #1448 and #4175 stay open.

Fixes #1071
Fixes #1154
Fixes #1391
Fixes #1471
Fixes #1594
Fixes #1620
Fixes #1627
Fixes #1650
Fixes #1801
Fixes #2853
Fixes #3620
Fixes #3668
Fixes #3697
Fixes #3766
Fixes #3787
Fixes #3837
Fixes #3840
Fixes #3842
Fixes #3844
Fixes #3865
Fixes #3882
Fixes #3890
Fixes #3894
Fixes #3912
Fixes #3916
Fixes #3954
Fixes #4014
Fixes #4015
Fixes #4016
Fixes #4043
Fixes #4050
Fixes #4057
Fixes #4058
Fixes #4062
Fixes #4084
Fixes #4097
Fixes #4098
Fixes #4099
Fixes #4104
Fixes #4108
Fixes #4114
Fixes #4115
Fixes #4117
Fixes #4118
Fixes #4119
Fixes #4121
Fixes #4122
Fixes #4123
Fixes #4131
Fixes #4135
Fixes #4140
Fixes #4142
Fixes #4143
Fixes #4144
Fixes #4151

🤖 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

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants