build: track the OpenAPI spec and regenerate the client in pre-commit

.pre-commit-config.yaml

@@ -68,6 +68,14 @@ repos:
         require_serial: true
         files: ^backend/
 
+      - id: generate-client
+        name: OpenAPI spec and client
+        entry: make generate-client
+        language: system
+        pass_filenames: false
+        require_serial: true
+        files: ^(backend/src/|backend/uv\.lock$|scripts/generate-client-sdk\.sh$|backend/openapi\.json$|frontend/openapi-ts\.config\.ts$|frontend/package\.json$)
+
   # Frontend: Biome format + lint
   # Both hooks use the versions pinned in frontend/package.json, not whatever npx resolves.
   - repo: local

README.md

@@ -125,6 +125,7 @@ ref-app/
 │   │   ├── collections/     # Per-collection YAML metadata (see collections/README.md)
 │   │   └── diagnostics/     # Diagnostic metadata overrides
 │   ├── tests/               # Backend test suite
+│   ├── openapi.json         # OpenAPI specification (generated by make generate-client)
 │   ├── pyproject.toml       # Python dependencies and project metadata
 │   └── uv.lock              # uv lock file for reproducible dependencies
 ├── frontend/
@@ -137,8 +138,7 @@ ref-app/
 │   │   ├── lib/             # Utility functions
 │   │   └── styles/          # Global styles
 │   ├── package.json         # Node.js dependencies
-│   ├── vite.config.ts       # Vite build configuration
-│   └── openapi.json         # OpenAPI specification (generated from backend)
+│   └── vite.config.ts       # Vite build configuration
 └── scripts/                 # Utility scripts
 ```