45844de534
Consolidate the repository into clearer apps, tools, and layered docs areas so contributors can navigate and maintain it more reliably. Align validation, metadata sync, and CI around the same canonical workflow to reduce drift across local checks and GitHub Actions.
1.3 KiB
CI Drift Fix Guide
Problem: The failing job is caused by uncommitted changes detected in README.md, skills_index.json, or catalog files after the update scripts run.
Error:
❌ Detected uncommitted changes produced by registry/readme/catalog scripts.
Cause:
Scripts like tools/scripts/generate_index.py, tools/scripts/update_readme.py, and tools/scripts/build-catalog.js modify README.md, skills_index.json, data/catalog.json, data/bundles.json, data/aliases.json, and CATALOG.md. The workflow expects these files to have no changes after the scripts run. Any differences mean the committed repo is out-of-sync with what the generation scripts produce.
How to Fix (DO THIS EVERY TIME):
-
Run the FULL Validation Chain locally:
npm run chain npm run catalog -
Check for changes:
git status git diff -
Commit and push any updates:
git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md git commit -m "chore: sync generated registry files" git push
Summary:
Always commit and push all changes produced by the registry, README sync, and catalog scripts. This keeps CI passing by ensuring the repository and generated artifacts stay in sync with the canonical tools/scripts/* pipeline.