vault-health

To generate a vault health report, run the vault-health command from the repository root. It aggregates index and backlog data to produce a Markdown report with top-consumed notes, orphaned items, and gap-stub metrics, saving it to ops/health.

A vault health report includes top-consumed notes, top-orphaned notes, and demand gaps. It also tracks pending gap-stub queues and provides a trend comparison versus the previous report for governance and planning.

Backlink index analysis identifies orphaned notes by aggregating T3 backlink data to find items lacking incoming references. The vault-health script computes this status alongside top-consumed items to surface actionable health metrics.

Yes, you can compare current vault health metrics against previous reports. The generator includes an optional comparison feature that outputs trend data alongside the daily report, highlighting shifts in note consumption and orphaned status.

No external dependencies are required to automate vault health reporting. The Skill operates independently using internal scripts to read T3 backlink indexes and T1 gap-stub queues, computing metrics without additional package installations.

The best way to track demand gaps is by managing the T1 gap-stubs queue. The vault-health script identifies missing information by analyzing backlinks and consumption data, then writes these gap metrics directly into the daily Markdown report.