← Personal Knowledge System
Component / Integrity

Validation & indexes

The quality gate and retrieval layer: validators, link checks, generated indexes, read models, and failure events when something cannot be safely written.

Role

Makes mutations trustworthy and makes the vault fast enough to query without loading everything.

Contains

  • validate_vault.py and schema checks
  • Generated indexes and MOCs
  • Transaction/capture runners
  • Visible failure events for blocked writes

Interfaces

  • Hermes verifies after edits
  • Capture tools use runners/queues
  • Indexes expose bounded context to agents

Maintenance rule

Validation failures should be visible events, not silent skips or partial writes.

Proof signal

Links, frontmatter, generated indexes, and read models can be checked before trusting an output.

Failure mode: Without validation, automation silently corrupts the source of truth.

← system/ folderAll componentsAgent interfaces →