Skip to content

Enable reviewed catalog icon declarations - #79

Merged
aphansal123 merged 16 commits into
mainfrom
aphansal123-curated-resource-icons
Oct 14, 2026
Merged

aphansal123 merged 16 commits into
mainfrom
aphansal123-curated-resource-icons

Conversation

@aphansal123

@aphansal123 aphansal123 commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

Resolves github/copilot-ecosystem#1624

This pull request introduces support for reviewed resource icons in the catalog, including the infrastructure for validating, declaring, and applying curated icon assets to catalog entries. It also updates documentation and workflow automation to support and enforce these changes. The main themes are: icon overlay and validation, workflow and documentation updates, and codebase changes for icon handling.

Reviewed icon support and validation:

  • Added a new catalog-icons.json overlay file to declare optional reviewed icons for both contributor-managed and registry-imported resources, using exact urn:air: identifiers and optional versions. The overlay includes provenance, permission, and SHA-256 verification for each asset.
  • Implemented strict validation for icon assets: only static PNGs under 256 KiB and 512x512 pixels are allowed, with enforced asset paths, commit-pinned HTTPS URLs, and provenance requirements. Validation ensures no symlinks, duplicate/overlapping declarations, or invalid references.

Catalog generation and codebase updates:

  • Updated scripts/generate_ai_catalog.py to load, validate, and apply icon declarations from the overlay, injecting curated icon URLs into generated catalog entries' metadata. Direct icon metadata in source entries is now rejected; only the overlay can supply it.
  • Added a Pillow dependency for image validation, and updated the workflow to install requirements before running tests or generation scripts.

Workflow and documentation improvements:

  • Expanded the catalog workflow trigger paths to include catalog-icons.json, icons/**, requirements.txt, and documentation files, ensuring icon and validation changes are tested in CI.
  • Documented the icon overlay process, validation requirements, and contribution steps in both CONTRIBUTING.md and README.md, including detailed instructions for adding, replacing, and removing icons, and the rationale for curation and provenance.

These changes lay the groundwork for curated icon support in the catalog, with robust validation and clear contribution guidelines.

aphansal123 and others added 3 commits October 13, 2026 14:07
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 50237efe-1a63-4ebe-96da-802b873d8c09
@aphansal123 aphansal123 self-assigned this Oct 13, 2026
aphansal123 and others added 2 commits October 13, 2026 15:36
Publish selected image assets independently so declarations can reference this immutable commit. No app code or repository visibility changes.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 50237efe-1a63-4ebe-96da-802b873d8c09
Record explicit redistribution approval without inventing a license or permission URL. Include selected icon and cover artwork and add the missing Web Design Guidelines skill entry.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 50237efe-1a63-4ebe-96da-802b873d8c09
@aphansal123 aphansal123 changed the title Enable reviewed catalog icon declarations Supply reviewed icons for featured catalog resources Oct 13, 2026
Defer its icon declaration until the independently proposed skill entry is available.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 50237efe-1a63-4ebe-96da-802b873d8c09
…esource-icons

# Conflicts:
#	ai-catalog.json

Co-authored-by: aphansal123 <21958153+aphansal123@users.noreply.github.com>
@github github deleted a comment from Copilot AI Oct 13, 2026
@aphansal123
aphansal123 requested a balanced review from Copilot October 13, 2026 20:36

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🔵 Needs a closer look

Binary provenance, redistribution approval, and downstream deployment dependencies require final human verification.

0 open findings

What changed in this PR

Adds a reviewed-icon overlay system for catalog resources, including validation, publication, documentation, and generated metadata.

Changes:

  • Validates curated PNG assets, provenance, immutable URLs, and overlay declarations.
  • Publishes 13 icon mappings and regenerates the catalog.
  • Adds comprehensive tests, documentation, and workflow triggers.
File Description
.github/​workflows/​catalog.yml Triggers validation for icon-related changes.
CONTRIBUTING.md Documents icon review and maintenance.
README.md Describes the optional icon system.
catalog-icons.json Declares 13 reviewed icon mappings.
ai-catalog.json Publishes generated icon metadata and registry refreshes.
scripts/​generate_ai_catalog.py Validates and applies icon declarations.
tests/​test_generate_ai_catalog.py Tests overlay and PNG validation.
tests/​test_catalog_workflow.py Tests workflow path triggers.
icons/​atlassian-labs/​jira.png Adds Jira artwork.
icons/​figma/​figma.png Adds Figma artwork.
icons/​github/​security-best-practices.png Adds GitHub security artwork.
icons/​mattpocock/​grill-me.png Adds Grill Me artwork.
icons/​microsoft/​azure-devops.png Adds Azure DevOps artwork.
icons/​microsoft/​azure.png Adds Azure artwork.
icons/​microsoft/​microsoft-foundry.png Adds Foundry artwork.
icons/​microsoft/​playwright.png Adds Playwright artwork.
icons/​microsoft/​workiq.png Adds Work IQ artwork.
icons/​pbakaus/​impeccable.png Adds Impeccable artwork.
icons/​sentry/​sentry-triage.png Adds Sentry artwork.
icons/​vercel-labs/​web-design-guidelines.png Stages deferred Web Design Guidelines artwork.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

github-actions Bot and others added 4 commits October 13, 2026 21:03
Move featured assets and declarations to a dependent data PR. Replace custom PNG parsing with Pillow verification and decoding, retaining byte/dimension/static-image limits and provenance checks.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 50237efe-1a63-4ebe-96da-802b873d8c09
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 50237efe-1a63-4ebe-96da-802b873d8c09
@aphansal123 aphansal123 changed the title Supply reviewed icons for featured catalog resources Enable reviewed catalog icon declarations Oct 14, 2026
aphansal123 and others added 3 commits October 13, 2026 23:08
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 50237efe-1a63-4ebe-96da-802b873d8c09
@aphansal123
aphansal123 marked this pull request as ready for review October 14, 2026 14:38
@aphansal123
aphansal123 merged commit 87ba2ce into main Oct 14, 2026
6 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.

4 participants