History

Mark Randall Havens △ The Empathic Technologist cf483266fc docs(tools): add run-coherence.py - unified runner		2026-02-13 22:25:19 -06:00
..
check-frontmatter.py	feat(tools): add check-frontmatter.py - first coherence tool	2026-02-13 22:18:11 -06:00
check-links.py	feat(tools): add check-links.py - finds broken internal links	2026-02-13 22:25:03 -06:00
check-metadata.py	feat(tools): add check-metadata.py - validates frontmatter fields	2026-02-13 22:20:02 -06:00
fix-frontmatter.py	feat(tools): add fix-frontmatter.py - adds missing frontmatter	2026-02-13 22:21:54 -06:00
README.md	docs(tools): add run-coherence.py - unified runner	2026-02-13 22:25:19 -06:00
run-coherence.py	feat(tools): add run-coherence.py - runs all checks	2026-02-13 22:25:18 -06:00

README.md

Coherence Tools

Tools for maintaining site coherence.

Tools

Tool	Purpose	Usage
check-frontmatter.py	Validates YAML frontmatter exists	`python3 check-frontmatter.py <dir>`
check-metadata.py	Validates required fields	`python3 check-metadata.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>`
run-coherence.py	Runs all checks at once	`python3 run-coherence.py`

Quick Start

# Run all checks
python3 run-coherence.py

# 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 / All checks pass
1: Issues found
2: Invalid arguments