Skip to content

Add Copilot review instructions for OSS license files#300954

Merged
benvillalobos merged 2 commits intomicrosoft:mainfrom
benvillalobos:bv/oss-tool-instructions
Mar 12, 2026
Merged

Add Copilot review instructions for OSS license files#300954
benvillalobos merged 2 commits intomicrosoft:mainfrom
benvillalobos:bv/oss-tool-instructions

Conversation

@benvillalobos
Copy link
Member

@benvillalobos benvillalobos commented Mar 12, 2026

Adds path-scoped .instructions.md for ThirdPartyNotices.txt, cglicenses.json, and cgmanifest.json. Teaches Copilot code review what to verify when reviewing automated OSS tool PRs.

Part of the OSS Tool Automation V0 — see vscode-engineering#2023 for the full spec.

Related to #300158

Path-scoped instructions for ThirdPartyNotices.txt, cglicenses.json,
and cgmanifest.json. Teaches Copilot code review what to verify when
reviewing automated OSS tool PRs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 12, 2026 00:19
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a path-scoped Copilot instruction file to guide reviews of automated OSS compliance outputs (ThirdPartyNotices / CG manifest files) as part of OSS Tool Automation V0.

Changes:

  • Add .github/instructions/oss.instructions.md with review checks and red flags for ThirdPartyNotices.txt, cli/ThirdPartyNotices.txt, cglicenses.json, and cgmanifest.json.
Comments suppressed due to low confidence (2)

.github/instructions/oss.instructions.md:26

  • The cgmanifest.json checklist says license identifiers should use SPDX format, but cgmanifest.json already contains non‑SPDX values like LGPL-2.1+, OTHER, and free-form strings (e.g. "MIT and Creative Commons Attribution 4.0"). As written, this will cause noisy reviews even when changes are unrelated. Suggest narrowing this to "ensure license values follow the schema/tool expectations" and/or only flag newly introduced unknown/placeholder license strings.
- Package versions match what's actually installed
- Repository URLs are valid and point to real source repositories
- License identifiers use SPDX format and match the corresponding ThirdPartyNotices.txt entries

.github/instructions/oss.instructions.md:31

  • The "Any copyleft license (GPL, LGPL, AGPL) — flag immediately" red flag will always trigger for cgmanifest.json because it already includes LGPL entries (e.g. ffmpeg). To avoid permanent false positives, this should be scoped to newly added/changed components or require checking against an allowlist/known exceptions.
- Any copyleft license (GPL, LGPL, AGPL) — flag immediately
- Any "UNKNOWN" or placeholder license text

You can also share your feedback on Copilot code review. Take the survey.

- Copyleft flag now only applies to newly added entries (existing
  LGPL entries like ffmpeg are pre-approved)
- SPDX format check softened to 'where possible' since cgmanifest
  already contains non-SPDX values like OTHER

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@benvillalobos benvillalobos marked this pull request as ready for review March 12, 2026 00:54
@vs-code-engineering vs-code-engineering bot added this to the 1.112.0 milestone Mar 12, 2026
@benvillalobos benvillalobos merged commit 4f6fa90 into microsoft:main Mar 12, 2026
18 checks passed
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.

3 participants