From cf483266fc719b8eb5c6c50d003e97fb14a8a69b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mark=20Randall=20Havens=20=E2=96=B3=20The=20Empathic=20Tec?= =?UTF-8?q?hnologist?= Date: Fri, 13 Feb 2026 22:25:19 -0600 Subject: [PATCH] docs(tools): add run-coherence.py - unified runner --- tools/coherence/README.md | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/tools/coherence/README.md b/tools/coherence/README.md index 54a6424..ca399f7 100644 --- a/tools/coherence/README.md +++ b/tools/coherence/README.md @@ -10,22 +10,26 @@ Tools for maintaining site coherence. | check-metadata.py | Validates required fields | `python3 check-metadata.py ` | | fix-frontmatter.py | Adds missing frontmatter | `python3 fix-frontmatter.py ` | | check-links.py | Finds broken internal links | `python3 check-links.py ` | +| run-coherence.py | Runs all checks at once | `python3 run-coherence.py` | -## Usage +## Quick Start ```bash -# Check all fieldnotes -python3 check-frontmatter.py ../public/fieldnotes/ -python3 check-metadata.py ../public/fieldnotes/ -python3 check-links.py ../public/fieldnotes/ +# Run all checks +python3 run-coherence.py -# Fix missing frontmatter -python3 fix-frontmatter.py --dry-run ../public/fieldnotes/ -python3 fix-frontmatter.py ../public/fieldnotes/ +# Or run individual checks +python3 check-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 -- 0: Success / No issues +- 0: Success / All checks pass - 1: Issues found - 2: Invalid arguments