@goable-io/sdk 0.3.0 → 0.5.0

package/dist/generated/api.d.ts

@@ -118,6 +118,11 @@ export interface paths {
                         /** @description L2a probabilistic ensemble (Pro+) */
                         ensemble?: boolean;
                         members?: number;
+                        /**
+                         * @description Skill-conditioned scoring (Pro+).
+                         * @enum {string}
+                         */
+                        rider_skill_level?: "beginner" | "intermediate" | "expert";
                     };
                 };
             };
@@ -125,13 +130,19 @@ export interface paths {
                 /** @description Score 0-100 + verdict + confidence + eco + calibration_provenance */
                 200: {
                     headers: {
+                        /** @description Daily safety cap for this endpoint + plan (not the monthly billing quota). Omitted on unlimited (Scale) plans. */
+                        "X-RateLimit-Limit"?: number;
+                        /** @description Requests remaining in the current UTC-midnight daily window. Omitted on unlimited (Scale) plans. */
+                        "X-RateLimit-Remaining"?: number;
+                        /** @description Unix timestamp (seconds) at which the daily window resets. Omitted on unlimited (Scale) plans. */
+                        "X-RateLimit-Reset"?: number;
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": components["schemas"]["ScoreResponse"];
                     };
                 };
-                /** @description Plan upgrade required (ensemble on Free/Starter) */
+                /** @description Plan upgrade required (ensemble or rider_skill_level on Free/Starter) */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -158,6 +169,17 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Daily rate limit (safety cap) exceeded for this endpoint + plan. */
+                429: {
+                    headers: {
+                        /** @description Seconds until the daily rate-limit window resets. Present only on this 429 response. */
+                        "Retry-After"?: number;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -296,7 +318,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Historical climatology scoring (Pro+) */
+        /**
+         * Historical climatology scoring (Pro+)
+         * @description Percentiles + exceedance + verdict frequency over ERA5 reanalysis. Each entry carries a historical-mode ConfidenceDetail block (see components.schemas.ConfidenceDetailHistorical).
+         */
         post: {
             parameters: {
                 query?: never;
@@ -327,7 +352,7 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description Percentiles + exceedance + verdict frequency */
+                /** @description Percentiles + exceedance + verdict frequency (per-entry confidenceDetail: historical) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -478,7 +503,7 @@ export interface paths {
                             binding_constraint?: boolean;
                             best_window_24h?: boolean;
                             best_nearby_spot_km?: number;
-                            /** @description LLM explanation (Pro+) */
+                            /** @description LLM explanation. Available on any plan (Anthropic BYOK) — resolves the tenant's own Anthropic key set via PUT /v1/tenant/llm-key; no key configured degrades to a deterministic template (natural_language.degraded_mode=true) rather than an error. */
                             natural_language?: boolean;
                         };
                     };
@@ -496,15 +521,6 @@ export interface paths {
                         };
                     };
                 };
-                /** @description natural_language=true requires Pro+ */
-                402: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description No profile for activity */
                 404: {
                     headers: {
@@ -540,7 +556,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Personalized go/no-go decision (Pro+) */
+        /** Personalized go/no-go decision (any plan — Anthropic BYOK) */
         post: {
             parameters: {
                 query?: never;
@@ -570,7 +586,7 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description score + verdict + decision block + degraded_mode + advisory_notice */
+                /** @description score + verdict + decision block + degraded_mode + advisory_notice. Available on any plan; the LLM reasoning narrative requires the tenant's own Anthropic key (PUT /v1/tenant/llm-key) — without one, degraded_mode=true and a deterministic template is returned instead of an error. */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -581,15 +597,6 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Requires Pro+ plan */
-                402: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description No profile for activity */
                 404: {
                     headers: {
@@ -661,7 +668,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** LLM narrative explanation of a score (L2c, Pro+) */
+        /**
+         * LLM narrative explanation of a score (L2c, any plan — Anthropic BYOK)
+         * @description Requires the tenant to have its own Anthropic key set via PUT /v1/tenant/llm-key — no longer plan-gated. No key configured → 503 INTELLIGENCE_UNAVAILABLE.
+         */
         post: {
             parameters: {
                 query?: never;
@@ -695,8 +705,8 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Requires Pro+ plan */
-                402: {
+                /** @description Validation error */
+                422: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -704,8 +714,8 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
-                422: {
+                /** @description No Anthropic key configured for this tenant */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -730,7 +740,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** LLM multi-slot briefing (L2c, Pro+) */
+        /**
+         * LLM multi-slot briefing (L2c, any plan — Anthropic BYOK)
+         * @description Requires the tenant to have its own Anthropic key set via PUT /v1/tenant/llm-key — no longer plan-gated. No key configured → 503 INTELLIGENCE_UNAVAILABLE.
+         */
         post: {
             parameters: {
                 query?: never;
@@ -764,8 +777,8 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Requires Pro+ plan */
-                402: {
+                /** @description Validation error */
+                422: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -773,8 +786,8 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
-                422: {
+                /** @description No Anthropic key configured for this tenant */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -790,17 +803,58 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/projections": {
+    "/v1/tenant/llm-key": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /** Climate-decadal activity viability projection (Scale) */
-        post: {
+        /**
+         * Get the tenant's Anthropic key status (Anthropic BYOK)
+         * @description Never returns the key — only whether one is set, its last 4 characters, and timestamps.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Masked key status */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            set: boolean;
+                            last4?: string;
+                            /** Format: date-time */
+                            setAt?: string;
+                            /** Format: date-time */
+                            lastValidatedAt?: string | null;
+                        };
+                    };
+                };
+                /** @description BYOK storage not configured on this deployment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        /**
+         * Set/rotate the tenant's Anthropic API key (Anthropic BYOK)
+         * @description Validates the key with one cheap Anthropic API call before storing. Encrypts at rest (AES-256-GCM); the plaintext key is NEVER echoed back by this or any other endpoint. Available to any authenticated plan. Rate-limited (this call itself makes one real Anthropic API request).
+         */
+        put: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -810,32 +864,30 @@ export interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        spot: {
-                            location: components["schemas"]["GeoPoint"];
-                            activity: string;
-                            spotId?: string;
-                        };
-                        scenarios: ("SSP1-2.6" | "SSP2-4.5" | "SSP3-7.0" | "SSP5-8.5")[];
-                        horizonDecades?: string[];
-                        /** @enum {string} */
-                        baselineDecade?: "2020s" | "2030s";
+                        /** @description The tenant's own Anthropic API key (sk-ant-...). */
+                        apiKey: string;
                     };
                 };
             };
             responses: {
-                /** @description Per-decade projection distributions */
-                200: {
+                /** @description Key validated, encrypted, and stored. */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Validation error, or Anthropic rejected the key (LLM_KEY_INVALID) */
+                422: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            [key: string]: unknown;
-                        };
+                        "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Requires Scale plan */
-                402: {
+                /** @description Rate limited */
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -843,8 +895,40 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
-                422: {
+                /** @description BYOK storage or BYOK_MASTER_KEY not configured on this deployment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        /**
+         * Remove the tenant's Anthropic key (Anthropic BYOK)
+         * @description Hard-deletes the stored ciphertext. LLM routes revert to the no-key degraded/503 path for this tenant.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Key removed. */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description BYOK storage not configured on this deployment */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -854,13 +938,12 @@ export interface paths {
                 };
             };
         };
-        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/underwriting/quote": {
+    "/v1/projections": {
         parameters: {
             query?: never;
             header?: never;
@@ -869,7 +952,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Parametric underwriting quote (Scale) */
+        /**
+         * Climate-decadal activity viability projection (Scale)
+         * @description Per-decade projection distributions. Each entry carries a climate-mode ConfidenceDetail block (see components.schemas.ConfidenceDetailClimate).
+         */
         post: {
             parameters: {
                 query?: never;
@@ -880,36 +966,20 @@ export interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        spot?: {
-                            location: components["schemas"]["GeoPoint"];
-                            activity: string;
-                            spotId?: string;
-                        };
-                        portfolio?: {
+                        spot: {
                             location: components["schemas"]["GeoPoint"];
                             activity: string;
                             spotId?: string;
-                        }[];
-                        coverageWindow: {
-                            monthFrom: number;
-                            dayFrom: number;
-                            monthTo: number;
-                            dayTo: number;
-                        } & {
-                            [key: string]: unknown;
-                        };
-                        payout?: {
-                            amount: number;
-                            /** @enum {string} */
-                            currency: "EUR" | "USD" | "GBP" | "CHF";
                         };
-                    } & {
-                        [key: string]: unknown;
+                        scenarios: ("SSP1-2.6" | "SSP2-4.5" | "SSP3-7.0" | "SSP5-8.5")[];
+                        horizonDecades?: string[];
+                        /** @enum {string} */
+                        baselineDecade?: "2020s" | "2030s";
                     };
                 };
             };
             responses: {
-                /** @description Premium + bindable policy terms */
+                /** @description Per-decade projection distributions (per-entry confidenceDetail: climate) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -946,7 +1016,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/underwriting/bind": {
+    "/v1/underwriting/quote": {
         parameters: {
             query?: never;
             header?: never;
@@ -956,8 +1026,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Bind a parametric policy (Scale)
-         * @description Convert a recent /v1/underwriting/quote into a bound policy. Submit the quoteId (≤24h old); returns a policyId + immutable cohortHash anchoring the bound weather sample set.
+         * Parametric underwriting quote (Scale)
+         * @description Multi-currency `expectedPremium.byCurrency` — a mixed-currency portfolio returns per-currency stats with no FX conversion. `policy.spot.tier` / `policy.portfolio[i].tier` echo the resolved sub-spot tier (1/2/3) or null when no sub-spot covers the point; `tierSource` marks whether it came from the catalog YAML or L11's data-driven classifier.
          */
         post: {
             parameters: {
@@ -969,25 +1039,65 @@ export interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        quoteId: string;
-                        premiumConfirmation?: {
-                            [key: string]: unknown;
+                        spot?: {
+                            point: components["schemas"]["GeoPoint"];
+                            activity: string;
+                            spotId?: string;
+                            payout: {
+                                amount: number;
+                                /** @enum {string} */
+                                currency: "EUR" | "USD" | "GBP" | "CHF";
+                            };
                         };
-                    } & {
-                        [key: string]: unknown;
+                        portfolio?: {
+                            point: components["schemas"]["GeoPoint"];
+                            activity: string;
+                            spotId?: string;
+                            payout: {
+                                amount: number;
+                                /** @enum {string} */
+                                currency: "EUR" | "USD" | "GBP" | "CHF";
+                            };
+                        }[];
+                        coverageWindow: {
+                            monthFrom: number;
+                            dayFrom: number;
+                            monthTo: number;
+                            dayTo: number;
+                        };
+                        trigger: {
+                            /** @enum {string} */
+                            kind: "scoreBelow";
+                            scoreBelow: number;
+                            consecutiveHours?: number;
+                            cooldownHours?: number;
+                            maxPayoutsPerYear?: number;
+                        } | {
+                            /** @enum {string} */
+                            kind: "verdictAtOrBelow";
+                            verdict: components["schemas"]["Verdict"];
+                            consecutiveHours?: number;
+                            cooldownHours?: number;
+                            maxPayoutsPerYear?: number;
+                        };
+                        historicalYearsRange?: {
+                            from: number;
+                            to: number;
+                        };
+                        loadingFactor?: number;
+                        calibrationConfidenceMin?: number;
+                        forceIssue?: boolean;
                     };
                 };
             };
             responses: {
-                /** @description Bound policy id + cohort hash + settlement schedule */
+                /** @description Premium + policy echo (with per-spot tier + tierSource) + bindable quote id when policy store is wired */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            [key: string]: unknown;
-                        };
+                        "application/json": components["schemas"]["UnderwritingQuoteResponse"];
                     };
                 };
                 /** @description Requires Scale plan */
@@ -999,7 +1109,7 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Quote expired or not found */
+                /** @description No profile for activity */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -1008,7 +1118,7 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
+                /** @description Validation error / low confidence / invalid trigger */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -1017,6 +1127,15 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description HistoricalProvider not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -1025,43 +1144,35 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/underwriting/evaluate": {
+    "/v1/underwriting/quote/{id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Read-only payout projection for a bound policy (Scale)
-         * @description Returns the current accrued shortfall + projected payout for a bound policy. Does NOT settle — settlement runs automatically on a cron at policy expiry.
+         * Fetch a bindable quote by id (Scale)
+         * @description Tenant-scoped read of a quote created via POST /v1/underwriting/quote. Returns the same body shape as the create response (with the optional `boundPolicyId` populated once the quote has been bound).
          */
-        post: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        policyId: string;
-                    };
+                path: {
+                    id: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Accrued shortfall + projected payout per currency */
+                /** @description Quote record (may include boundPolicyId when already bound) */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            [key: string]: unknown;
-                        };
+                        "application/json": components["schemas"]["UnderwritingQuoteResponse"];
                     };
                 };
                 /** @description Requires Scale plan */
@@ -1073,7 +1184,7 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Policy not found */
+                /** @description Quote not found for this tenant */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -1082,8 +1193,8 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
-                422: {
+                /** @description Quote persistence not configured */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1093,13 +1204,15 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/score/{sessionId}/outcome": {
+    "/v1/underwriting/policy/bind": {
         parameters: {
             query?: never;
             header?: never;
@@ -1109,44 +1222,57 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Report observed outcome for a scored session
-         * @description Close the calibration loop. Submit the actual outcome (ran/cancelled/no_show/rescheduled/note) of a /v1/score session. The calibration pipeline + forecast verification + drift monitor consume these. Requires the `outcomes:write` scope (live keys carry it by default; test keys don't).
+         * Bind a parametric policy (Scale)
+         * @description Convert a bindable quote (≤24h old) into a bound policy for a specific coverage year. Returns the serialised policy + the quoteId + optional `driftAdvisories` — a soft warning surfaced when the resolved cell has an open watch-level L9 drift event. A warning/critical drift event at bind time REFUSES the bind with 422 DRIFT_ACTIVE (see the 422 response). Fires the `underwriting.policy.bound` webhook on success. Supports the optional `Idempotency-Key` header (see parameter description) so a client-side retry after a network timeout can't double-bind.
          */
         post: {
             parameters: {
                 query?: never;
-                header?: never;
-                path: {
-                    /** @description Session UUID returned in the /v1/score response metadata. */
-                    sessionId: string;
+                header?: {
+                    /** @description Optional client-generated key (unique per logical request, scoped to your tenant). A retry with the SAME key and the SAME request body replays the original response verbatim without re-executing the request. A retry with the same key and a DIFFERENT body, or one that arrives while the original is still in flight, returns 409 IDEMPOTENCY_KEY_CONFLICT. Claims expire after 24h. */
+                    "Idempotency-Key"?: string;
                 };
+                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
+                        /** Format: uuid */
+                        quoteId: string;
+                        coverageYear: number;
                         /** @enum {string} */
-                        outcome_type: "ran" | "cancelled" | "rescheduled" | "no_show" | "note";
-                        detail?: {
-                            [key: string]: unknown;
-                        };
+                        premiumCollection: "external" | "stripe" | "invoice_due";
+                        premiumPaid?: number;
                     };
                 };
             };
             responses: {
-                /** @description Accepted (queued for the next calibration batch) */
-                202: {
+                /** @description Policy bound */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            [key: string]: unknown;
+                            policy: components["schemas"]["SerialisedPolicy"];
+                            /** Format: uuid */
+                            quoteId: string;
+                            /** @description Soft warnings for cells with an open watch-level L9 drift event. Present only when non-empty. */
+                            driftAdvisories?: {
+                                spotIndex: number;
+                                activity: string;
+                                subSpotSlug: string;
+                                /** @enum {string} */
+                                severity: "watch";
+                                /** Format: date-time */
+                                since: string;
+                            }[];
                         };
                     };
                 };
-                /** @description Missing scope: outcomes:write */
-                403: {
+                /** @description Requires Scale plan */
+                402: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1154,7 +1280,7 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Session not found */
+                /** @description Quote not found for this tenant */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -1163,7 +1289,16 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
+                /** @description Quote already bound to another policy (QUOTE_ALREADY_BOUND), or IDEMPOTENCY_KEY_CONFLICT — a request with this Idempotency-Key is still in flight, or was already used with a different request body */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Validation error / quote expired / quote not issuable / catalog drift / DRIFT_ACTIVE (open warning or critical drift event on resolved cell — `detail.openDriftEvents` lists each blocking cell) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -1172,6 +1307,15 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Policy persistence not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -1180,51 +1324,44 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/score/difficulty": {
+    "/v1/underwriting/policy": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Skill-conditioned scoring
-         * @description Same scoring engine, but conditioned on a rider/operator skill level. Returns the score curve as a function of skill so a booking flow can branch ("good for beginners" vs "experts only").
+         * List bound policies for the caller's tenant (Scale)
+         * @description Paginated list of every bound policy owned by the calling tenant. Ordered by boundAt DESC.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    status?: "bound" | "triggered" | "settled" | "expired";
+                    coverageYear?: number;
+                    limit?: number;
+                    cursor?: string;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        activity: string;
-                        location: components["schemas"]["GeoPoint"];
-                        window?: components["schemas"]["TimeWindow"];
-                        /** @description Skill points (0-1) to score. Defaults to 5 quantile points. */
-                        riderSkillLevels?: number[];
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Score per skill level + difficulty band */
+                /** @description Bound policies for this tenant */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            [key: string]: unknown;
+                            policies: components["schemas"]["SerialisedPolicy"][];
                         };
                     };
                 };
-                /** @description No profile for activity */
-                404: {
+                /** @description Requires Scale plan */
+                402: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1241,104 +1378,60 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Policy persistence not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/recommend-spot": {
+    "/v1/underwriting/policy/{policyId}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Spot recommender — inverse query (L10)
-         * @description Given (activity, region center, radius, window) → top-K ranked sub-spots in the catalog. Composition of L1-L3 scoring + L4.6 confidence + L6 personal blend (Pro+, when pseudonym supplied). Plan caps: radius 25/50/200/1000 km, topK 5/10/20/50 across Free / Starter / Pro / Scale. Personalization Pro+ only. Hard-gated candidates (lightning ≥ 0.85, AQI hazardous) are dropped from results; `allGated=true` distinguishes 'all in-radius spots were unsafe' from 'no spots in radius at all'.
+         * Fetch a single policy by id (Scale)
+         * @description Read-only lookup. Cross-tenant policies return 404.
          */
-        post: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        activity: string;
-                        regionCenter: components["schemas"]["GeoPoint"];
-                        radiusKm: number;
-                        topK: number;
-                        window?: components["schemas"]["TimeWindow"];
-                        /** @description Optional booking-platform-side pseudonym. When present, Pro+ tenants get personalization via the L6 cold-start blend (cap 0.5 weight). */
-                        userPseudonym?: string;
-                    };
+                path: {
+                    policyId: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Ranked top-K sub-spots + observability metadata. The optional `coverage` field appears only on empty results from a catalog gap (not from hard-gating). */
+                /** @description Policy record + payout events */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            results?: {
-                                spotSlug?: string;
-                                name?: string;
-                                location?: components["schemas"]["GeoPoint"];
-                                distanceKm?: number;
-                                score?: number;
-                                effectiveScore?: number;
-                                verdict?: string;
-                                personalScore?: number | null;
-                                personalWeight?: number;
-                                rank?: number;
-                            }[];
-                            allGated?: boolean;
-                            totalCandidates?: number;
-                            rankedCandidates?: number;
-                            effectiveRadiusKm?: number;
-                            effectiveTopK?: number;
-                            personalizationApplied?: boolean;
-                            latencyMs?: number;
-                            coverage?: {
-                                /** @enum {string} */
-                                status: "no_subspots_in_radius";
-                                nearestSubSpot: {
-                                    slug: string;
-                                    name: string;
-                                    distanceKm: number;
-                                };
-                                /** @enum {string} */
-                                suggestedAction: "expand_radius";
-                                suggestedRadiusKm: number;
-                            } | {
-                                /** @enum {string} */
-                                status: "no_subspots_for_activity";
-                                /** @enum {string} */
-                                suggestedAction: "request_coverage";
-                            };
+                            policy: components["schemas"]["SerialisedPolicy"];
+                            events: components["schemas"]["SerialisedPayoutEvent"][];
                         };
                     };
                 };
-                /** @description Missing/invalid bearer token */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Plan limit exceeded (radius or topK above plan cap) */
+                /** @description Requires Scale plan */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -1347,8 +1440,8 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error or unknown activity */
-                422: {
+                /** @description Policy not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1356,7 +1449,7 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Spatial resolver not wired */
+                /** @description Policy persistence not configured */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -1367,13 +1460,15 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/intelligence/edge-case": {
+    "/v1/underwriting/policy/{policyId}/evaluate": {
         parameters: {
             query?: never;
             header?: never;
@@ -1383,43 +1478,35 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * LLM analysis of a borderline / surprising score (L2c, Pro+)
-         * @description Asks the LLM to inspect a score that's near a verdict boundary or contradicts operator intuition. Returns a narrative + a structured `limiting_class` taxonomy entry.
+         * Re-evaluate a bound policy against historical replay (Scale)
+         * @description Runs the trigger walk against the historical archive for the policy's coverage year and inserts any newly detected payout events. No request body. Fires the `underwriting.policy.triggered` webhook the first time new events are inserted.
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        location: components["schemas"]["GeoPoint"];
-                        scoreResult?: components["schemas"]["ScoreResponse"];
-                        /** Format: uuid */
-                        session_id?: string;
-                        /** @enum {string} */
-                        locale?: "en" | "it";
-                        /** @enum {string} */
-                        model?: "claude-haiku-4-5-20251001" | "claude-sonnet-4-6";
-                    };
+                path: {
+                    policyId: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Narrative + limiting_class */
+                /** @description Policy + payout events + counts of newly inserted / skipped */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            [key: string]: unknown;
+                            policy: components["schemas"]["SerialisedPolicy"];
+                            events: components["schemas"]["SerialisedPayoutEvent"][];
+                            inserted: number;
+                            skipped: number;
                         };
                     };
                 };
-                /** @description Requires Pro+ plan */
+                /** @description Requires Scale plan */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -1428,7 +1515,16 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
+                /** @description Policy not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Policy in a terminal state (settled / expired) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -1437,6 +1533,15 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Policy persistence or HistoricalProvider not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -1445,7 +1550,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/projections/portfolio": {
+    "/v1/underwriting/policy/{policyId}/settle": {
         parameters: {
             query?: never;
             header?: never;
@@ -1454,38 +1559,37 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Climate projections across a portfolio of spots (Scale) */
+        /**
+         * Settle a bound policy (platform-ops only)
+         * @description PLATFORM-OPS ONLY — requires the `platform_admin` scope (cross-tenant Goable/underwriter operation, not a policyholder self-service action). Records the settlement wire reference + freezes the payout, and fires the `underwriting.policy.settled` webhook. Normally invoked by the daily settlement cron; use manually only for out-of-band settlement.
+         */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    policyId: string;
+                };
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        spots: {
-                            location: components["schemas"]["GeoPoint"];
-                            activity: string;
-                            spotId?: string;
-                        }[];
-                        scenarios: ("SSP1-2.6" | "SSP2-4.5" | "SSP3-7.0" | "SSP5-8.5")[];
-                        horizonDecades?: string[];
-                        /** @enum {string} */
-                        baselineDecade?: "2020s" | "2030s";
+                        settlementReference: string;
+                        /** Format: date-time */
+                        settledAt?: string;
                     };
                 };
             };
             responses: {
-                /** @description Per-spot per-decade projection distributions */
+                /** @description Settled policy */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            [key: string]: unknown;
+                            policy: components["schemas"]["SerialisedPolicy"];
                         };
                     };
                 };
@@ -1498,7 +1602,25 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
+                /** @description Missing scope: platform_admin */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Policy not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Validation error or policy not in a settleable state */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -1507,6 +1629,15 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Policy persistence not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -1515,7 +1646,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/projections/adaptation-report": {
+    "/v1/score/{sessionId}/outcome": {
         parameters: {
             query?: never;
             header?: never;
@@ -1525,37 +1656,36 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Climate adaptation report for an operator (Scale)
-         * @description Combines projections across a portfolio + qualitative summary of which dimensions are likely to bind (wind shifts, water-temp shifts, etc.). Designed as input for a tourism-board adaptation plan.
+         * Report observed outcome for a scored session
+         * @description Close the calibration loop. Submit the actual outcome (ran/cancelled/no_show/rescheduled/note) of a /v1/score session. The calibration pipeline + forecast verification + drift monitor consume these. Requires the `outcomes:write` scope (live keys carry it by default; test keys don't). Supports the optional `Idempotency-Key` header (see parameter description) so a client-side retry can't record the same outcome twice.
          */
         post: {
             parameters: {
                 query?: never;
-                header?: never;
-                path?: never;
+                header?: {
+                    /** @description Optional client-generated key (unique per logical request, scoped to your tenant). A retry with the SAME key and the SAME request body replays the original response verbatim without re-executing the request. A retry with the same key and a DIFFERENT body, or one that arrives while the original is still in flight, returns 409 IDEMPOTENCY_KEY_CONFLICT. Claims expire after 24h. */
+                    "Idempotency-Key"?: string;
+                };
+                path: {
+                    /** @description Session UUID returned in the /v1/score response metadata. */
+                    sessionId: string;
+                };
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        spots: ({
-                            location: components["schemas"]["GeoPoint"];
-                            activity: string;
-                            spotId?: string;
-                            subSpotSlug?: string;
-                        } & {
+                        /** @enum {string} */
+                        outcome_type: "ran" | "cancelled" | "rescheduled" | "no_show" | "note";
+                        detail?: {
                             [key: string]: unknown;
-                        })[];
-                        scenarios: ("SSP1-2.6" | "SSP2-4.5" | "SSP3-7.0" | "SSP5-8.5")[];
-                        horizonDecades?: string[];
-                    } & {
-                        [key: string]: unknown;
+                        };
                     };
                 };
             };
             responses: {
-                /** @description Adaptation report + binding-dimension summary */
-                200: {
+                /** @description Accepted (queued for the next calibration batch) */
+                202: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1565,8 +1695,8 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Requires Scale plan */
-                402: {
+                /** @description Missing scope: outcomes:write */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1574,8 +1704,8 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
-                422: {
+                /** @description Session not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1583,15 +1713,33 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-            };
-        };
-        delete?: never;
-        options?: never;
+                /** @description IDEMPOTENCY_KEY_CONFLICT — a request with this Idempotency-Key is still in flight, or was already used with a different request body */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/observations": {
+    "/v1/score/difficulty": {
         parameters: {
             query?: never;
             header?: never;
@@ -1601,8 +1749,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Submit station observation for data assimilation (Pro+)
-         * @description Push tenant-station observations (wind / wave / temperature / etc.) into the 0-6h assimilation window. The optimal-interpolation blending pulls them into forecast samples for nearby spots, improving short-horizon skill.
+         * L15 intrinsic-difficulty atlas lookup (Pro+)
+         * @description Returns the per-dimension intrinsic difficulty curve δ(x) for the sub-spot the (activity, location) resolves to. Pure atlas read — no scoring, no weather fetch. 404 NO_DIFFICULTY_ATLAS when the sub-spot resolves but no atlas row exists yet (dormant cell — communicated honestly rather than synthesised).
          */
         post: {
             parameters: {
@@ -1614,28 +1762,35 @@ export interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        /** Format: uuid */
-                        stationId: string;
-                        /** Format: date-time */
-                        observedAt: string;
-                        values: {
-                            [key: string]: number;
-                        };
-                        qualityFlags?: {
-                            [key: string]: unknown;
-                        };
+                        activity: string;
+                        location: components["schemas"]["GeoPoint"];
                     };
                 };
             };
             responses: {
-                /** @description Accepted */
-                202: {
+                /** @description Per-dimension intrinsic difficulty curves for the resolved sub-spot */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            [key: string]: unknown;
+                            resolved: {
+                                /** @enum {string} */
+                                level: "sub-spot" | "cluster" | "region" | "base";
+                                slug: string;
+                                sub_spot_slug?: string;
+                                distance_to_sub_spot_m?: number;
+                            };
+                            dimensions: {
+                                dimension: string;
+                                grid: number[];
+                                difficulty: number[];
+                                discrimination_a: number;
+                                cohort_hash: string;
+                                /** Format: date-time */
+                                computed_at: string;
+                            }[];
                         };
                     };
                 };
@@ -1648,7 +1803,7 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Station not found */
+                /** @description No profile for activity, or no atlas row for the resolved sub-spot */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -1666,6 +1821,15 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Difficulty atlas reader not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -1674,38 +1838,19 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/observations/stations": {
+    "/v1/recommend-spot": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List tenant stations */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Array of stations */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            [key: string]: unknown;
-                        };
-                    };
-                };
-            };
-        };
+        get?: never;
         put?: never;
-        /** Register a tenant observation station (Pro+) */
+        /**
+         * Spot recommender — inverse query (L10)
+         * @description Given (activity, region center, radius, window) → top-K ranked sub-spots in the catalog. Composition of L1-L3 scoring + L4.6 confidence + L6 personal blend (Pro+, when pseudonym supplied). Plan caps: radius 25/50/200/1000 km, topK 5/10/20/50 across Free / Starter / Pro / Scale. Personalization Pro+ only. Hard-gated candidates (lightning ≥ 0.85, AQI hazardous) are dropped from results; `allGated=true` distinguishes 'all in-radius spots were unsafe' from 'no spots in radius at all'.
+         */
         post: {
             parameters: {
                 query?: never;
@@ -1716,30 +1861,79 @@ export interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        name: string;
-                        location: components["schemas"]["GeoPoint"];
-                        elevationM?: number;
-                        metadata?: {
-                            [key: string]: unknown;
-                        };
-                    } & {
-                        [key: string]: unknown;
+                        activity: string;
+                        regionCenter: components["schemas"]["GeoPoint"];
+                        radiusKm: number;
+                        topK: number;
+                        window?: components["schemas"]["TimeWindow"];
+                        /** @description Optional booking-platform-side pseudonym. When present, Pro+ tenants get personalization via the L6 cold-start blend (cap 0.5 weight). */
+                        userPseudonym?: string;
                     };
                 };
             };
             responses: {
-                /** @description Station created */
-                201: {
+                /** @description Ranked top-K sub-spots + observability metadata. The optional `coverage` field appears only on empty results from a catalog gap (not from hard-gating). */
+                200: {
                     headers: {
+                        /** @description Daily safety cap for this endpoint + plan (not the monthly billing quota). Omitted on unlimited (Scale) plans. */
+                        "X-RateLimit-Limit"?: number;
+                        /** @description Requests remaining in the current UTC-midnight daily window. Omitted on unlimited (Scale) plans. */
+                        "X-RateLimit-Remaining"?: number;
+                        /** @description Unix timestamp (seconds) at which the daily window resets. Omitted on unlimited (Scale) plans. */
+                        "X-RateLimit-Reset"?: number;
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            [key: string]: unknown;
+                            results?: {
+                                spotSlug?: string;
+                                name?: string;
+                                location?: components["schemas"]["GeoPoint"];
+                                distanceKm?: number;
+                                score?: number;
+                                effectiveScore?: number;
+                                verdict?: string;
+                                personalScore?: number | null;
+                                personalWeight?: number;
+                                rank?: number;
+                            }[];
+                            allGated?: boolean;
+                            totalCandidates?: number;
+                            rankedCandidates?: number;
+                            effectiveRadiusKm?: number;
+                            effectiveTopK?: number;
+                            personalizationApplied?: boolean;
+                            latencyMs?: number;
+                            coverage?: {
+                                /** @enum {string} */
+                                status: "no_subspots_in_radius";
+                                nearestSubSpot: {
+                                    slug: string;
+                                    name: string;
+                                    distanceKm: number;
+                                };
+                                /** @enum {string} */
+                                suggestedAction: "expand_radius";
+                                suggestedRadiusKm: number;
+                            } | {
+                                /** @enum {string} */
+                                status: "no_subspots_for_activity";
+                                /** @enum {string} */
+                                suggestedAction: "request_coverage";
+                            };
                         };
                     };
                 };
-                /** @description Requires Pro+ plan */
+                /** @description Missing/invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Plan limit exceeded (radius or topK above plan cap) */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -1748,7 +1942,7 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Validation error */
+                /** @description Validation error or unknown activity */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -1757,6 +1951,26 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Daily rate limit (safety cap) exceeded for this endpoint + plan. */
+                429: {
+                    headers: {
+                        /** @description Seconds until the daily rate-limit window resets. Present only on this 429 response. */
+                        "Retry-After"?: number;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Spatial resolver not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -1765,7 +1979,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/observations/stations/{stationId}": {
+    "/v1/intelligence/edge-case": {
         parameters: {
             query?: never;
             header?: never;
@@ -1774,36 +1988,33 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        /** Update a station (Pro+) */
-        patch: {
+        /**
+         * LLM analysis of a borderline / surprising score (L2c, any plan — Anthropic BYOK)
+         * @description Asks the LLM to inspect a score that's near a verdict boundary or contradicts operator intuition. Returns a narrative + a structured `limiting_class` taxonomy entry. Requires the tenant's own Anthropic key (PUT /v1/tenant/llm-key) — no longer plan-gated.
+         */
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    stationId: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        name?: string;
-                        location?: components["schemas"]["GeoPoint"];
-                        elevationM?: number;
-                        metadata?: {
-                            [key: string]: unknown;
-                        };
-                    } & {
-                        [key: string]: unknown;
+                        location: components["schemas"]["GeoPoint"];
+                        scoreResult?: components["schemas"]["ScoreResponse"];
+                        /** Format: uuid */
+                        session_id?: string;
+                        /** @enum {string} */
+                        locale?: "en" | "it";
+                        /** @enum {string} */
+                        model?: "claude-haiku-4-5-20251001" | "claude-sonnet-4-6";
                     };
                 };
             };
             responses: {
-                /** @description Updated station */
+                /** @description Narrative + limiting_class */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -1814,8 +2025,8 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Requires Pro+ plan */
-                402: {
+                /** @description Validation error */
+                422: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1823,8 +2034,8 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Station not found */
-                404: {
+                /** @description No Anthropic key configured for this tenant */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1834,9 +2045,13 @@ export interface paths {
                 };
             };
         };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
         trace?: never;
     };
-    "/v1/public/signup": {
+    "/v1/projections/portfolio": {
         parameters: {
             query?: never;
             header?: never;
@@ -1845,10 +2060,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Self-service tenant signup (no auth)
-         * @description Public endpoint, IP-rate-limited (3 attempts / 24h / IP). Creates a tenant + sends a magic-link to the contact email. Always returns 202 on success — never reveals whether an email is already registered. Optional Cloudflare Turnstile token strengthens the gate.
-         */
+        /** Climate projections across a portfolio of spots (Scale) */
         post: {
             parameters: {
                 query?: never;
@@ -1859,21 +2071,21 @@ export interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        displayName: string;
-                        /** Format: email */
-                        contactEmail: string;
-                        /**
-                         * @description Must be true — records ToS / Privacy / DPA acceptance.
-                         * @enum {boolean}
-                         */
-                        acceptTerms: true;
-                        turnstileToken?: string;
+                        spots: {
+                            location: components["schemas"]["GeoPoint"];
+                            activity: string;
+                            spotId?: string;
+                        }[];
+                        scenarios: ("SSP1-2.6" | "SSP2-4.5" | "SSP3-7.0" | "SSP5-8.5")[];
+                        horizonDecades?: string[];
+                        /** @enum {string} */
+                        baselineDecade?: "2020s" | "2030s";
                     };
                 };
             };
             responses: {
-                /** @description Accepted — magic-link sent if signup valid */
-                202: {
+                /** @description Per-spot per-decade projection distributions */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1883,8 +2095,8 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Validation error */
-                422: {
+                /** @description Requires Scale plan */
+                402: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1892,8 +2104,8 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description IP rate limit exceeded */
-                429: {
+                /** @description Validation error */
+                422: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1909,32 +2121,761 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/public/catalog-stats": {
+    "/v1/projections/adaptation-report": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Open catalogue coverage stats (no auth)
-         * @description Live coverage numbers for the open activity catalogue (CC BY 4.0). Returns totals across activities · sub-spots · clusters · regions · countries plus a per-activity breakdown with country codes + status (`seeded` ≥10 sub-spots / `partial` 1-9 / `empty` 0). Edge-cached for 5 minutes — new sub-spots ship via PR + release cycle, not at runtime. Same JSON the /catalog landing renders; expose this surface for marketing / partner sites that want to embed live numbers without scraping HTML.
+         * Climate adaptation report for an operator (Scale)
+         * @description Combines projections across a portfolio + qualitative summary of which dimensions are likely to bind (wind shifts, water-temp shifts, etc.). Designed as input for a tourism-board adaptation plan.
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
-            responses: {
-                /** @description Live coverage stats from the @goable-io/profiles-catalog package */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
+            requestBody: {
+                content: {
+                    "application/json": {
+                        spots: ({
+                            location: components["schemas"]["GeoPoint"];
+                            activity: string;
+                            spotId?: string;
+                            subSpotSlug?: string;
+                        } & {
+                            [key: string]: unknown;
+                        })[];
+                        scenarios: ("SSP1-2.6" | "SSP2-4.5" | "SSP3-7.0" | "SSP5-8.5")[];
+                        horizonDecades?: string[];
+                    } & {
+                        [key: string]: unknown;
+                    };
+                };
+            };
+            responses: {
+                /** @description Adaptation report + binding-dimension summary */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Requires Scale plan */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/observations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Submit station observations for data assimilation (Pro+)
+         * @description Push tenant-station observations (wind / wave / temperature / etc.) into the 0-6h assimilation window. The optimal-interpolation blending pulls them into forecast samples for nearby spots, improving short-horizon skill.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        stationId: string;
+                        observations: {
+                            /** Format: date-time */
+                            observedAt: string;
+                            /** @enum {string} */
+                            variable: "wind_speed_kn" | "wind_dir_deg" | "wave_height_m" | "temp_c" | "sea_surface_temp_c" | "pressure_hpa" | "precip_mm";
+                            value: number;
+                            /** @enum {string} */
+                            qualityFlag?: "verified" | "unflagged" | "flagged_low_quality";
+                        }[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Accepted */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Requires Pro+ plan */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Station not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Station inactive */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Validation error / observation in future / variable mismatch */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Observation store not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/observations/stations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List tenant stations */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Array of stations */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Station registry not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /** Register a tenant observation station */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        name: string;
+                        point: components["schemas"]["GeoPoint"];
+                        altitudeM?: number;
+                        variables: ("wind_speed_kn" | "wind_dir_deg" | "wave_height_m" | "temp_c" | "sea_surface_temp_c" | "pressure_hpa" | "precip_mm")[];
+                        /** @enum {string} */
+                        stationClass?: "verified" | "unflagged" | "flagged_low_quality";
+                        updateCadenceMinutes?: number;
+                        notes?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Station created */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Station registry not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/observations/stations/{stationId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Update a station */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    stationId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        name?: string;
+                        point?: components["schemas"]["GeoPoint"];
+                        altitudeM?: number;
+                        variables?: ("wind_speed_kn" | "wind_dir_deg" | "wave_height_m" | "temp_c" | "sea_surface_temp_c" | "pressure_hpa" | "precip_mm")[];
+                        /** @enum {string} */
+                        stationClass?: "verified" | "unflagged" | "flagged_low_quality";
+                        updateCadenceMinutes?: number;
+                        active?: boolean;
+                        notes?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Updated station */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Station not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Station registry not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/v1/observations/stations/{stationId}/recent": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Recent observations for a tenant station
+         * @description Returns up to `limit` most-recent observations submitted for the station (tenant-scoped). Useful for the tenant's own dashboard / debugging feed. Requires the `score:read` scope.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    stationId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Most-recent observations for this station (descending by observedAt) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            observations: {
+                                /** Format: uuid */
+                                id: string;
+                                /** Format: uuid */
+                                stationId: string;
+                                /** Format: date-time */
+                                observedAt: string;
+                                /** @enum {string} */
+                                variable: "wind_speed_kn" | "wind_dir_deg" | "wave_height_m" | "temp_c" | "sea_surface_temp_c" | "pressure_hpa" | "precip_mm";
+                                value: number;
+                                /** @enum {string|null} */
+                                qualityFlag?: "verified" | "unflagged" | "flagged_low_quality" | null;
+                                /** Format: date-time */
+                                ingestedAt: string;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Station not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Observation store not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/public/signup": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Self-service tenant signup (no auth)
+         * @description Public endpoint, IP-rate-limited (3 attempts / 24h / IP). Creates a tenant + sends a magic-link to the contact email. Always returns 202 on success — never reveals whether an email is already registered. Optional Cloudflare Turnstile token strengthens the gate.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        displayName: string;
+                        /** Format: email */
+                        contactEmail: string;
+                        /**
+                         * @description Must be true — records ToS / Privacy / DPA acceptance.
+                         * @enum {boolean}
+                         */
+                        acceptTerms: true;
+                        turnstileToken?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Accepted — magic-link sent if signup valid */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description IP rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/public/sustainability-index": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Public Goable Sustainability Index (no auth, JSON-LD)
+         * @description Public JSON-LD artefact of the Goable Sustainability Index (CC BY 4.0). Session-weighted 0-100 index across zones plus per-zone breakdowns. Governed by k-anonymity (default k≥10) + a 90-day publication lag in the underlying reader — no additional privacy work required for the public surface. Content-Type: application/ld+json. Edge-cached for 5 minutes.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Inclusive start of the reporting period. */
+                    from: string;
+                    /** @description Exclusive end of the reporting period. */
+                    to: string;
+                    /** @description Zone grid cell edge length in km (default: reader-configured). */
+                    zoneKm?: number;
+                    /** @description k-anonymity threshold: zones with fewer than k sessions are suppressed. */
+                    k?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Sustainability Index document (JSON-LD) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/ld+json": {
+                            /** @example https://schema.org */
+                            "@context": string;
+                            /** @enum {string} */
+                            "@type": "GoableSustainabilityIndex";
+                            /** Format: date-time */
+                            generatedAt: string;
+                            period: {
+                                /** Format: date-time */
+                                from: string;
+                                /** Format: date-time */
+                                to: string;
+                            };
+                            methodology: {
+                                indexFormula: string;
+                                weights: {
+                                    carbonNeutralShare: number;
+                                    electrificationShare: number;
+                                };
+                                suppression: string;
+                                notes: string;
+                            };
+                            overall: {
+                                index: number;
+                                totalSessions: number;
+                                carbonNeutralSessions: number;
+                                carbonPositiveSessions: number;
+                                carbonNeutralShare: number;
+                                zonesReleased: number;
+                                zonesSuppressed: number;
+                            };
+                            zones: {
+                                zoneKey: string;
+                                label: string | null;
+                                centroid: components["schemas"]["GeoPoint"] | null;
+                                totalSessions: number;
+                                carbonNeutralShare: number;
+                                electrificationShare: number | null;
+                                seasonalConcentration: number | null;
+                                zoneIndex: number;
+                            }[];
+                            /** @enum {string} */
+                            license: "CC BY 4.0";
+                            attribution: string;
+                        } & {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Sustainability index reader not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/research/verification/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Public Stream F forecast verification export (no auth, JSONL)
+         * @description Streamed newline-delimited JSON (`application/x-ndjson`) — one anonymised (activity × 1km² grid × weekly bucket) skill cell per line, followed by a trailing metadata line. CC BY 4.0. Governance: k≥10 contributor floor + 90-day publication lag + `research_eligible=true` filter enforced in the SQL reader.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    from?: string;
+                    to?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Streamed JSONL — one cell per line + trailing meta line */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/x-ndjson": string;
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Verification reader not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/research/difficulty-atlas/export.jsonl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Public L15 Difficulty Atlas export (no auth, JSONL)
+         * @description Streamed newline-delimited JSON (`application/x-ndjson`) — one anonymised (activity × sub-spot × dimension) difficulty row per line, followed by a trailing metadata line. CC BY 4.0. First openly-available intrinsic-difficulty measurement for outdoor activities. Governance mirrors Stream F: k≥10 contributors + 90-day publication lag.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Streamed JSONL — one atlas row per line + trailing meta line */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/x-ndjson": string;
+                    };
+                };
+                /** @description Difficulty atlas reader not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/public/catalog-stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Open catalogue coverage stats (no auth)
+         * @description Live coverage numbers for the open activity catalogue (CC BY 4.0). Returns totals across activities · sub-spots · clusters · regions · countries plus a per-activity breakdown with country codes + status (`seeded` ≥10 sub-spots / `partial` 1-9 / `empty` 0). Edge-cached for 5 minutes — new sub-spots ship via PR + release cycle, not at runtime. Same JSON the /catalog landing renders; expose this surface for marketing / partner sites that want to embed live numbers without scraping HTML.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Live coverage stats from the @goable-io/profiles-catalog package */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
                         "application/json": {
                             /**
                              * Format: date-time
@@ -1990,6 +2931,239 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/outcomes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Report a standalone activity outcome
+         * @description Submit an observed outcome for an activity session not tied to a specific /v1/score call — the operator-reported behavioural signal behind the calibration + research datasets. For an outcome linked to a specific scored session, use POST /v1/score/{sessionId}/outcome instead. Requires the `outcomes:write` scope (live keys carry it by default; test keys don't).
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: date-time */
+                        occurred_at: string;
+                        activity_slug: string;
+                        /** @enum {string} */
+                        outcome_type: "ran" | "cancelled" | "rescheduled" | "no_show" | "note";
+                        /** @description Optional catalogue sub-spot slug. */
+                        spot_id?: string;
+                        /** @description Optional link back to a scoring_audit_log row. */
+                        audit_log_id?: string;
+                        detail?: {
+                            [key: string]: unknown;
+                        };
+                        /**
+                         * @description Stream G equipment-transition signal.
+                         * @enum {string}
+                         */
+                        equipment_type?: "electric" | "combustion" | "manual";
+                    };
+                };
+            };
+            responses: {
+                /** @description Accepted (queued for the next calibration batch) */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Missing scope: outcomes:write */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/audit/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export the caller's own score + outcome audit history
+         * @description Tenant-scoped export of your own scoring_audit_log activity (one row per /v1/score call, with any linked outcome inline), date-range filtered. The tenant is always the calling API key's tenant — there is no way to request another tenant's data. Outcomes reported via the free-standing POST /v1/outcomes (i.e. not linked to a specific score via audit_log_id) are not included. Offset-paginated; `X-Total-Count` on every response carries the total row count for the window.
+         */
+        get: {
+            parameters: {
+                query: {
+                    from: string;
+                    to: string;
+                    format?: "csv" | "json";
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description CSV (format=csv) or JSON (format=json, default) export of the window. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            rows: {
+                                [key: string]: unknown;
+                            }[];
+                            meta: {
+                                total: number;
+                                limit: number;
+                                offset: number;
+                                window: {
+                                    from?: string;
+                                    to?: string;
+                                };
+                            };
+                        };
+                        "text/csv": string;
+                    };
+                };
+                /** @description Validation error, `to` before `from`, or WINDOW_TOO_LARGE (range exceeds 366 days) */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Audit export is not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/legal/{kind}/current": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fetch the current published legal document (no auth)
+         * @description Public read of the currently-published version of a legal document (Terms of Service, Privacy Policy, DPA, SLA, Acceptable Use, Cookie Policy). Returns the full body + content hash + published timestamp. Used by the signup flow + marketing site to render always-current legal copy without hardcoding it.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Legal document kind. */
+                    kind: "terms_of_service" | "privacy_policy" | "data_processing_agreement" | "sla" | "acceptable_use" | "cookie_policy";
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The current published document of the requested kind */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            document: {
+                                /** Format: uuid */
+                                id: string;
+                                kind: string;
+                                version: string;
+                                title: string;
+                                body: string;
+                                contentHash: string;
+                                status: string;
+                                /** Format: date-time */
+                                createdAt: string;
+                                /** Format: date-time */
+                                publishedAt: string | null;
+                            };
+                        };
+                    };
+                };
+                /** @description Unknown document kind, or no published document */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Legal document store not wired */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -2024,10 +3198,12 @@ export interface components {
             verdict: components["schemas"]["Verdict"];
             confidence: number;
             breakdown: ({
-                dimension?: string;
-                score?: number;
+                name?: string;
+                value?: number;
+                suitability?: number;
                 weight?: number;
                 contribution?: number;
+                hasData?: boolean;
             } & {
                 [key: string]: unknown;
             })[];
@@ -2035,9 +3211,10 @@ export interface components {
                 [key: string]: unknown;
             };
             alerts: ({
+                /** @enum {string} */
+                level?: "info" | "warning" | "critical";
                 code?: string;
-                severity?: string;
-                message?: string;
+                description?: string;
             } & {
                 [key: string]: unknown;
             })[];
@@ -2048,12 +3225,8 @@ export interface components {
             distribution?: {
                 [key: string]: unknown;
             };
-            confidenceDetail?: {
-                [key: string]: unknown;
-            };
-            calibration_provenance?: {
-                [key: string]: unknown;
-            };
+            confidenceDetail?: components["schemas"]["ConfidenceDetailForecast"];
+            calibration_provenance?: components["schemas"]["CalibrationProvenance"] | null;
             assimilation?: {
                 [key: string]: unknown;
             };
@@ -2083,6 +3256,297 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        CalibrationProvenance: {
+            /** @enum {string} */
+            level?: "sub-spot" | "cluster" | "region" | "base";
+            slug?: string;
+            scoring_profile_slug?: string;
+            sub_spot_slug?: string;
+            distance_to_sub_spot_m?: number;
+            /** @enum {integer} */
+            tier?: 1 | 2 | 3;
+            /** @enum {string} */
+            tier_source?: "catalog" | "classifier";
+        };
+        CalibrationProvenanceSummary: {
+            /** @enum {string} */
+            level: "base" | "region" | "cluster" | "sub-spot";
+            n_local: number | null;
+            shrinkage_weight_from_parent: number | null;
+        };
+        DriftFlag: {
+            /** @enum {string} */
+            severity: "watch" | "warning" | "critical";
+            /** Format: date-time */
+            since_timestamp: string;
+        };
+        ConfidenceDetail: components["schemas"]["ConfidenceDetailForecast"] | components["schemas"]["ConfidenceDetailHistorical"] | components["schemas"]["ConfidenceDetailClimate"];
+        ConfidenceDetailForecast: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            mode: "forecast";
+            forecast_skill: number;
+            provider_agreement: number;
+            profile_maturity: number;
+            hierarchical_calibration: number;
+            calibration_provenance?: components["schemas"]["CalibrationProvenanceSummary"];
+            skill_calibration?: {
+                applied: boolean;
+                n_train: number;
+                cohort_hash: string;
+                scalar: number;
+            };
+            drift_flag?: components["schemas"]["DriftFlag"];
+        } & {
+            [key: string]: unknown;
+        };
+        ConfidenceDetailHistorical: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            mode: "historical";
+            sample_size_confidence: number;
+            base_climatology_quality: number;
+            calibration_confidence: number;
+            hierarchical_calibration: number;
+            calibration_provenance?: components["schemas"]["CalibrationProvenanceSummary"];
+            drift_flag?: components["schemas"]["DriftFlag"];
+        } & {
+            [key: string]: unknown;
+        };
+        ConfidenceDetailClimate: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            mode: "climate";
+            model_spread: number;
+            bias_correction_residual: number;
+            scenario_uncertainty: number;
+            horizon_uncertainty: number;
+            hierarchical_calibration: number;
+            calibration_provenance?: components["schemas"]["CalibrationProvenanceSummary"];
+            drift_flag?: components["schemas"]["DriftFlag"];
+        } & {
+            [key: string]: unknown;
+        };
+        SerialisedPolicy: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            tenantId: string;
+            /** Format: uuid */
+            quoteId: string;
+            /** @enum {string} */
+            status: "bound" | "triggered" | "settled" | "expired";
+            /** @description Null for mixed-currency portfolios; the breakdown lives on the underlying quote. */
+            payoutAmount?: number | null;
+            payoutCurrency?: ("EUR" | "USD" | "GBP" | "CHF") | null;
+            premiumPaid?: number | null;
+            /** @enum {string} */
+            premiumCollection: "external" | "stripe" | "invoice_due";
+            coverageWindow: {
+                monthFrom: number;
+                dayFrom: number;
+                monthTo: number;
+                dayTo: number;
+            };
+            coverageYear: number;
+            /** @description Frozen at bind time — same shape as the quote's normalised trigger. */
+            trigger: {
+                [key: string]: unknown;
+            };
+            /** @description Frozen snapshot of the per-spot profile + payout terms — decouples the policy from later catalog changes. */
+            policyTerms: {
+                [key: string]: unknown;
+            };
+            /** Format: date-time */
+            boundAt: string;
+            /** Format: date-time */
+            triggeredAt: string | null;
+            /** Format: date-time */
+            settledAt: string | null;
+            /** Format: date-time */
+            expiredAt: string | null;
+            settlementReference: string | null;
+        };
+        SerialisedPayoutEvent: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            policyId: string;
+            spotIndex: number;
+            /** Format: date-time */
+            eventStartAt: string;
+            /** Format: date-time */
+            eventEndAt: string;
+            hoursFired: number;
+            payoutAmount: number;
+            /** @enum {string} */
+            payoutCurrency: "EUR" | "USD" | "GBP" | "CHF";
+            /** Format: date-time */
+            detectedAt: string;
+            /** @enum {string} */
+            evaluationSource: "manual" | "scheduled";
+        };
+        UnderwritingQuoteResponse: {
+            policy: {
+                coverageWindow: {
+                    monthFrom: number;
+                    dayFrom: number;
+                    monthTo: number;
+                    dayTo: number;
+                };
+                /** @description Normalised trigger echoed back with defaulted consecutiveHours/cooldownHours. */
+                trigger: {
+                    [key: string]: unknown;
+                };
+                historicalYearsRange: {
+                    from: number;
+                    to: number;
+                };
+                spot?: {
+                    resolvedProfileSlug: string;
+                    point: components["schemas"]["GeoPoint"];
+                    spotId?: string;
+                    payout: {
+                        amount: number;
+                        /** @enum {string} */
+                        currency: "EUR" | "USD" | "GBP" | "CHF";
+                    };
+                    /**
+                     * @description Sub-spot tier (1/2/3) applied to the tier risk multiplier; null when no sub-spot resolved.
+                     * @enum {integer|null}
+                     */
+                    tier?: 1 | 2 | 3 | null;
+                    /**
+                     * @description Provenance of the tier: 'catalog' from profile YAML, 'classifier' from L11 confidence=1.0 override, null when no tier applied.
+                     * @enum {string|null}
+                     */
+                    tierSource?: "catalog" | "classifier" | null;
+                };
+                portfolio?: {
+                    resolvedProfileSlug: string;
+                    point: components["schemas"]["GeoPoint"];
+                    spotId?: string;
+                    payout: {
+                        amount: number;
+                        /** @enum {string} */
+                        currency: "EUR" | "USD" | "GBP" | "CHF";
+                    };
+                    /**
+                     * @description Sub-spot tier (1/2/3) applied to the tier risk multiplier; null when no sub-spot resolved.
+                     * @enum {integer|null}
+                     */
+                    tier?: 1 | 2 | 3 | null;
+                    /**
+                     * @description Provenance of the tier: 'catalog' from profile YAML, 'classifier' from L11 confidence=1.0 override, null when no tier applied.
+                     * @enum {string|null}
+                     */
+                    tierSource?: "catalog" | "classifier" | null;
+                }[];
+            } & {
+                [key: string]: unknown;
+            };
+            expectedPayouts: {
+                byCurrency: {
+                    EUR?: {
+                        mean: number;
+                        p10: number;
+                        p50: number;
+                        p90: number;
+                        perYear: number[];
+                        varianceStability: number;
+                    };
+                    USD?: {
+                        mean: number;
+                        p10: number;
+                        p50: number;
+                        p90: number;
+                        perYear: number[];
+                        varianceStability: number;
+                    };
+                    GBP?: {
+                        mean: number;
+                        p10: number;
+                        p50: number;
+                        p90: number;
+                        perYear: number[];
+                        varianceStability: number;
+                    };
+                    CHF?: {
+                        mean: number;
+                        p10: number;
+                        p50: number;
+                        p90: number;
+                        perYear: number[];
+                        varianceStability: number;
+                    };
+                };
+            };
+            expectedPremium: {
+                byCurrency: {
+                    EUR?: {
+                        fair: number;
+                        loaded: number;
+                        /** @description Weighted-average tier risk multiplier applied across spots in this currency (1.0 when no sub-spot). */
+                        tierMultiplierWeightedAvg: number;
+                    };
+                    USD?: {
+                        fair: number;
+                        loaded: number;
+                        /** @description Weighted-average tier risk multiplier applied across spots in this currency (1.0 when no sub-spot). */
+                        tierMultiplierWeightedAvg: number;
+                    };
+                    GBP?: {
+                        fair: number;
+                        loaded: number;
+                        /** @description Weighted-average tier risk multiplier applied across spots in this currency (1.0 when no sub-spot). */
+                        tierMultiplierWeightedAvg: number;
+                    };
+                    CHF?: {
+                        fair: number;
+                        loaded: number;
+                        /** @description Weighted-average tier risk multiplier applied across spots in this currency (1.0 when no sub-spot). */
+                        tierMultiplierWeightedAvg: number;
+                    };
+                };
+                loadingFactor: number;
+            };
+            modelConfidence: number;
+            /** @enum {string} */
+            advisoryLevel: "high_confidence" | "moderate_confidence" | "low_confidence";
+            issuable: boolean;
+            notes: string[];
+            /** @description HistoricalScoreDistribution — object for single spot, array for portfolio. */
+            underlying: {
+                [key: string]: unknown;
+            } | {
+                [key: string]: unknown;
+            }[];
+            /**
+             * Format: uuid
+             * @description Present when the policy store is wired — pass to /v1/underwriting/policy/bind to bind this quote.
+             */
+            quoteId?: string;
+            /**
+             * Format: date-time
+             * @description ISO timestamp after which the quote can no longer be bound.
+             */
+            expiresAt?: string;
+            /**
+             * Format: uuid
+             * @description Present on GET after the quote has been bound — the resulting policy id.
+             */
+            boundPolicyId?: string;
+        } & {
+            [key: string]: unknown;
+        };
+        /** @enum {string} */
+        WebhookEvent: "outcome.created" | "drift.fired" | "drift.resolved" | "calibration.completed" | "billing.subscription_updated" | "recommendation.completed" | "underwriting.policy.bound" | "underwriting.policy.triggered" | "underwriting.policy.settled";
     };
     responses: never;
     parameters: never;