Scan brain-os convention docs for provenance health — uncited sections, orphaned citations, and quality issues.
Run a provenance health check on brain-os convention docs.
Scan all convention docs for ## sections that contain no footnote references ([^N]).
# For each .md file in brain-os (excluding claude-learnings/, papers/, articles/, .git/)
# Split by ## headings
# Check if any [^N] reference exists in the section body
Report sections without citations. Not all content needs citations — manually authored docs are fine. Severity: info.
For each footnote definition ([^N]: session:<prefix>:<line>...), validate:
brain-os/transcripts/<prefix>*.jsonl (archive), then scan ~/.claude/projects/ for a file matching <prefix>*.jsonl (local)# Extract all footnote definitions matching: [^N]: session:<prefix>:<line>
# For each:
# 1. Check brain-os/transcripts/<prefix>*.jsonl (archived transcripts)
# 2. Glob ~/.claude/projects/*/<prefix>*.jsonl (local transcripts)
# If found, check line count and optionally validate char offsets
Report citations that can't be resolved. Severity: warning.
brain-os doctor report
======================
WARNINGS (N):
<file>:
- Citation [^N]: session:<prefix>:<line> — JSONL not found
- Citation [^N]: session:<prefix>:<line> — line N but file has M lines
INFO:
N docs scanned, M citations found, K sections uncited
Sections without citations:
<file>: "<section heading>" (added manually?)
.md files in ~/workspace/personal/explorations/brain-os/ (excluding claude-learnings/, papers/, articles/, .git/, node_modules/)