What problem does it solve?
It prevents malformed YAML frontmatter from breaking ingestion, audit, search, and downstream brain operations by validating and (when safe) repairing common structural and data issues before pages enter the system.
Core Features & Use Cases
- Frontmatter validation across canonical classes: Detects missing delimiters, YAML parse failures, slug mismatches, null bytes, nested-quote title issues, and empty frontmatter.
- Audit and targeted validation: Runs multi-source audits with per-source counts and samples, or validates a specific file/directory for CI and pre-commit workflows.
- Safe auto-repair with backups: Applies fix mode with .bak backups for auto-fixable issues while avoiding risky repairs for cases that typically need human review.
Quick Start
Ask your agent to run a frontmatter audit and return JSON counts of any issues it finds across the brain.