Report audit
Audit date: 2026-06-01 (updated after RAGMap planning + local graph analysis)
Scope: All markdown under docs/reports/ plus files moved to _local_archive/reports/
Policy: See README.md
Summary
| Classification | Count |
|---|---|
| active | 18 |
| generated_current | 5 |
| archive_local_only | 5 |
| remove_from_navigation | 3 |
| superseded (archived) | 5 |
RAGMap planning reports added 2026-06-01 (ragmap-and-graph-analysis-plan.md, graph-analysis-use-cases.md, neo4j-import-plan.md, ragmap-question-examples.md). Local CSV graph analysis added via scripts/analyze_graph_csvs.py → local-graph-analysis-report.md.
No files were permanently deleted. Archived reports remain on disk under _local_archive/reports/ (gitignored).
Per-file classification
| Filename | Classification | Reason | Action taken | Replacement | MkDocs nav | Commit? |
|---|---|---|---|---|---|---|
full-refresh-report.md |
generated_current | Written by scripts/refresh_all.py; canonical status |
Kept; nav entry | — | Yes | Yes |
local-graph-analysis-report.md |
generated_current | Written by scripts/analyze_graph_csvs.py from data/graph_exports/ |
Added | full-refresh-report.md |
No | Optional |
curriculum-review.md |
generated_current | Generated by curriculum harvest scripts via sync_docs.sh |
Kept; removed from nav | full-refresh-report.md |
No | Yes |
access-status-review.md |
generated_current | Generated by apply_access.py / sync |
Kept; removed from nav | full-refresh-report.md |
No | Yes |
verification-review.md |
generated_current | Generated by apply_verification.py / sync |
Kept; removed from nav | full-refresh-report.md |
No | Yes |
graph-readiness-review.md |
active | Person–resource graph methodology | Kept; nav entry | full-refresh-report.md for counts |
Yes | Yes |
grants-layer-review.md |
active | Seed grants narrative + intake pointers | Kept; nav entry | full-refresh-report.md |
Yes | Yes |
publications-quality-review.md |
active | Current publication QA | Kept; nav entry | publication-intake-rules.md |
Yes | Yes |
outputs-quality-review.md |
active | Current output QA | Kept; nav entry | output-intake-rules.md |
Yes | Yes |
publication-intake-rules.md |
active | Codified publication rules | Kept | — | No | Yes |
output-intake-rules.md |
active | Codified output rules | Kept | — | No | Yes |
publications-layer-plan.md |
active | Layer strategy | Kept | publication-intake-rules.md |
No | Yes |
outputs-layer-plan.md |
active | Layer strategy | Kept | output-intake-rules.md |
No | Yes |
grant-data-intake-template.md |
active | Grant intake template | Kept | grants-layer-review.md |
No | Yes |
publication-data-intake-template.md |
active | Publication intake template | Kept | publication-intake-rules.md |
No | Yes |
output-data-intake-template.md |
active | Output intake template | Kept | output-intake-rules.md |
No | Yes |
connection-reconciliation-review.md |
active | Cross-layer link reconciliation | Kept | — | No | Yes |
ragmap-and-graph-analysis-plan.md |
active | Architecture: static map → graph → RAG | Added 2026-06-01 | — | No | Yes |
graph-analysis-use-cases.md |
active | 18 audience use cases | Added 2026-06-01 | ragmap-and-graph-analysis-plan.md |
No | Yes |
neo4j-import-plan.md |
active | Neo4j labels, CSV mapping (optional DB) | Added 2026-06-01 | graph_queries/ |
No | Yes |
ragmap-question-examples.md |
active | Example NL questions for future RAGMap | Added 2026-06-01 | graph-analysis-use-cases.md |
No | Yes |
topical-edge-audit.md |
active | Topical edge review before Neo4j; YAML include_in_graph fixes | Added 2026-06-01 | local-graph-analysis-report.md |
No | Yes |
local-graph-analysis-report.md |
generated_current | Pandas graph audit from analyze_graph_csvs.py |
Added | full-refresh-report.md |
No | Optional |
ors-demo-readiness.md |
active | ORS demo status | Kept; nav entry | — | Yes | Yes |
internal-data-wishlist.md |
active | ORS field request | Kept; nav entry | — | Yes | Yes |
ors-demo-script.md |
active | Demo script | Kept; README only | ors-demo-readiness.md |
No | Yes |
ors-demo-one-page-summary.md |
active | Demo handout | Kept; README only | ors-demo-readiness.md |
No | Yes |
README.md |
active | Reports index and policy | Updated for RAGMap + graph exports | — | Yes | Yes |
report-audit.md |
active | This audit | Updated | — | No | Yes |
publications-pilot-review.md |
archive_local_only / superseded | Stale pilot | _local_archive/reports/ |
publications-quality-review.md |
No | No |
next-publication-cohort.md |
archive_local_only | Cohort execution log | Archive | publications-quality-review.md |
No | No |
outputs-discovery-batch-review.md |
archive_local_only | Batch execution log | Archive | outputs-quality-review.md |
No | No |
people-layer-review.md |
archive_local_only / superseded | Stale people count | Archive | graph-readiness-review.md |
No | No |
csh-lab-integration-pass.md |
archive_local_only | One-off pass | Archive | publications-quality-review.md |
No | No |
Graph exports (not reports)
| Path | Classification | Notes |
|---|---|---|
data/graph_exports/*.csv |
generated_ephemeral | Regenerated by export_graph_tables.py / refresh_all.py; gitignored; use fresh exports for pandas/Neo4j |
Navigation (MkDocs)
In Reports tab: README, full refresh, graph readiness, grants layer, publications quality, outputs quality, ORS demo readiness, internal data wishlist.
Indexed in README only: RAGMap planning reports, local graph analysis, layer plans, templates, generated QA reviews.
Validation results (latest)
| Check | Result |
|---|---|
analyze_graph_csvs.py |
Regenerates exports + local-graph-analysis-report.md |
refresh_all.py |
0 errors · 5 warnings (CDM-002, CSH-008, OUT-014–016) |
| Entity counts | 115 people · 33 grants · 34 publications · 18 outputs |
_local_archive/ |
Gitignored |
data/graph_exports/ |
Gitignored |