Repository navigation
Document the license gate and named vulnerability trust entries - #122
Merged
Merged
Conversation
The pull request check now reads a license gate from the cloud policy (scan_gate.licenses.deny, allow and unknown), and trust entries gain the scope license and a narrow vulnerability form that names vulnerability ids with an optional OpenVEX justification. The docs still said that the check fails on a risky license by a fixed rule, and listed three trust scopes. - pull-request-checks: add the license gate settings, how the gate decides OR, AND and WITH expressions, the default deny list of revision 2 and the spellings that now fail, and how-tos to deny a license, allow only some licenses, fail on an unknown license, waive the license findings of one package and waive one vulnerability. Replace the example policy block with the current test data and add the license and named vulnerability rows. - trust-a-package: add the license and named vulnerability scopes and the --vulnerability flag. - overview, package-rules, cloud-policy-settings, policy-resolution, policy-revisions: add the new scopes, settings, match rules, findings and change directions. - github, bitbucket-app, pmg/cloud-policy: say that the default policy sets the risky license list, that a tenant can change it, and that PMG ignores the new scopes and the license gate. - products.md: update the cloud policy facts for default policy revision 2. The license scope, --vulnerability and the license gate in policy edit need a safedep CLI release later than v0.10.0. The pages say so. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MhRi597EX9odoSDXbVBsxz
- An allow list fails only a known SPDX license that is not on the list, or NONE. A package with no license data or an unknown license passes under unknown: allow. Say so in pull-request-checks and in the settings reference, and say that unknown: fail allows only the listed licenses. - Cut the match rules and the default policy changes from the how-to. Keep the order of evaluation and link to the reference. Move the default deny list and the list of spellings that fail since default policy revision 2 into the License gate section of the reference. - github: the default policy also fails on nine GPL and AGPL licenses. - pull-request-checks: a waived named vulnerability with no justification shows the reason only on a private repository. - cloud-policy-settings: name the column of the stored violation name as rule_name in safedep query, table component_policy_violations, which shows it. - trust-a-package: the expansion of --scope all to license holds for a safedep CLI release later than v0.10.0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MhRi597EX9odoSDXbVBsxz
abhisek
marked this pull request as ready for review
November 9, 2026 06:48
SafeDep Report SummaryNo dependency changes detected. Nothing to scan. This report is generated by SafeDep GitHub App |
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
- Merge Shadow AI into Generate an AI BOM; remove AI Governance router - Merge Dependency Usage into Code Analysis - Merge Talk to SafeDep into Investigate with an AI Agent - Split Cloud SQL into a reference page and a Query with SQL how-to - Move Malware Analysis, Scan Catalog, vet FAQ, Build Your Own Queries - Add redirects for every old URL and update inbound links - Regenerate docs-ia.md section 7 from docs.json Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Move the merged AI BOM content to /governance/shadow-ai-detection - Title "Detect Shadow AI in Code"; sections Detect shadow AI, Generate the AI BOM - Restore the AI Visibility group; /governance/vet/ai-bom redirects here Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Restore /governance/ai-governance and its redirects - Restore the "Govern AI usage" card on the AI Agent Security overview Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts: # governance/cloud/overview.mdx # governance/cloud/quickstart.mdx # governance/shadow-ai-detection.mdx
- key not found fix: owner is pmg/cloud-policy, quickstart links to it - Cloud cooldown precedence: owner is pmg/cloud-policy settings table - Container CA trust: owner is kernel-enforcement, github-actions links to it Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Enforcement matrix: owner is the settings reference - Override steps: pull request checks links to Target a Group - Auth and sync errors: owner is Cloud Troubleshooting - vet credentials: inventory links to Authentication - Threat Intel JSON rules: owner is the schema page Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Main added sidebar titles (#123) and fixed factual errors (#124). Two files conflicted in the frontmatter only: - governance/cloud/policy/pull-request-checks.mdx: keep the title and description of this branch, which name the license gate, and add the sidebarTitle "Gate Pull Requests" from main. - governance/cloud/policy/trust-a-package.mdx: keep the description of this branch, which lists the scope license, and add the sidebarTitle "Trust a Package" from main. Main added no other text about trust scopes or license checks, so no other page needed an update. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MhRi597EX9odoSDXbVBsxz
# Conflicts: # governance/cloud/policy/overview.mdx # reference/cloud-policy-settings.mdx
- Move the waive how-tos and the OpenVEX table to Trust a Package - Link to the reference for defaults, match rules, findings and looser or stricter changes - Replace the project sync command with a link to Label projects Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Say that the policy commands need a CLI release later than v0.10.0 - Say that a list is compared with the list below it - Add the Rule cell and the Reported result to the license findings - Say that rule create does not accept --scope named-vulnerability Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts: # governance/vet/code-analysis.mdx
Sahilb315
changed the base branch from
refactor/dedupe-pmg-blocks
to
refactor/land-dedupe-blocks
November 10, 2026 08:42
…o claude/pensive-sagan-3x8any-vuln-license-docs
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Put each CLI version note before the first command on its page - Say that the no-value rule does not apply to license lists - Say that a justification is split off only when it is a known name - Name the license gate as part of the scan gate - Point the GitHub App page to Risky Licenses, not "above" - Make the CLI version line in products.md complete Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts: # governance/cloud/policy/overview.mdx # reference/cloud-policy-settings.mdx
- Remove the notes on trust-a-package and pull-request-checks - products.md: the policy commands need safedep CLI v0.11.0 or later 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>
arunanshub
approved these changes
Nov 11, 2026
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.



Summary
This PR documents three Cloud Policy features of the SafeDep pull request check. The spec is
docs/specs/2026-11-07-policy-vulnerability-and-license-rules-design.mdin safedep/control-tower, on the contract from safedep/api#265.scan_gate.licensessetting has three parts: adenylist, anallowlist (an empty list turns it off), andunknown(allow,reportorfail). A tenant's list replaces the SafeDep default list. SafeDep default policy revision 2 denies nine GPL and AGPL ids, sets no allow list, and setsunknowntoallow.license. It waives the license findings of one package.--scope vulnerability --vulnerability ID[:justification]waives only the listed ids and their aliases. Each id can carry an optional OpenVEX justification.Pages
governance/cloud/policy/pull-request-checks.mdx:governance/cloud/policy/trust-a-package.mdx,overview.mdxandconcepts/package-rules.mdx: the new scopes. PMG ignores them.reference/cloud-policy-settings.mdx:scan_gate.licenses.*settings;vulnerabilitiesfield of a package rule;concepts/policy-resolution.mdx,concepts/policy-revisions.mdx,governance/integrations/github.mdx,governance/integrations/bitbucket-app.mdxandpackage-security/pmg/cloud-policy.mdx: statements that the change makes wrong..claude/skills/writing-safedep-docs/products.md: the default policy revision is now 2.Merge after
This PR is open for internal review and testing. Do not merge it until both of these are done:
Checks
dry/policy/spdxlicense.mintlify broken-linksreports only the three knownessentials/failures.Changes after the docs cleanup
The duplicated-block cleanup is on
main(#127). This PR targetsmainagain.reference/cloud-policy-settings.mdxandgovernance/cloud/policy/overview.mdx. The new scopes are rows in the new package rule table.pull-request-checks.mdxtotrust-a-package.mdx.Reportedresult.rule createdoes not accept--scope named-vulnerability.🤖 Generated with Claude Code
https://claude.ai/code/session_01MhRi597EX9odoSDXbVBsxz