Skip to content

feat(github): add declarative label management#953

Merged
katriendg merged 6 commits intomicrosoft:mainfrom
AhmedMustafa249:feat/declarative-gitHub-label-management
Mar 11, 2026
Merged

feat(github): add declarative label management#953
katriendg merged 6 commits intomicrosoft:mainfrom
AhmedMustafa249:feat/declarative-gitHub-label-management

Conversation

@AhmedMustafa249
Copy link
Copy Markdown
Contributor

Description

Added declarative GitHub label management to the repository. .github/labels.yml defines all 62 live repository labels as code — 60 canonical entries organized into five comment-annotated groups (Type, Area, Priority, Status/Process, and Release Management), with aliases on the instructions and prompts labels consolidating the legacy instruction-file and prompt labels respectively. .github/workflows/label-sync.yml syncs labels additively using EndBug/label-sync v2.3.3, triggered on push to main when either file changes and on workflow_dispatch.

Labels are synced in additive mode (delete-other-labels: false), which means no existing label is deleted until the file is the authoritative source. The alias entries migrate existing issue and PR assignments from the legacy labels to their canonical counterparts on first sync run.

Both action references are SHA-pinned to full 40-character commit SHAs per repository convention.

Related Issue(s)

Closes #518

Type of Change

Select all that apply:

Code & Documentation:

  • Bug fix (non-breaking change fixing an issue)
  • New feature (non-breaking change adding functionality)
  • Breaking change (fix or feature causing existing functionality to change)
  • Documentation update

Infrastructure & Configuration:

  • GitHub Actions workflow
  • Linting configuration (markdown, PowerShell, etc.)
  • Security configuration
  • DevContainer configuration
  • Dependency update

Other:

  • Script/automation (.ps1, .sh, .py)
  • Other (please describe):

Testing

Ran the workflow on the forked repository after merging to main

Workflow output:

Run EndBug/label-sync@52074158190acb45f3077f9099fea818aa43f97a

Checking inputs...
  🛈 Current config mode: local
  ✓ Inputs are valid
.github/labels.yml

Reading config file...
  🛈 Reading file...
  🛈 Parsing YAML file...
  ✓ File parsed successfully.
  🛈 Parsed config:
  [
    {
      "name": "bug",
      "color": "d73a4a",
      "description": "Something isn't working"
    },
    {
      "name": "breaking-change",
      "color": "B60205",
      "description": "Breaking change requiring major version bump"
    },
    
    ...

    (Remaining labels)
  ]

Syncing labels...
  ✓ Sync successful

Label diff
  
  feature [missing]
  ☀️  → feature
  ☀️  → #1D76DB
  ☀️  → New feature triggering minor version bump
  
  maintenance [missing]
  ☀️  → maintenance
  ☀️  → #FBCA04
  ☀️  → Maintenance work, no version bump
  
  refactor [missing]
  ☀️  → refactor
  ☀️  → #ededed
  ☀️  → Code refactoring without functional changes
  
  performance [missing]
  ☀️  → performance
  ☀️  → #0E8A16
  ☀️  → Performance improvement
  
  security [missing]
  ☀️  → security
  ☀️  → #D93F0B
  ☀️  → Security improvement or fix

Checklist

Required Checks

  • Documentation is updated (if applicable)
  • Files follow existing naming conventions
  • Changes are backwards compatible (if applicable)
  • Tests added for new functionality (if applicable)

AI Artifact Contributions

  • Used /prompt-analyze to review contribution
  • Addressed all feedback from prompt-builder review
  • Verified contribution follows common standards and type-specific requirements

Required Automated Checks

The following validation commands must pass before merging:

  • Markdown linting: npm run lint:md
  • Spell checking: npm run spell-check (N/A — no prose markdown files changed)
  • Frontmatter validation: npm run lint:frontmatter (N/A — no instruction, prompt, or agent files changed)
  • Skill structure validation: npm run validate:skills (N/A — no skill files changed)
  • Link validation: npm run lint:md-links (N/A — no markdown files changed)
  • PowerShell analysis: npm run lint:ps (N/A — no PowerShell files changed)
  • Plugin freshness: npm run plugin:generate (N/A — no collection files changed)

Security Considerations

  • This PR does not contain any sensitive or NDA information
  • Any new dependencies have been reviewed for security issues
  • Security-related scripts follow the principle of least privilege

Additional Notes

The workflow uses GITHUB_TOKEN — no new secrets are required. The token is already available in all Actions runs.

Two additional workflow-level validations were confirmed:

  • SHA pinning: Both actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v4.2.2 and EndBug/label-sync@52074158190acb45f3077f9099fea818aa43f97a # v2.3.3 are pinned to full 40-character commit SHAs with version comments.
  • Permissions: contents: read declared at workflow level; issues: write granted only at job level, following the principle of least privilege.

- Add .github/labels.yml declaring all 62 repository labels as code with aliases consolidating legacy instruction-file and prompt labels.

- Add .github/workflows/label-sync.yml using EndBug/label-sync v2.3.3 to sync labels additively on push to main (path-filtered) and workflow_dispatch.
@AhmedMustafa249 AhmedMustafa249 requested a review from a team as a code owner March 9, 2026 20:53
Copy link
Copy Markdown
Contributor

@katriendg katriendg left a comment

Choose a reason for hiding this comment

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

Thanks @AhmedMustafa249 for picking up another issue, it's looking very good other than a few minor comments which will complete the PR and make it ready for merging.

- correct refactor, security, and stale label colors/descriptions to match live repo
- add comment block to labels.yml documenting add, rename, and delete workflows
- add Label Management section to README with task reference table
- update checkout version comment to v6.0.2
@AhmedMustafa249
Copy link
Copy Markdown
Contributor Author

@katriendg I've addressed all the comments. For the documentation on adding and updating labels, I added a comment block at the top of the workflow file and also included it in the README.

@katriendg
Copy link
Copy Markdown
Contributor

@AhmedMustafa249 - looking really good - top of my head I believe your table formatting is not going to pass linting. Could you run npm run format:tables?

@AhmedMustafa249
Copy link
Copy Markdown
Contributor Author

@katriendg Done

Copy link
Copy Markdown
Contributor

@katriendg katriendg left a comment

Choose a reason for hiding this comment

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

Thanks - merging this one.

@katriendg katriendg merged commit a1a6845 into microsoft:main Mar 11, 2026
25 checks passed
WilliamBerryiii added a commit that referenced this pull request Mar 12, 2026
- adopt Flagship Collection naming from PR #965
- upgrade agent bundle selection callout to IMPORTANT
- restore Label Management section from PR #953
WilliamBerryiii pushed a commit that referenced this pull request Mar 12, 2026
Added declarative GitHub label management to the repository.
*`.github/labels.yml`* defines all 62 live repository labels as code —
60 canonical entries organized into five comment-annotated groups (Type,
Area, Priority, Status/Process, and Release Management), with aliases on
the `instructions` and `prompts` labels consolidating the legacy
`instruction-file` and `prompt` labels respectively.
*`.github/workflows/label-sync.yml`* syncs labels additively using
**EndBug/label-sync v2.3.3**, triggered on push to `main` when either
file changes and on `workflow_dispatch`.

> Labels are synced in additive mode (`delete-other-labels: false`),
which means no existing label is deleted until the file is the
authoritative source. The alias entries migrate existing issue and PR
assignments from the legacy labels to their canonical counterparts on
first sync run.

Both action references are SHA-pinned to full 40-character commit SHAs
per repository convention.

## Related Issue(s)

Closes #518

## Type of Change

Select all that apply:

**Code & Documentation:**

* [ ] Bug fix (non-breaking change fixing an issue)
* [x] New feature (non-breaking change adding functionality)
* [ ] Breaking change (fix or feature causing existing functionality to
change)
* [ ] Documentation update

**Infrastructure & Configuration:**

* [x] GitHub Actions workflow
* [ ] Linting configuration (markdown, PowerShell, etc.)
* [ ] Security configuration
* [ ] DevContainer configuration
* [ ] Dependency update

**Other:**

* [ ] Script/automation (`.ps1`, `.sh`, `.py`)
* [ ] Other (please describe):

## Testing

Ran the workflow on the forked repository after merging to main

### Workflow output:

```
Run EndBug/label-sync@5207415

Checking inputs...
  🛈 Current config mode: local
  ✓ Inputs are valid
.github/labels.yml

Reading config file...
  🛈 Reading file...
  🛈 Parsing YAML file...
  ✓ File parsed successfully.
  🛈 Parsed config:
  [
    {
      "name": "bug",
      "color": "d73a4a",
      "description": "Something isn't working"
    },
    {
      "name": "breaking-change",
      "color": "B60205",
      "description": "Breaking change requiring major version bump"
    },
    
    ...

    (Remaining labels)
  ]

Syncing labels...
  ✓ Sync successful

Label diff
  
  feature [missing]
  ☀️  → feature
  ☀️  → #1D76DB
  ☀️  → New feature triggering minor version bump
  
  maintenance [missing]
  ☀️  → maintenance
  ☀️  → #FBCA04
  ☀️  → Maintenance work, no version bump
  
  refactor [missing]
  ☀️  → refactor
  ☀️  → #ededed
  ☀️  → Code refactoring without functional changes
  
  performance [missing]
  ☀️  → performance
  ☀️  → #0E8A16
  ☀️  → Performance improvement
  
  security [missing]
  ☀️  → security
  ☀️  → #D93F0B
  ☀️  → Security improvement or fix
```

## Checklist

### Required Checks

* [ ] Documentation is updated (if applicable)
* [x] Files follow existing naming conventions
* [x] Changes are backwards compatible (if applicable)
* [ ] Tests added for new functionality (if applicable)

### AI Artifact Contributions
<!-- If contributing an agent, prompt, instruction, or skill, complete
these checks -->
* [ ] Used `/prompt-analyze` to review contribution
* [ ] Addressed all feedback from `prompt-builder` review
* [ ] Verified contribution follows common standards and type-specific
requirements

### Required Automated Checks

The following validation commands must pass before merging:

* [x] Markdown linting: `npm run lint:md`
* [ ] Spell checking: `npm run spell-check` (N/A — no prose markdown
files changed)
* [ ] Frontmatter validation: `npm run lint:frontmatter` (N/A — no
instruction, prompt, or agent files changed)
* [ ] Skill structure validation: `npm run validate:skills` (N/A — no
skill files changed)
* [ ] Link validation: `npm run lint:md-links` (N/A — no markdown files
changed)
* [ ] PowerShell analysis: `npm run lint:ps` (N/A — no PowerShell files
changed)
* [ ] Plugin freshness: `npm run plugin:generate` (N/A — no collection
files changed)

## Security Considerations
<!-- ⚠️ WARNING: Do not commit sensitive information such as API keys,
passwords, or personal data -->
* [x] This PR does not contain any sensitive or NDA information
* [x] Any new dependencies have been reviewed for security issues
* [x] Security-related scripts follow the principle of least privilege

## Additional Notes

The workflow uses `GITHUB_TOKEN` — no new secrets are required. The
token is already available in all Actions runs.

Two additional workflow-level validations were confirmed:

* **SHA pinning**: Both
`actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v4.2.2` and
`EndBug/label-sync@52074158190acb45f3077f9099fea818aa43f97a # v2.3.3`
are pinned to full 40-character commit SHAs with version comments.
* **Permissions**: `contents: read` declared at workflow level; `issues:
write` granted only at job level, following the principle of least
privilege.
WilliamBerryiii added a commit that referenced this pull request Mar 20, 2026
🤖 I have created a release *beep* *boop*
---


##
[3.2.0](hve-core-v3.1.46...hve-core-v3.2.0)
(2026-03-20)


### ✨ Features

* add -OutputPath parameter to Validate-MarkdownFrontmatter.ps1
([#1134](#1134))
([fdf1bcf](fdf1bcf)),
closes [#1006](#1006)
* add action version consistency scan workflow
([#1127](#1127))
([4229df1](4229df1))
* **agent:** MVE Experiment Designer
([#976](#976))
([70f86ca](70f86ca))
* **agents:** add ADO Backlog Manager orchestrator agent
([#800](#800))
([fae3987](fae3987))
* **agents:** add meeting analyst agent for transcript analysis using
work-iq ([#502](#502))
([5345b5b](5345b5b))
* **agents:** add quick-reference line to RPI Phase 5 suggestions
([#897](#897))
([9a90f39](9a90f39))
* **agents:** add RAI Planner, enhance SSSC Planner, and redesign
Security Planner
([#979](#979))
([06f826c](06f826c))
* **agents:** add symmetric cross-system handoff to GitHub Backlog
Manager ([#952](#952))
([ba34a35](ba34a35))
* **agents:** Functional Code Review Agent — pre-PR functional
correctness reviewer
([#733](#733))
([9cf63b7](9cf63b7))
* **build:** add Python extensions and uv 0.10.8 to devcontainer
([#920](#920))
([9ca0579](9ca0579))
* **build:** add uv ecosystem to Dependabot configuration
([#913](#913))
([2a4bd39](2a4bd39))
* **build:** enable npm pinning enforcement in dependency scan
([#838](#838))
([4e9e31f](4e9e31f))
* **build:** migrate attestation actions to v4.1.0 and add SBOM
verification docs
([#841](#841))
([ca1e65b](ca1e65b))
* **collections:** add four new validator checks (orphan, duplicate,
companion, coverage)
([#869](#869))
([1a96b73](1a96b73))
* **devcontainer,security:** add enterprise artifact hub configuration
([#1032](#1032))
([1d56d25](1d56d25))
* **docs:** add Rust coding standards and guidelines
([#809](#809))
([d4c4899](d4c4899))
* **extension:** add Microsoft logo icon to VS Code Marketplace listings
([#906](#906))
([82aca41](82aca41))
* **github:** add declarative label management
([#953](#953))
([a1a6845](a1a6845))
* **instructions:** add ADO backlog shared infrastructure
([#786](#786))
([1914078](1914078))
* **instructions:** add ADO backlog sprint planning and capacity
tracking ([#788](#788))
([d6fb77d](d6fb77d))
* **instructions:** add ADO triage workflow and prompt
([#787](#787))
([cde0190](cde0190))
* **instructions:** add shared story quality conventions and sprint
planning ([#803](#803))
([a2f18e3](a2f18e3))
* **prompts:** add ADO discovery and work item prompts with agent
routing ([#790](#790))
([7e74523](7e74523))
* **prompts:** add security review prompts
([#1118](#1118))
([ad30967](ad30967))
* **scripts:** add dynamic Python skill discovery for lint/test
([#957](#957))
([0a90f57](0a90f57))
* **scripts:** add Get-StandardTimestamp utility to CIHelpers module
([#1126](#1126))
([b273a4b](b273a4b))
* **scripts:** add Python copyright header validation
([#905](#905))
([67df902](67df902))
* **scripts:** add Python skill support to Validate-SkillStructure
([#903](#903))
([68479d9](68479d9))
* **scripts:** add workflow npm command scanning to dependency pinning
([#837](#837))
([6b5ae06](6b5ae06))
* **security:** add basic security reviewer agent with owasp skills
([#1008](#1008))
([cb1fd05](cb1fd05))
* **security:** add sigstore attestation bundles and fix
component-detection action
([#1148](#1148))
([f79c272](f79c272))
* **skills:** add Atheris fuzz harness with CI workflow integration
([#1102](#1102))
([d337e1d](d337e1d))
* **skills:** add PowerPoint automation skill with YAML-driven deck
generation ([#868](#868))
([00465cd](00465cd))
* **skills:** convert hve-core-installer agent to self-contained skill
([#846](#846))
([1d821fb](1d821fb))
* **skills:** enhance pr-reference skill with flexible filtering and
base branch detection
([#1095](#1095))
([26a32ea](26a32ea))
* **workflows:** add devcontainer infrastructure change log workflow
([#899](#899))
([8aca446](8aca446))
* **workflows:** add milestone auto-close on stable and pre-release
publishes ([#834](#834))
([79362b1](79362b1))
* **workflows:** add ms.date documentation freshness checking
([#969](#969))
([3ed441c](3ed441c))
* **workflows:** add Python linting CI workflow with Ruff
([#951](#951))
([f89f0eb](f89f0eb))
* **workflows:** add Python testing CI workflow with pytest and Codecov
([#934](#934))
([5e8306f](5e8306f))
* **workflows:** add uv and Python package sync to copilot-setup-steps
([#921](#921))
([45d517d](45d517d))


### 🐛 Bug Fixes

* **build:** override Linguist vendored flag for Python skill files
([#1155](#1155))
([0eee5b6](0eee5b6))
* **build:** override serialize-javascript to &gt;=7.0.3 for RCE fix
([#876](#876))
([e49039a](e49039a))
* **build:** resolve Pinned-Dependencies alerts for vsce npm commands in
extension workflows
([#782](#782))
([89dad9d](89dad9d))
* **build:** update undici and yauzl overrides for security audit
([#1030](#1030))
([2c2f92f](2c2f92f))
* **docs:** add CLI Plugins to install.md navigation surfaces
([#902](#902))
([79d6595](79d6595))
* **docs:** add sidebar ordering for Design Thinking documentation
([#832](#832))
([551fddc](551fddc)),
closes [#830](#830)
* **docs:** graduate design-thinking to preview and correct stale
collection references
([#831](#831))
([5110e35](5110e35))
* **docs:** include project-planning in UX Designer install guidance
([#908](#908))
([e7aa9bc](e7aa9bc))
* **docs:** remediate writing-style convention violations
([#865](#865))
([68b04bc](68b04bc))
* **docs:** remove draft content announcement banner
([#825](#825))
([b45de80](b45de80))
* **docs:** remove unbounded path-to-regexp override breaking SSG
([#1153](#1153))
([d810018](d810018))
* **docs:** use actual clone paths instead of folder display names in
multi-root workspace settings
([#984](#984))
([5dbab82](5dbab82))
* **instructions:** replace black with ruff in uv-projects
([#898](#898))
([b0c06d9](b0c06d9))
* **scripts:** cover .github/ skill files in copyright header validation
([#1055](#1055))
([#1098](#1098))
([27fbd33](27fbd33))
* **scripts:** eliminate phantom git changes from plugin generation
([#1035](#1035))
([e49a1b5](e49a1b5))
* **scripts:** enable JSON log output for lint:version-consistency
([#1033](#1033))
([52b0885](52b0885))
* **security:** calculate compliance score from total scanned
dependencies ([#930](#930))
([c112c3d](c112c3d))
* **skills:** add AST validation and namespace restriction for
content-extra.py
([#1027](#1027))
([c50c7a3](c50c7a3))
* **skills:** add depth limits to recursive PowerPoint processing
functions ([#1028](#1028))
([bf08994](bf08994))
* **skills:** harden XML parsing and blob writes in powerpoint extract
([#1053](#1053))
([89d24b1](89d24b1))
* **skills:** resolve ruff lint and format violations in powerpoint
skill ([#1048](#1048))
([17bbe7a](17bbe7a))
* **workflows:** add uv.lock dependencies submission have fork-skip
condition ([#1109](#1109))
([dec56ac](dec56ac))
* **workflows:** automate weekly SHA staleness check with issue creation
([#975](#975))
([1ea4caa](1ea4caa))
* **workflows:** close Codecov integration gaps for Pester and pytest
flags ([#1106](#1106))
([cca29b7](cca29b7))
* **workflows:** propagate uv sync errors in copilot-setup-steps
([#961](#961))
([df88d7c](df88d7c))
* **workflows:** resolve release-please skip cascade and Python project
discovery ([#1043](#1043))
([79993e2](79993e2))
* **workflows:** scan only commit subjects for breaking change detection
([#1157](#1157))
([a38a657](a38a657))


### 📚 Documentation

* clarify HVE Core Extension vs Installer messaging across documentation
([#965](#965))
([0fceb8f](0fceb8f))
* **docs:** add ADO integration user documentation
([#935](#935))
([ec89302](ec89302))
* **docs:** add Project Planning agent documentation
([#936](#936))
([3a3a0fd](3a3a0fd))
* **onboarding:** overhaul marketplace onboarding and documentation site
([#982](#982))
([4309e10](4309e10))


### ♻️ Refactoring

* **build:** merge code-review collection into coding-standards
([#863](#863))
([8027e7b](8027e7b))
* **workflows:** rename release pipeline workflows and add marketplace
automation triggers
([#829](#829))
([b6397f4](b6397f4))


### 🔧 Maintenance

* **build:** add clean:logs npm script
([#1122](#1122))
([f85fe02](f85fe02)),
closes [#988](#988)
* **build:** add JSON reporter for cspell
([#1123](#1123))
([6d59f67](6d59f67))
* **ci:** add multi-arch support to copilot-setup-steps binary downloads
([#955](#955))
([8d0c706](8d0c706))
* **deps-dev:** bump cspell from 9.6.4 to 9.7.0 in the npm-dependencies
group ([#839](#839))
([3fa16ff](3fa16ff))
* **deps:** bump actions/dependency-review-action from 4.8.3 to 4.9.0 in
the github-actions group across 1 directory
([#942](#942))
([1a9b858](1a9b858))
* **deps:** bump cairosvg from 2.8.2 to 2.9.0 in
/.github/skills/experimental/powerpoint
([#1025](#1025))
([f4deda7](f4deda7))
* **deps:** bump dompurify from 3.3.1 to 3.3.2 in /docs/docusaurus
([#924](#924))
([d2060d6](d2060d6))
* **deps:** bump svgo from 3.3.2 to 3.3.3 in /docs/docusaurus
([#880](#880))
([6dc2406](6dc2406))
* **deps:** bump the github-actions group across 1 directory with 4
updates ([#1100](#1100))
([2290dc0](2290dc0))
* **deps:** bump the github-actions group with 6 updates
([#840](#840))
([f57bc01](f57bc01))
* **docs:** correct New-MsDateReport table rendering and refresh stale
docs ([#1114](#1114))
([c2b806f](c2b806f))
* **settings:** remove orphaned Checkov config and stale gitignore
entries ([#870](#870))
([98fcd74](98fcd74))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

---------

Co-authored-by: hve-core-release-please[bot] <254602402+hve-core-release-please[bot]@users.noreply.github.com>
Co-authored-by: Bill Berry <wberry@microsoft.com>
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.

feat(github-metadata): add declarative label management with labels.yml

2 participants