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.
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# 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):**
|
|
|
|
1. Run the **FULL Validation Chain** locally:
|
|
|
|
```bash
|
|
npm run chain
|
|
npm run catalog
|
|
```
|
|
|
|
2. Check for changes:
|
|
|
|
```bash
|
|
git status
|
|
git diff
|
|
```
|
|
|
|
3. Commit and push any updates:
|
|
```bash
|
|
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.
|