Skip to content

feat: add frontmatter-completeness drift checker#62

Open
advancedresearcharray wants to merge 7 commits into
mex-memory:mainfrom
advancedresearcharray:feat/frontmatter-completeness-53
Open

feat: add frontmatter-completeness drift checker#62
advancedresearcharray wants to merge 7 commits into
mex-memory:mainfrom
advancedresearcharray:feat/frontmatter-completeness-53

Conversation

@advancedresearcharray

@advancedresearcharray advancedresearcharray commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds frontmatter-completeness checker for context/ and patterns/ files.
  • Warns (not errors) when name, description, or last_updated is missing.
  • Reuses parseFrontmatter in the per-file drift loop, same pattern as checkEdges.

Closes #53

Follow-up to merged #60 (todo-fixme). Complements open #61 (broken-link).

Test plan

  • npm run typecheck && npm test && npm run build
  • Unit tests for missing fields, complete frontmatter, and ignored paths

@advancedresearcharray advancedresearcharray force-pushed the feat/frontmatter-completeness-53 branch from fdd6c99 to 7d36a28 Compare June 5, 2026 19:40
@advancedresearcharray

Copy link
Copy Markdown
Contributor Author

Follow-up commit addresses two small gaps:

  • CONTRIBUTING.md — checker count updated from 11 → 12 (CHANGELOG already claimed this but the file was missed).
  • reporter.ts — added remediation hint for INCOMPLETE_FRONTMATTER, consistent with BROKEN_LINK / TODO_FIXME.

CI was green before the push; npm run typecheck && npm test && npm run build pass locally on the branch. Ready for review.

@advancedresearcharray

Copy link
Copy Markdown
Contributor Author

Follow-up fix on the branch:

  • CHANGELOG.md — restored the broken-link Added bullet that was accidentally dropped during the rebase when frontmatter-completeness was added (both entries now appear under [Unreleased]).
  • test/checkers.test.ts — added coverage for null frontmatter (all three fields), whitespace-only values, and explicit INCOMPLETE_FRONTMATTER code assertions.

CI is green on the latest push (e9edc96).

@advancedresearcharray advancedresearcharray force-pushed the feat/frontmatter-completeness-53 branch from efaec68 to 5134251 Compare June 8, 2026 04:01
@advancedresearcharray

Copy link
Copy Markdown
Contributor Author

Rebased onto latest main (includes #68, #71, #65). Force-pushed to feat/frontmatter-completeness-53.

  • npm run typecheck && npm test && npm run build — 187 tests pass locally after rebase
  • CI green on the new push (5134251)

No additional code changes; the branch is up to date and ready for review.

root and others added 4 commits June 9, 2026 06:04
Warn when context/ or patterns/ files lack recommended name,
description, or last_updated. Rebased on main (post broken-link).

Co-authored-by: Cursor <cursoragent@cursor.com>
CHANGELOG claimed CONTRIBUTING was updated to 12 checkers but the
count was still 11. Add INCOMPLETE_FRONTMATTER remediation in reporter
for consistency with other warning-level checkers.

Co-authored-by: Cursor <cursoragent@cursor.com>
The rebase dropped the broken-link Added bullet when frontmatter-completeness
was added. Restore both entries. Add coverage for null frontmatter,
whitespace-only values, and INCOMPLETE_FRONTMATTER issue codes.

Co-authored-by: Cursor <cursoragent@cursor.com>
The deployed scaffold layout uses .mex/context/*.md paths relative to
projectRoot. startsWith("context/") silently skipped those files.

Co-authored-by: Cursor <cursoragent@cursor.com>
@advancedresearcharray advancedresearcharray force-pushed the feat/frontmatter-completeness-53 branch from 5134251 to 734c0e1 Compare June 9, 2026 06:04
Array Fleet and others added 3 commits June 9, 2026 06:07
Mirror the deployed-scaffold path test for patterns/ alongside context/.

Co-authored-by: Cursor <cursoragent@cursor.com>
Skip patterns/INDEX.md and patterns/README.md (and .mex/ equivalents)
to avoid false-positive INCOMPLETE_FRONTMATTER warnings on scaffold
boilerplate. Add tests for meta-file exclusion and non-string YAML values.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add integration coverage for INCOMPLETE_FRONTMATTER warnings on incomplete
context files and for excluding patterns/INDEX.md structural meta-files.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a frontmatter-completeness drift checker

1 participant