GTK-OSX Moduleset Updater
Workflow
Use this skill for repeatable update passes between a local gtk-osx-build checkout and an upstream checkout such as $HOME/projects/gtk-osx-build.upstream.
- Confirm the local repo, upstream repo, scope, skips, and commit body from the user request.
- Run
scripts/moduleset_update.py listto see upstream-newer branch pins. - If asked to apply updates, run
scripts/moduleset_update.py applywith the same scope and skips. - Verify XML parsing and
git status --shortfor the affected files. - Report commit hashes and any intentionally skipped or untracked modulesets.
Script
Prefer the bundled script instead of hand-editing XML. It parses moduleset files, compares branch version values by module id, copies upstream branch attributes into the local file, preserves local child patches/dependencies, and commits one update at a time.
List updates from stable modulesets and matching root-level modulesets:
python3 .codex/skills/gtk-osx-moduleset-updater/scripts/moduleset_update.py list \
--local $HOME/projects/gtk-osx-build \
--upstream $HOME/projects/gtk-osx-build.upstream \
--scope root,modulesets-stable
Apply updates while skipping packages:
python3 .codex/skills/gtk-osx-moduleset-updater/scripts/moduleset_update.py apply \
--local $HOME/projects/gtk-osx-build \
--upstream $HOME/projects/gtk-osx-build.upstream \
--scope root,modulesets-stable \
--skip openssl,python3 \
--message-body "update merged from https://github.com/jralls/gtk-osx-build"
By default the script only modifies tracked files. Use --include-untracked only when the user explicitly wants to add a new moduleset file.
Guardrails
- Stage only the moduleset file being updated for each commit.
- Do not touch unrelated untracked files in
gtk-osx-build. - Skip packages exactly by module id, for example
opensslorpython3. - Root scope means root-level
*.modulesfiles that exist in both repositories. - Stable scope means
modulesets-stable/*.modulesfiles that exist in both repositories. - If a moduleset exists only as an untracked local file, mention it and leave it alone unless explicitly requested.
- If a package appears in more than one moduleset, commit each file update separately unless the user asks for a different grouping.