frontmatter-guard

To validate YAML frontmatter in Markdown pages, scan the files for missing delimiters, parsing failures, slug mismatches, and null bytes. This identifies structural issues before they break search or ingestion workflows in your knowledge base repository.

Malformed YAML frontmatter is caused by missing delimiters, nested quotes, null bytes, and slug mismatches. These structural issues corrupt metadata synchronization and search ingestion workflows if not detected and repaired before committing changes.

Yes, you can automatically repair malformed frontmatter using safe auto-fix handling. It fixes supported mechanical issues while creating backup files, intentionally preserving complex validation errors that require human review to prevent data loss.

Frontmatter validation works for CI checks and pre-commit validation scenarios. It audits brain repositories to catch malformed Markdown metadata before sync operations, applying parsing and error classification to prevent ingestion workflow failures.

Automated frontmatter repair is limited to supported mechanical issues. Complex YAML parsing failures, nested quotes, and structural corruptions requiring human review are intentionally preserved without modification to avoid unsafe metadata changes.