Skip to content

feat: automate workflow catalog publication - #17

Merged
vitormattos merged 3 commits into
mainfrom
feat/publish-workflow-catalog
Sep 20, 2026
Merged

vitormattos merged 3 commits into
mainfrom
feat/publish-workflow-catalog

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Summary

Implement #12 by making LibreCodeCoop/github-workflows publish its generated organization workflow templates to LibreCodeCoop/.github through a reviewable pull request.

Design

The workflow remains orchestration-only:

  1. checkout this repository;
  2. checkout LibreCodeCoop/.github into a separate working directory;
  3. run the tested catalog synchronizer;
  4. open/update a pull request in the catalog repository.

All synchronization rules live in scripts/sync_catalog.py.

Synchronization behavior

The synchronizer:

  • publishes only *.yml, *.yaml, *.properties.json and optional custom *.svg catalog artifacts;
  • requires every workflow template to have matching metadata;
  • validates custom SVG icon references;
  • updates changed catalog files;
  • removes stale managed catalog files;
  • preserves unrelated files in LibreCodeCoop/.github;
  • supports a deterministic check mode;
  • has unit coverage for additions, updates, removals, drift and invalid metadata.

The workflow uses the existing WORKFLOW_UPDATE_TOKEN; that token must have write access to LibreCodeCoop/.github.

Result

After this lands, changes under workflow-templates/ no longer require a manual copy into the organization catalog.

@vitormattos
vitormattos merged commit 5ccac80 into main Sep 20, 2026
4 of 5 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.

1 participant