Add spec-driven architecture review page

[MaxGhenis]

Summary

• add /spec as a production-backed Populace/Ledger contract graph generated from source contracts, not hand-authored graph data
• render the graph in an Axiom-style network with filters, inspector, dependency table, source links, and provenance
• clarify which contracts exist today versus which country-pack specs are still proposed
• add a source audit for remaining imperative surfaces and remove stale local path references from dashboard data generation
• add CI that regenerates data/spec-graph.json, checks it is committed, and validates graph edges, duplicate ids, provenance, HTML, and spec.js syntax

Follow-up issues filed

• Move country build choices into declarative specs populace#159: Move country build choices into declarative specs
• Consume Ledger target profiles instead of carrying target values in Populace populace#160: Consume Ledger target profiles instead of carrying target values in Populace
• Publish Ledger target profile artifacts for Populace builds ledger#61: Publish Ledger target profile artifacts for Populace builds
• Read spec and release graph data from published Populace bundles #10: Read spec and release graph data from published Populace bundles

Validation

• python3 scripts/generate_spec_graph.py
• python3 scripts/check_spec_graph.py
• PYTHONHASHSEED=123 python3 scripts/generate_spec_graph.py with unchanged graph checksum
• python3 -m py_compile scripts/generate_spec_graph.py scripts/check_spec_graph.py scripts/build_dashboard_data.py
• python3 -m json.tool data/spec-graph.json >/tmp/spec-graph.json.pretty
• git diff --check
• stale-reference scan for removed repo names and misleading text
• local route check: http://127.0.0.1:4399/spec
• GitHub checks: Spec graph and Vercel passed

Local review

A clean-url local server is running from this branch at http://127.0.0.1:4399/spec

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
populace-dev	Ready	Preview, Comment	Jun 21, 2026 1:12pm