Initial public release

2026-08-31 21:56:53 +02:00
commit faeb58ef6d
1386 changed files with 263203 additions and 0 deletions
@@ -0,0 +1,28 @@
+# ADR-007 — API Design
+
+## Status
+Accepted for V1.
+
+## Context
+The frontend must be API-driven and Codex must not invent inconsistent response shapes.
+
+## Decision
+Use REST-style FastAPI endpoints with typed Pydantic schemas. Responses use stable envelopes for long-running jobs and direct resources for simple CRUD operations.
+
+Errors use a common structure:
+
+```json
+{
+  "error": {
+    "code": "DATASET_NOT_FOUND",
+    "message": "Dataset not found.",
+    "details": {}
+  }
+}
+```
+
+## Consequences
+Frontend API clients, tests, and docs stay consistent.
+
+## Non-goals
+No GraphQL in V1.