Initial public release

contracts/api/examples/area_create.geojson

@@ -0,0 +1,8 @@
+{
+  "type": "Feature",
+  "properties": {"name": "Geel demo area"},
+  "geometry": {
+    "type": "Polygon",
+    "coordinates": [[[4.98,51.16],[4.99,51.16],[4.99,51.17],[4.98,51.17],[4.98,51.16]]]
+  }
+}

contracts/api/examples/error_feature_disabled.json

@@ -0,0 +1,7 @@
+{
+  "error": {
+    "code": "FEATURE_DISABLED",
+    "message": "This feature is disabled in the current milestone.",
+    "details": {"feature": "LIDAR_LAB", "target_milestone": "V4"}
+  }
+}

contracts/api/examples/project_create.json

@@ -0,0 +1,5 @@
+{
+  "name": "Geel Building QA Demo",
+  "description": "Detect buildings and compare against reference polygons.",
+  "region": "Kempen"
+}

contracts/api/examples/qaqc_result.json

@@ -0,0 +1,6 @@
+{
+  "analysis_run_id": "demo-qaqc-run",
+  "metrics": {"precision": 0.92, "recall": 0.88, "f1": 0.90, "mean_iou": 0.71},
+  "counts": {"true_positive": 23, "false_positive": 2, "false_negative": 3},
+  "layers": {"matches": "exports/demo_matches.geojson", "false_positives": "exports/demo_fp.geojson", "false_negatives": "exports/demo_fn.geojson"}
+}

contracts/api/response-envelope.md

@@ -0,0 +1,53 @@
+# API Response and Error Contract
+
+## Standard error
+
+All API errors must use:
+
+```json
+{
+  "error": {
+    "code": "STRING_CODE",
+    "message": "Human readable message.",
+    "details": {}
+  }
+}
+```
+
+## Job response
+
+Long-running operations return:
+
+```json
+{
+  "job_id": "uuid",
+  "analysis_run_id": "uuid",
+  "status": "queued",
+  "status_url": "/analysis-runs/{id}"
+}
+```
+
+## Resource metadata
+
+Resources should include:
+
+```json
+{
+  "id": "uuid",
+  "created_at": "ISO-8601",
+  "updated_at": "ISO-8601"
+}
+```
+
+## Pagination
+
+List endpoints use:
+
+```json
+{
+  "items": [],
+  "total": 0,
+  "limit": 50,
+  "offset": 0
+}
+```