Problem
Resolver/architecture changes will alter graph.json shape. We need a clean way for an older server to refuse a newer (or incompatible) on-disk graph instead of misreading it.
Proposal
Add a schemaVersion field to graph.json. On load, reject-and-fall-back-to-"no index" on mismatch (reuse the existing T4 schema-validation fallback path). Human-readable symbol IDs stay as-is (debuggability).
Acceptance
Problem
Resolver/architecture changes will alter
graph.jsonshape. We need a clean way for an older server to refuse a newer (or incompatible) on-disk graph instead of misreading it.Proposal
Add a
schemaVersionfield tograph.json. On load, reject-and-fall-back-to-"no index" on mismatch (reuse the existing T4 schema-validation fallback path). Human-readable symbol IDs stay as-is (debuggability).Acceptance
schemaVersionwritten on index and checked on load