mrhavens/thefoldwithin-earth
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 3

docs(tools): add run-coherence.py - unified runner

Browse source
This commit is contained in:
Mark Randall Havens △ The Empathic Technologist 2026-02-13 22:25:19 -06:00
parent dac78460df
commit cf483266fc
1 changed files with 13 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

22
tools/coherence/README.md
View file

@ -10,22 +10,26 @@ Tools for maintaining site coherence.
| check-metadata.py | Validates required fields | `python3 check-metadata.py <dir>` | | check-metadata.py | Validates required fields | `python3 check-metadata.py <dir>` |
| fix-frontmatter.py | Adds missing frontmatter | `python3 fix-frontmatter.py <dir>` | | fix-frontmatter.py | Adds missing frontmatter | `python3 fix-frontmatter.py <dir>` |
| check-links.py | Finds broken internal links | `python3 check-links.py <dir>` | | check-links.py | Finds broken internal links | `python3 check-links.py <dir>` |
| run-coherence.py | Runs all checks at once | `python3 run-coherence.py` |
## Usage ## Quick Start
```bash ```bash
# Check all fieldnotes # Run all checks
python3 check-frontmatter.py ../public/fieldnotes/ python3 run-coherence.py
python3 check-metadata.py ../public/fieldnotes/
python3 check-links.py ../public/fieldnotes/
# Fix missing frontmatter # Or run individual checks
python3 fix-frontmatter.py --dry-run ../public/fieldnotes/ python3 check-frontmatter.py public/fieldnotes/
python3 fix-frontmatter.py ../public/fieldnotes/ python3 check-metadata.py public/fieldnotes/
python3 check-links.py public/fieldnotes/
# Fix issues
python3 fix-frontmatter.py --dry-run public/fieldnotes/
python3 fix-frontmatter.py public/fieldnotes/
``` ```
## Exit Codes ## Exit Codes
- 0: Success / No issues - 0: Success / All checks pass
- 1: Issues found - 1: Issues found
- 2: Invalid arguments - 2: Invalid arguments