Skip to content

Name the Undeclared Root Default Beside the uv Workspace Exception - #3564

Merged
ptr727 merged 1 commit into
developfrom
feature/3548-undeclared-root-default
Oct 28, 2026
Merged

ptr727 merged 1 commit into
developfrom
feature/3548-undeclared-root-default

Conversation

@ptr727

@ptr727 ptr727 commented Oct 28, 2026

Copy link
Copy Markdown
Owner

Summary

Promotion fix for threads PRRT_kwDOQ5caqM6w--qp and PRRT_kwDOQ5caqM6w--q2 on #3562.

Both texts said every Python directory is declared in python-directories, except a uv workspace. They left out the undeclared-root default. With no declaration, the validator gates the root only where a root pyproject.toml is tracked, per WORKFLOW.md D1.2.

  • .agents/skills/python-codestyle/SKILL.md "Two profiles" paragraph now states that default beside the uv workspace exception.
  • spec/project-types.json python.profileNote states it too.
  • Both use the wording references/profiles.md already carries.
  • The generated python-codestyle copies are regenerated with scripts/build_dist.py.

Verification

  • python3 spec/validate.py passes.
  • tests/test_spec_validate.py, tests/test_audit_helpers.py, and tests/test_build_dist.py pass.
  • scripts/build_dist.py --check reports the generated distributions current.

Pre-existing findings, filed

Pre-existing findings, not filed

  • spec/project-types.json:38 (pre-existing): python.profileNote cites "CODESTYLE.md Python 'Two profiles'", a heading only the python-codestyle Skill carries. catalog/snippets/pre-commit/README.md:11 has the same pointer.

Closes on promotion: #3548, #3552

🤖 Generated with Claude Code

The python-codestyle "Two profiles" paragraph and the spec's python
profileNote said every Python directory is declared, except a uv
workspace. The validator also gates an undeclared root where a root
pyproject.toml is tracked, per WORKFLOW.md D1.2. Both texts now state
that default, matching references/profiles.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings October 28, 2026 04:46
@coderabbitai

coderabbitai Bot commented Oct 28, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration
  • 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 28, 2026

Copy link
Copy Markdown
Owner Author

A recorded local strict-review pass covers head e72bee2b34b48ed99836237e359da14ef64d95a4, the content this pull request carries at that commit against develop, and it recorded 2 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.

🟢 Approval recommended

No active review issues remain, with the validator rule, specification, distributed Skill copies, and source digest updated together.

No open issues 🎉

What changed in this PR

This pull request clarifies the undeclared-root default for Python validation, updates the project specification, and regenerates the distributed Skill copies and source digest.

Changes:

  • Documents that an undeclared repository root is gated only when it tracks a root pyproject.toml.
  • Updates python.profileNote to match the documented validator behavior.
  • Regenerates the GitHub and Claude Skill distributions.
  • Updates the source digest for the regenerated Skill.
File Description
spec/​project-types.json Adds the undeclared-root validation rule to the Python profile specification.
.github/​skills/​python-codestyle/​SKILL.md Regenerated GitHub Copilot Skill guidance.
.claude-plugin/​fleet-skills/​skills/​python-codestyle/​SKILL.md Regenerated Claude Skill guidance.
.claude-plugin/​fleet-skills/​.source-digests/​python-codestyle Records the updated canonical Skill digest.
.agents/​skills/​python-codestyle/​SKILL.md Updates the canonical Python Skill with the undeclared-root gating rule.

Review effort: Lite

@codecov

codecov Bot commented Oct 28, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.50%. Comparing base (d2b8bab) to head (e72bee2).

Additional details and impacted files
@@           Coverage Diff            @@
##           develop    #3564   +/-   ##
========================================
  Coverage    81.50%   81.50%           
========================================
  Files           26       26           
  Lines         9066     9066           
========================================
  Hits          7389     7389           
  Misses        1677     1677           
Flag Coverage Δ
python-3.13 81.50% <ø> (ø)

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 merged commit dd78a8a into develop Oct 28, 2026
14 checks passed
@ptr727
ptr727 deleted the feature/3548-undeclared-root-default branch October 28, 2026 04:57
ptr727 added a commit that referenced this pull request Oct 28, 2026
… AGENTS.md and WORKFLOW.md Sentence Length (#3562)

## Summary

Promotes `develop` to `main`, carrying round 3 of the resync-issue
burndown:

- #3557: the python-codestyle skill, `profiles.md` "Adapt before
propagating", `spec/type-model.md` and `spec/project-types.json` state
the per-directory Python profile rule. The skill names the root-gating
condition.
- #3558: the digest prints the run-log reading inside its Copilot
refusal block. The block's fixed sentence holds for quota, transient,
and file-count refusals.
- #3559: every sentence in `AGENTS.md` is 25 words or fewer, and all but
one in `.github/copilot-instructions.md`. The two remaining
`GOVERNANCE.md` sentences, and their copies, are shortened too.
- #3561: every sentence in `WORKFLOW.md` is 25 words or fewer. Guarantee
IDs, tables, and code are byte-identical.
- #3564: promotion fix for Copilot's two findings on this pull request.
The python-codestyle skill and the `python.profileNote` name the
undeclared-root default.
- #3565: Dependabot bumps `DavidAnson/markdownlint-cli2-action` from
24.2.0 to 25.0.0. It merged into `develop` while this pull request was
open.

The #3559 and #3561 slices continue the #3531 cleanup and do not close
it. Carried `AGENTS.md`, `WORKFLOW.md`, and Copilot-instructions text
changes wording, so each fleet repository's verbatim copy differs from
the hub until its next resync.

Fixes #3541
Fixes #3548
Fixes #3550
Fixes #3552
Fixes #3554

🤖 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