feat(repo): Add contributor sync and consistency audits
Add maintainer automation for repo-state hygiene so contributor acknowledgements, count-sensitive docs, and GitHub About metadata stay aligned from the same workflow. Cover the new scripts with regression tests and wire them into the local test suite to keep future maintenance changes from drifting silently.
This commit is contained in:
20
.github/MAINTENANCE.md
vendored
20
.github/MAINTENANCE.md
vendored
@@ -80,7 +80,20 @@ Before ANY commit that adds/modifies skills, run the chain:
|
||||
npm run catalog
|
||||
```
|
||||
|
||||
3. **COMMIT GENERATED FILES**:
|
||||
3. **Optional maintainer sweep shortcut**:
|
||||
```bash
|
||||
npm run sync:repo-state
|
||||
```
|
||||
This wraps `chain + catalog + sync:contributors + audit:consistency` for a full local repo-state refresh.
|
||||
|
||||
When you need the live GitHub repo metadata updated too, run:
|
||||
|
||||
```bash
|
||||
npm run sync:github-about
|
||||
npm run audit:consistency:github
|
||||
```
|
||||
|
||||
4. **COMMIT GENERATED FILES**:
|
||||
```bash
|
||||
git add README.md skills_index.json data/skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md
|
||||
git commit -m "chore: sync generated files"
|
||||
@@ -180,8 +193,9 @@ We used this flow for PRs [#220](https://github.com/sickn33/antigravity-awesome-
|
||||
After you have merged several PRs or before cutting a release:
|
||||
|
||||
1. **Sync Contributors List**:
|
||||
- Run: `git shortlog -sn --all`
|
||||
- Update `## Repo Contributors` in README.md.
|
||||
- Run: `npm run sync:contributors`
|
||||
- This refreshes `## Repo Contributors` in `README.md` from the live GitHub contributor list while preserving custom bot/app links.
|
||||
- If you are already doing a full maintainer sweep, prefer `npm run sync:repo-state`.
|
||||
|
||||
2. **Verify Table of Contents**:
|
||||
- Ensure all new headers have clean anchors.
|
||||
|
||||
Reference in New Issue
Block a user