vault-lint

Vault Lint

Comprehensive vault health audit. Checks five dimensions and presents a prioritized report with fix options.

Checks

1. Frontmatter Compliance

Scan Engineering/ notes for missing required frontmatter fields per VAULT_CONVENTIONS:

1. Call obsidian_list_notes with subfolder: "Engineering".
2. For each note, call obsidian_read_note and check frontmatter for:
   • type: — must be pattern, trap, decision, or concept
   • project: — must be present
   • status: — must be present
   • tags: — must be a list
   • created: — must be a date
3. Report notes with missing or malformed fields.
4. Offer to fix with obsidian_update_frontmatter (one at a time, user confirms).

2. Provenance Drift

Find Engineering/ notes where the provenance: block suggests high uncertainty:

1. From the notes already read in Check 1, filter those with provenance: frontmatter.
2. Flag notes where inferred > 0.5 — these are majority-synthesized and may need source verification.
3. Flag notes where ambiguous > 0.1 — these have unresolved contradictions.
4. Report flagged notes with their provenance fractions.

3. Stale Content

If .manifest.json exists at vault root:

1. Read it with the Read tool.
2. For each entry in sources, check if pages_created or pages_updated notes still exist using obsidian_read_note.
3. If a source file's modification time on disk is newer than ingested_at, the derived notes may be stale.
4. Report stale notes and suggest re-ingesting with /wiki-ingest --force <source>.

If no .manifest.json exists, skip this check and note that no ingest tracking is available.

4. MOC Coverage

Check whether recent Engineering/ notes appear in at least one thematic MOC:

1. Call obsidian_list_notes with subfolder: "MOCs".
2. For each MOC, call obsidian_read_note and extract all [[wikilinks]].
3. Build a set of all notes referenced by at least one MOC.
4. Compare against the Engineering/ note list — any note not in the MOC set is uncovered.
5. Exclude notes created in the last 24 hours (grace period).
6. Report uncovered notes and suggest which MOC(s) they belong in via obsidian_rag_query (query the note title against MOC titles).