Reports index

Hand-authored strategy reports, generated QA exports, and ORS demo materials for the DePaul Hardware Technology Resource Map.

Public site navigation: These reports are not listed in MkDocs tabs. See docs/archive/README.md for a browsable archive index. Public visitors should use About for access/verification legend and scope.

Regenerating reports

Command	What it updates
`python3 scripts/refresh_all.py`	`full-refresh-report.md`, link YAML, `data/graph_exports/`, home stats
`python3 scripts/analyze_graph_csvs.py`	`local-graph-analysis-report.md` (pandas hub/bridge audit; runs export first)
`python3 scripts/export_graph_tables.py`	`data/graph_exports/*.csv` only
`python3 scripts/generate_demo_pages.py`	ORS demo pages under `docs/archive/demos/` (Mermaid from graph exports)
`python3 scripts/refresh_all.py --demo`	Full refresh plus demo pages (`--skip-ragmap` on demo step)
`./sync_docs.sh` (or individual scripts)	`curriculum-review.md`, `access-status-review.md`, `verification-review.md`, resource pages under `docs/`

Current status always starts with full-refresh-report.md (entity counts, validation, hub resources).

Graph export CSVs (generated, not committed)

Location: data/graph_exports/ (11 CSV files: 5 node tables, 6 edge tables)
Git: Ignored via .gitignore — regenerate locally; do not rely on committed copies
Regenerate: python3 scripts/refresh_all.py or python3 scripts/export_graph_tables.py
Use: python3 scripts/analyze_graph_csvs.py (pandas) or Neo4j templates in graph_queries/ (repo root)

Always use fresh exports before graph analysis or Neo4j import.

ORS demo pages (generated)

Location: docs/archive/demos/ (archived; not in public MkDocs nav)
Generator: python3 scripts/generate_demo_pages.py (runs export_graph_tables.py unless --skip-export)
Do not edit by hand: sections marked 
After data changes: python3 scripts/refresh_all.py then python3 scripts/generate_demo_pages.py (or refresh_all.py --demo for diagrams only; re-run ragmap for full Ask-the-Map reports)
Serve locally: mkdocs serve --dev-addr 0.0.0.0:8000
Connection diagrams come from graph CSVs; workflow diagrams are fixed templates written by the generator
Not published: _local_archive/ and archived reports (do not link from demo pages)

Local archive (not in Git)

Superseded execution logs and pilot reviews live under _local_archive/reports/ on your machine only. That directory is listed in .gitignore and is not published to the MkDocs site. Do not link to it from site navigation.

1. Current status

Report	Type	In site nav
full-refresh-report.md	Generated (committed)	No
local-graph-analysis-report.md	Generated (optional commit)	No
graph-readiness-review.md	Maintained	No
grants-layer-review.md	Maintained	No
publications-quality-review.md	Maintained	No
outputs-quality-review.md	Maintained	No
connection-reconciliation-review.md	Maintained	No

Generated QA (committed, regenerate via sync_docs.sh; not in site nav):

Hypertext navigation audits (regenerate via sync_docs.sh; not in site nav):

2. Data layer documentation

Report	Purpose
publication-intake-rules.md	Publication inclusion rules
output-intake-rules.md	Output inclusion rules
publications-layer-plan.md	Publications layer strategy
outputs-layer-plan.md	Outputs layer strategy
grant-data-intake-template.md	Grant intake template
grant-ingestion-governance.md	Grant/award evidence vs PI vs facility linkage (layer policy when awards are documented)
repository-wide-refactor-governance.md	IKaC: every packet assesses all layers; candidate preservation; Promotion Discovery Rule
promotion-review-governance-update.md	Makes promotion review mandatory: candidates trigger targeted evidence discovery → re-evaluate → promote/defer (section N)
repository-wide-refactor-report-2026-06-14-cdm-csh-web-discovery.md	CDM/CSH institutional web import: 9 new labs/centers, equipment updates, PER-002 correction
collaboratory-ingestion-report.md	DePaul Collaboratory API ingestion: 715 activities, 676 partners; EXT-013/014 promoted; Steans/Cybersecurity Clinic enrichment
collaboratory-external-partner-promotion-review.md	Top-100 Collaboratory external partner ranking; A1/B2 promotion recommendations (review only, no promotions)
collaboratory-partner-network-report.md	Partner network centrality: anchors, emerging partners, clusters, unit connectivity (no corpus changes)
resource-map-to-collaboratory-gap-analysis.md	RM → Collaboratory gap analysis: mission-fit submissions only (no corpus changes)
collaboratory-submission-drafts.md	Draft Collaboratory activity records from gap analysis (no corpus changes)
resource-map-editorial-consistency-cleanup.md	June 2026 editorial cleanup: governance taxonomy, new-page harmonization, UNI-012 reframe (index-only, not in nav)
repository-wide-refactor-audit.md	Audit of source-type-specific drift in scripts, prompts, policies
repository-wide-refactor-pilot.md	Pilot reprocessing: ORS/AGIF/RFUMS/CIRCLE missed-facility findings
repository-wide-refactor-report.md	Full repository-wide refactor execution report (2026-06-14)
repository-wide-refactor-report-2026-06-14-internal-programs.md	ORS internal grant / paid-leave / URAP program reports refactor
candidate-preservation-implementation-report.md	Phase 2: shared candidate-extraction pipeline for all intake paths
hard-technology-discovery-audit.md	Audit of physical-infrastructure discovery since main
hard-technology-web-discovery-refactor.md	Web-evidenced promotion of hard-tech candidates (CDM-023/024, CSH-020, COM-001, EXT-012)
grant-ingestion-filter-audit.md	Registry-PI filter audit + implementation plan
publication-data-intake-template.md	Publication intake template
output-data-intake-template.md	Output intake template

3. Demo / ORS materials

Report	Purpose
ors-demo-one-page-summary.md	Pre-meeting handout
ors-demo-script.md	Live demo outline
ors-demo-readiness.md	Counts, limitations, collaboration ask
internal-data-wishlist.md	ORS / purchasing field request

ORS demo summary and script are indexed here; all ORS demo materials are archived from public navigation (see docs/archive/).

Graph and RAGMap planning

Report	Purpose
ragmap-and-graph-analysis-plan.md	Architecture: static map → graph → RAG → decision support
graph-analysis-use-cases.md	18 use cases by audience (ORS, faculty, students, …)
neo4j-import-plan.md	Node/rel labels, CSV mapping, constraints (Neo4j optional)
ragmap-question-examples.md	Example NL questions for a future RAGMap UI

Local analysis (no Neo4j): local-graph-analysis-report.md — run python3 scripts/analyze_graph_csvs.py (topical edges excluded by default; see topical-edge-audit.md).

RAGMap prototype (no LLM): ragmap-prototype-review.md — run python3 scripts/ragmap_answer_prototype.py <mode>. Sample answers: technical_hubs.md, bridge_people.md, proposal_support_environmental_sensing.md (keyword search with optional transparent synonym expansion from data/search_synonyms.yaml; more in ragmap_answers/).

Cypher templates (optional Neo4j): graph_queries/ at repo root — not in MkDocs nav.

Archived locally (not on site)

Moved to _local_archive/reports/ during the 2026-06-01 report audit (see report-audit.md):

publications-pilot-review.md — superseded by publications quality review + intake rules
next-publication-cohort.md — cohort execution log
outputs-discovery-batch-review.md — batch execution log
people-layer-review.md — superseded by graph readiness + full refresh
csh-lab-integration-pass.md — one-off integration pass

Report types

Type	Commit?	Examples
Maintained	Yes	Intake rules, layer plans, quality reviews, ORS demo, RAGMap planning
Generated (current)	Yes / optional	`full-refresh-report.md`, `local-graph-analysis-report.md`, curriculum/access/verification
Generated (ephemeral)	No	`data/graph_exports/*.csv`
Archive (local)	No	`_local_archive/reports/*`

Audit trail: report-audit.md.