docs(oss-harden): update Code Quality for general availability - #85
Merged
Conversation
The Code Quality paragraph was written during the public preview. It says the
product must be turned on per repository or organization, which reads as a
switch every reader has. Code Quality reaches organization-owned repositories
on GitHub Team or GitHub Enterprise Cloud only, so a user-owned repository
cannot enable it at all, and that filter settles most cases before cost or
syntax matters. Its cost also stopped being deferred on 2026-07-20.
GitHub now documents the code quality REST endpoints, so the prohibition on
adding the rule where the product is off becomes a command a reader can run.
`GET /repos/{owner}/{repo}/code-quality/setup` answers `configured`,
`not-configured`, or 404 for a repository the plan excludes.
The rulesets REST schema still documents `code_scanning` and no code quality
rule, so that caution stands as written.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
skills/oss-harden/references/github.mdstates the availability filter for GitHub Code Quality first: organization-owned repositories on GitHub Team or GitHub Enterprise Cloud, not GitHub Enterprise Server, and never a user-owned repository. The paragraph said only that the product must be turned on per repository or organization, which reads as a switch every reader has.code_qualityruleset rule where the product is off becomes a readback:gh api repos/{owner}/{repo}/code-quality/setupanswersstateofconfiguredornot-configured, or 404 for a repository the plan or the ownership excludes. Add the rule only onconfigured.AGENTS.mdrecords why this repository's 404 cannot resolve.svyatov/oss-kitis user-owned, so the general availability announcement does not change it, and nothing short of moving to an organization on one of those plans warrants restoring the rule.Why this way
The availability limit is the cheapest check a reader can apply, so it goes before the cost and the JSON. Somebody reading the old paragraph on a personal repository would price the product and write the rule before finding out that neither applies.
No rule in
STANDARD.mdchanges. R-SEC-09 asks for static analysis on pull requests and CodeQL with thecode_scanningrule satisfies it. Code Quality is a paid maintainability product most audited repositories cannot buy, so a rule requiring it would fail every solo and Free-plan project by construction.Verification
gh api repos/svyatov/oss-kit/code-quality/setupanswers404 Code quality is not available for this repository, andgh api repos/svyatov/oss-kit --jq .owner.typeanswersUser, both on 2026-08-11. Thecode_qualityrule is still absent from the rulesets REST schema, which listscode_scanning,copilot_code_review, andlicense_compliance_scanning. The setup response fields come from the code quality REST reference.Affects