/health — Vault Health Check

Generate comprehensive health report for the vault.

Context

Config: @_core/config.yaml

Session Task Progress

TaskCreate: "Scan vault files"
  activeForm: "Scanning vault files..."

TaskCreate: "Check links and orphans"
  activeForm: "Validating links..."

TaskCreate: "Generate health report"
  activeForm: "Generating health report..."

Processing Steps

1. •

   Scan Vault

   • •Glob all .md files
   • •Exclude: _core/, _templates/, _archive/
2. •

   Check Broken Links

   • •Extract all [[wikilinks]] from each file
   • •Verify each target exists
   • •Report: source → broken target
3. •

   Find Orphan Notes

   • •Notes with no inbound links
   • •Exclude: index files, standalone: true
4. •

   Check Missing Sections

   • •Typed notes (doc, decision, blocker, meeting) should have ## Links
   • •Report missing required sections
5. •

   Calculate Statistics

   • •Notes by type
   • •Notes by project
   • •Link density (links per note)
6. •

   Check Update Status

   • •Read VERSION file for local version
   • •Query GitHub API for latest release: curl -sS "https://api.github.com/repos/{repo}/releases/latest" (non-fatal on failure)
   • •Compare: "Up to date" | "Update available: vX → vY" | "Could not check"
7. •

   Generate Report

   • •Write to index/_graph-health.md

Output Format

# Graph Health Report

> Generated: {datetime}

## Broken Links
| Source | Broken Target |
|--------|---------------|
| {path} | [[{target}]]  |

## Orphan Notes
- {path} — no inbound links

## Missing ## Links Sections
- {path} — type: {type}

## Statistics

### By Type
| Type | Count |
|------|-------|
| daily | {n} |
| doc | {n} |

### By Project
| Project | Count |
|---------|-------|
| {proj} | {n} |

### Link Density
- Total links: {n}
- Average per note: {avg}

## Framework Status
- **Version**: v{local}
- **Update**: {status — "Up to date" | "Update available: vX → vY" | "Could not check"}

## Actions
1. [ ] Fix broken link: {source} → {target}
2. [ ] Add links to: {orphan}