Plan, apply and roll back changes to a production ontology, with a blast radius report and a proof an auditor can re-check.
Rust ai-nativedescription-logicsformal-verificationinfrastructure-as-codeisabelle-languageknowledge-graphleanlean4mcpmcp-serverontologyowlowl2reasoningrustshaclsparqltheorem-proving
heritage-aerial: add Canada/US/three-country maps to the write-ups
FABIOTESS2bf29ee67e6c
diff --git a/case-studies/heritage-aerial/assets/README.md b/case-studies/heritage-aerial/assets/README.mdindex 45cff813..dd70463a 100644--- a/case-studies/heritage-aerial/assets/README.md+++ b/case-studies/heritage-aerial/assets/README.md@@ -11,6 +11,22 @@ harvested 2 Jul 2026). Draft captions below — edit to taste. No em dashes per| `stack.png` | Positioning | "The gap nobody had filled: a crosswalk binding the archival stack (Records in Contexts, PROV-O) to the geospatial/imagery stack (STAC, GeoSPARQL, IIIF) for historic aerial photography. NAPH is that bridge, wrapped in FAIR and CARE, across three incrementally-adoptable tiers." || `real-demo-world.png` | Hero / scope | "292 real NCAP frames, harvested live and auto-lifted to a computation-ready standard. Hong Kong 1924 to the Caribbean, 1924 to 1956, every one queryable by space and time. Open source." || `real-demo-europe.png` | Detail view | "Every frame becomes a full linked-data record: sortie, ISO date, WGS84 footprint, perspective, camera, collection context and a link back to the source. Click any footprint." |+| `real-demo-three-country.png` | Hero / portability | "One standard, three national collections. NCAP (UK), NAPL (Canada) and WHAIFinder (USA), harvested live from public endpoints and lifted to the same NAPH Baseline, 0 SHACL violations. Each archive was missing a different Baseline piece (rights in the UK, frame granularity in Canada, footprint geometry in the US) and each was closed by a different single transform, with the ontology, shapes and crosswalk unchanged." |+| `real-demo-canada.png` | Canada proof | "Canada's National Air Photo Library, lifted to NAPH Baseline from the open Government of Canada CKAN API. 8 temporal-series regions, native-WGS84 footprints, 100% machine-readable Open Government Licence rights, 0 SHACL violations." |+| `real-demo-usa.png` | US proof | "225 real Wisconsin Historic Aerial Imagery frames (1937 to 1967, public-domain USDA) from the open ArcGIS FeatureServer, no token needed. The US index publishes a centerpoint not a polygon, so each footprint is reconstructed closed-form from centerpoint plus map scale. 0 SHACL violations." |++The three-country maps are generated by `demo/world-maps.html` (Leaflet + CARTO+basemap), screenshotted with headless Chrome at `#all`, `#canada`, `#usa`:++```bash+python3 -m http.server 8799 &+CHROME="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"+for v in all:three-country canada:canada usa:usa; do+ "$CHROME" --headless=new --window-size=1680,1000 --virtual-time-budget=11000 \+ --force-device-scale-factor=2 --screenshot="assets/real-demo-${v#*:}.png" \+ "http://localhost:8799/demo/world-maps.html#${v%:*}"+done+```## Regeneratediff --git a/case-studies/heritage-aerial/assets/real-demo-canada.png b/case-studies/heritage-aerial/assets/real-demo-canada.pngnew file mode 100644index 00000000..dd31ab56Binary files /dev/null and b/case-studies/heritage-aerial/assets/real-demo-canada.png differdiff --git a/case-studies/heritage-aerial/assets/real-demo-three-country.png b/case-studies/heritage-aerial/assets/real-demo-three-country.pngnew file mode 100644index 00000000..2f1134adBinary files /dev/null and b/case-studies/heritage-aerial/assets/real-demo-three-country.png differdiff --git a/case-studies/heritage-aerial/assets/real-demo-usa.png b/case-studies/heritage-aerial/assets/real-demo-usa.pngnew file mode 100644index 00000000..a301f9a9Binary files /dev/null and b/case-studies/heritage-aerial/assets/real-demo-usa.png differdiff --git a/case-studies/heritage-aerial/demo/world-maps.html b/case-studies/heritage-aerial/demo/world-maps.htmlnew file mode 100644index 00000000..8b81f2c6--- /dev/null+++ b/case-studies/heritage-aerial/demo/world-maps.html@@ -0,0 +1,122 @@+<!DOCTYPE html>+<html lang="en">+<head>+<meta charset="utf-8">+<meta name="viewport" content="width=device-width, initial-scale=1">+<title>NAPH — Three national aerial collections, one standard</title>+<link rel="stylesheet" href="https://unpkg.com/[email protected]/dist/leaflet.css"+ integrity="sha256-p4NxAoJBhIIN+hmNHrzRCf9tD/miZyoHS5obTRR9BMY="+ crossorigin="">+<script src="https://unpkg.com/[email protected]/dist/leaflet.js"+ integrity="sha256-20nQCchB9co0qIjJZRGuk2/Z9VM+kNiyxNV1lvTlZBo="+ crossorigin=""></script>+<style>+ * { box-sizing: border-box; }+ html, body { margin: 0; padding: 0; height: 100%; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; color: #1a1a2a; }+ #map { position: absolute; inset: 0; }+ .titlecard {+ position: absolute; z-index: 1000; top: 18px; left: 18px; max-width: 520px;+ background: rgba(49,59,69,0.94); color: #fff; padding: 16px 20px; border-radius: 10px;+ box-shadow: 0 6px 22px rgba(0,0,0,0.28);+ }+ .titlecard h1 { margin: 0 0 6px 0; font-size: 1.25em; font-weight: 650; }+ .titlecard p { margin: 0; font-size: 0.86em; line-height: 1.4; opacity: 0.92; }+ .live { display:inline-block; background:#3a9e99; color:#fff; font-size:0.62em; font-weight:700;+ padding:0.18em 0.6em; border-radius:0.35em; letter-spacing:0.05em; vertical-align:middle; margin-left:0.4em; }+ .legend {+ position: absolute; z-index: 1000; bottom: 22px; left: 18px;+ background: #fff; padding: 12px 16px; border-radius: 9px; box-shadow: 0 4px 16px rgba(0,0,0,0.2);+ font-size: 0.85em;+ }+ .legend .row { display:flex; align-items:center; gap:8px; margin: 4px 0; }+ .legend .sw { width: 15px; height: 15px; border-radius: 3px; display:inline-block; border: 1px solid rgba(0,0,0,0.25); }+ .legend b { font-weight: 650; }+ .legend .n { color:#666; font-size: 0.92em; }+ .attribution-note { position:absolute; z-index:1000; bottom: 4px; right: 8px; font-size: 0.7em; color:#555; background: rgba(255,255,255,0.7); padding: 2px 6px; border-radius: 4px; }+</style>+</head>+<body>+<div id="map"></div>+<div class="titlecard">+ <h1 id="tc-title">Three national aerial collections, one standard <span class="live">REAL DATA</span></h1>+ <p id="tc-sub">NCAP (UK), NAPL (Canada) and WHAIFinder (USA) harvested live from public+ endpoints and lifted to the same NAPH Baseline. 0 SHACL violations. The ontology,+ shapes and crosswalk are identical across all three; only the harvester differs.</p>+</div>+<div class="legend" id="legend"></div>+<div class="attribution-note">Basemap © OpenStreetMap, © CARTO · Footprints: NCAP · NRCan NAPL (OGL) · WHAIFinder (USDA, public domain)</div>++<script>+const SETS = {+ uk: { file: "../reports/real-footprints.geojson", color: "#2f9e99", label: "NCAP — United Kingdom", note: "292 frames · polygon footprints (reprojected EPSG:3857→WGS84)" },+ canada: { file: "../reports/real-napl-footprints.geojson", color: "#c0392b", label: "NAPL — Canada", note: "40 dated mosaics · native-WGS84 footprints · 100% OGL rights" },+ usa: { file: "../reports/real-whai-footprints.geojson", color: "#e08a1e", label: "WHAIFinder — United States", note: "225 frames · footprints reconstructed from centerpoint + scale" },+};++const map = L.map("map", { zoomControl: true, attributionControl: false }).setView([30, -40], 3);+L.tileLayer("https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png", {+ maxZoom: 19, subdomains: "abcd"+}).addTo(map);++function centroid(feat) {+ const g = feat.geometry; let ring;+ if (g.type === "Polygon") ring = g.coordinates[0];+ else if (g.type === "Point") return [g.coordinates[1], g.coordinates[0]];+ else ring = g.coordinates[0][0];+ let x=0,y=0; ring.forEach(p=>{x+=p[0];y+=p[1];});+ return [y/ring.length, x/ring.length];+}++const layers = {};+let pending = Object.keys(SETS).length;+const hash = (location.hash || "#all").replace("#","");++Object.entries(SETS).forEach(([key, s]) => {+ fetch(s.file).then(r=>r.json()).then(gj => {+ const grp = L.featureGroup();+ L.geoJSON(gj, {+ style: { color: s.color, weight: 1.2, fillColor: s.color, fillOpacity: 0.28 },+ pointToLayer: (f, ll) => L.circleMarker(ll, { radius: 4, color: s.color, fillColor: s.color, fillOpacity: 0.7, weight: 1 })+ }).addTo(grp);+ // always-visible centroid dots so small footprints read at world scale+ gj.features.forEach(f => {+ if (f.geometry.type !== "Point")+ L.circleMarker(centroid(f), { radius: 3.5, color: s.color, fillColor: s.color, fillOpacity: 0.85, weight: 0.8 }).addTo(grp);+ });+ grp.addTo(map);+ layers[key] = grp;+ s.count = gj.features.length;+ }).catch(e => console.error(key, e)).finally(() => {+ if (--pending === 0) finalize();+ });+});++function finalize() {+ // legend+ const leg = document.getElementById("legend");+ leg.innerHTML = "<b>Collection</b>";+ Object.entries(SETS).forEach(([k, s]) => {+ leg.innerHTML += `<div class="row"><span class="sw" style="background:${s.color}"></span>`+ + `<span><b>${s.label}</b><br><span class="n">${s.note}</span></span></div>`;+ });++ // view + optional single-country focus+ if (hash === "canada" && layers.canada) {+ map.fitBounds(layers.canada.getBounds().pad(0.15));+ setTitle("Canada — NAPL open data, lifted to NAPH Baseline",+ "8 National Air Photo Library temporal-series regions (1932–2004) harvested from the open Government of Canada CKAN API. Native-WGS84 footprints, 100% machine-readable OGL rights, 0 SHACL violations.");+ } else if (hash === "usa" && layers.usa) {+ map.fitBounds(layers.usa.getBounds().pad(0.15));+ setTitle("United States — WHAIFinder frames, footprints reconstructed",+ "225 real Wisconsin Historic Aerial Imagery frames (1937–1967, public-domain USDA) from the open ArcGIS FeatureServer. Each footprint reconstructed closed-form from centerpoint + map scale. 0 SHACL violations.");+ } else {+ const all = L.featureGroup(Object.values(layers));+ try { map.fitBounds(all.getBounds().pad(0.05)); } catch(e){}+ }+ document.body.setAttribute("data-ready", "1");+}+function setTitle(t, s){ document.getElementById("tc-title").innerHTML = t + ' <span class="live">REAL DATA</span>';+ document.getElementById("tc-sub").textContent = s; }+</script>+</body>+</html>diff --git a/case-studies/heritage-aerial/docs/canada-napl-findings.md b/case-studies/heritage-aerial/docs/canada-napl-findings.mdindex 6a65af0d..67f5cdb9 100644--- a/case-studies/heritage-aerial/docs/canada-napl-findings.md+++ b/case-studies/heritage-aerial/docs/canada-napl-findings.md@@ -15,6 +15,13 @@ the ontology, SHACL shapes and RiC-O × STAC crosswalk are unchanged — only ththin harvester adapter differs. A US adapter pattern is documented at[`pipeline/scrapers/usgs_earthexplorer.py`](../pipeline/scrapers/usgs_earthexplorer.py).+++*8 NAPL Temporal Series regions (red) harvested live from the open Government of+Canada CKAN API and lifted to NAPH Baseline. The amber cluster is the US+WHAIFinder sample; teal is NCAP (UK) — same standard, three collections.*+## Headline> Where NCAP was missing exactly one Baseline field (machine-readable rights,diff --git a/case-studies/heritage-aerial/docs/usa-whaifinder-findings.md b/case-studies/heritage-aerial/docs/usa-whaifinder-findings.mdindex c54f4cfd..63807cce 100644--- a/case-studies/heritage-aerial/docs/usa-whaifinder-findings.md+++ b/case-studies/heritage-aerial/docs/usa-whaifinder-findings.md@@ -8,6 +8,13 @@ public-domain USDA survey photography — read from its public **ArcGISFeatureServer** on 2 July 2026. Metadata only; read-only; no authentication. See[`pipeline/scrapers/whaifinder_arcgis.py`](../pipeline/scrapers/whaifinder_arcgis.py).*+++*225 real Wisconsin Historic Aerial Imagery frames (1937–1967, public-domain USDA),+harvested live from the open ArcGIS FeatureServer. Each footprint reconstructed+closed-form from the published centerpoint plus map scale.*+## Why not USGSThe obvious US target is the USGS EROS "Aerial Photo Single Frames" archive (6.5M@@ -61,6 +68,13 @@ the substrate (centerpoint + scale) was already in the data.## Three collections, three different transforms — same standard+++*NCAP (teal, UK), NAPL (red, Canada) and WHAIFinder (amber, USA), harvested live+from public endpoints and lifted to the same NAPH Baseline with 0 SHACL violations.+Same ontology, shapes and crosswalk throughout; only the harvester differs.*+| | **NCAP (UK)** | **NAPL (Canada)** | **WHAIFinder (USA)** ||---|---|---|---|| Geometry | polygon, **EPSG:3857** | polygon, **native WGS84** | **point centerpoint** |