History

Mark Randall Havens △ The Empathic Technologist dac78460df feat(tools): add run-coherence.py - runs all checks		2026-02-13 22:25:18 -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 check-links.py to README	2026-02-13 22:25:04 -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>`

Usage

# Check all fieldnotes
python3 check-frontmatter.py ../public/fieldnotes/
python3 check-metadata.py ../public/fieldnotes/
python3 check-links.py ../public/fieldnotes/

# Fix missing frontmatter
python3 fix-frontmatter.py --dry-run ../public/fieldnotes/
python3 fix-frontmatter.py ../public/fieldnotes/

Exit Codes

0: Success / No issues
1: Issues found
2: Invalid arguments