@grapity/grapity 0.4.1 → 0.5.0

package/dist/core/index.d.ts

@@ -1141,40 +1141,19 @@ interface components {
     };
     responses: never;
     parameters: {
-        /**
-         * @description URL-friendly spec identifier
-         * @example payments-api
-         */
+        /** @description URL-friendly spec identifier */
         specName: string;
-        /**
-         * @description Semantic version
-         * @example 1.2.0
-         */
+        /** @description Semantic version */
         semver: string;
-        /**
-         * @description URL-friendly gateway config identifier
-         * @example payments-api-gateway
-         */
+        /** @description URL-friendly gateway config identifier */
         gatewayConfigName: string;
-        /**
-         * @description Gateway config version UUID
-         * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
-         */
+        /** @description Gateway config version UUID */
         versionId: string;
-        /**
-         * @description Gateway provider (e.g., kong)
-         * @example kong
-         */
+        /** @description Gateway provider (e.g., kong) */
         provider: string;
-        /**
-         * @description Deployment environment (e.g., staging, production)
-         * @example staging
-         */
+        /** @description Deployment environment (e.g., staging, production) */
         environment: string;
-        /**
-         * @description Gateway log entry UUID
-         * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
-         */
+        /** @description Gateway log entry UUID */
         logId: string;
     };
     requestBodies: never;
@@ -1197,13 +1176,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "status": "ok",
-                     *       "version": "0.2.0",
-                     *       "uptime": 3600.42
-                     *     }
-                     */
                     "application/json": components["schemas"]["HealthResponse"];
                 };
             };
@@ -1213,13 +1185,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1229,13 +1194,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1245,13 +1203,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1264,10 +1215,7 @@ interface operations {
                 type?: components["schemas"]["SpecType"];
                 /** @description Filter by owner */
                 owner?: string;
-                /**
-                 * @description Comma-separated list of tags to filter by
-                 * @example payments,public
-                 */
+                /** @description Comma-separated list of tags to filter by */
                 tags?: string;
             };
             header?: never;
@@ -1282,58 +1230,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": [
-                     *         {
-                     *           "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *           "name": "payments-api",
-                     *           "type": "openapi",
-                     *           "description": "Payments service API",
-                     *           "owner": "platform-team",
-                     *           "sourceRepo": "https://github.com/acme/payments-service",
-                     *           "tags": [
-                     *             "payments",
-                     *             "public"
-                     *           ],
-                     *           "createdAt": "2026-04-25T10:30:00.000Z",
-                     *           "updatedAt": "2026-06-07T14:00:00.000Z",
-                     *           "latestVersion": {
-                     *             "id": "ver-uuid-1",
-                     *             "specId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *             "semver": "1.2.0",
-                     *             "checksum": "sha256-abc123",
-                     *             "gitRef": "a1b2c3d4",
-                     *             "pushedBy": "github-actions[bot]",
-                     *             "previousVersion": "1.1.0",
-                     *             "isPrerelease": false,
-                     *             "createdAt": "2026-06-07T14:00:00.000Z"
-                     *           }
-                     *         },
-                     *         {
-                     *           "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
-                     *           "name": "notifications-api",
-                     *           "type": "asyncapi",
-                     *           "description": "Event-driven notifications",
-                     *           "owner": "messaging-team",
-                     *           "tags": [
-                     *             "events",
-                     *             "internal"
-                     *           ],
-                     *           "createdAt": "2026-05-01T09:00:00.000Z",
-                     *           "updatedAt": "2026-05-15T11:30:00.000Z",
-                     *           "latestVersion": {
-                     *             "id": "ver-uuid-2",
-                     *             "specId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
-                     *             "semver": "0.3.0",
-                     *             "checksum": "sha256-def456",
-                     *             "isPrerelease": true,
-                     *             "createdAt": "2026-05-15T11:30:00.000Z"
-                     *           }
-                     *         }
-                     *       ]
-                     *     }
-                     */
                     "application/json": components["schemas"]["ListSpecsResponse"];
                 };
             };
@@ -1343,13 +1239,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1359,13 +1248,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1375,13 +1257,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1396,24 +1271,6 @@ interface operations {
         };
         requestBody: {
             content: {
-                /**
-                 * @example {
-                 *       "content": "openapi: 3.1.0\ninfo:\n  title: Payments API\n  version: 1.0.0\npaths:\n  /payments:\n    get:\n      operationId: listPayments\n      responses:\n        '200':\n          description: OK\n",
-                 *       "name": "payments-api",
-                 *       "type": "openapi",
-                 *       "description": "Payments service API",
-                 *       "owner": "platform-team",
-                 *       "sourceRepo": "https://github.com/acme/payments-service",
-                 *       "tags": [
-                 *         "payments",
-                 *         "public"
-                 *       ],
-                 *       "gitRef": "a1b2c3d4",
-                 *       "pushedBy": "github-actions[bot]",
-                 *       "prerelease": false,
-                 *       "force": false
-                 *     }
-                 */
                 "application/json": components["schemas"]["PushSpecRequest"];
             };
         };
@@ -1424,66 +1281,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "isNewSpec": false,
-                     *         "spec": {
-                     *           "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *           "name": "payments-api",
-                     *           "type": "openapi",
-                     *           "description": "Payments service API",
-                     *           "owner": "platform-team",
-                     *           "sourceRepo": "https://github.com/acme/payments-service",
-                     *           "tags": [
-                     *             "payments",
-                     *             "public"
-                     *           ],
-                     *           "createdAt": "2026-04-25T10:30:00.000Z",
-                     *           "updatedAt": "2026-06-07T14:00:00.000Z"
-                     *         },
-                     *         "version": {
-                     *           "id": "ver-uuid-3",
-                     *           "specId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *           "semver": "1.2.0",
-                     *           "checksum": "sha256-ghi789",
-                     *           "gitRef": "a1b2c3d4",
-                     *           "pushedBy": "github-actions[bot]",
-                     *           "previousVersion": "1.1.0",
-                     *           "isPrerelease": false,
-                     *           "createdAt": "2026-06-07T14:00:00.000Z",
-                     *           "compatibility": {
-                     *             "previousVersion": "1.1.0",
-                     *             "classification": "minor",
-                     *             "suggestedVersion": "1.2.0",
-                     *             "breakingChanges": [],
-                     *             "safeChanges": [
-                     *               {
-                     *                 "id": "chg-1",
-                     *                 "rule": "endpoint-added",
-                     *                 "description": "Endpoint GET /payments/{id}/refunds added",
-                     *                 "path": "/payments/{id}/refunds/GET"
-                     *               }
-                     *             ]
-                     *           }
-                     *         },
-                     *         "compatReport": {
-                     *           "previousVersion": "1.1.0",
-                     *           "classification": "minor",
-                     *           "suggestedVersion": "1.2.0",
-                     *           "breakingChanges": [],
-                     *           "safeChanges": [
-                     *             {
-                     *               "id": "chg-1",
-                     *               "rule": "endpoint-added",
-                     *               "description": "Endpoint GET /payments/{id}/refunds added",
-                     *               "path": "/payments/{id}/refunds/GET"
-                     *             }
-                     *           ]
-                     *         }
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["PushSpecResponse"];
                 };
             };
@@ -1493,13 +1290,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "bad_request",
-                     *       "message": "Missing required field: content",
-                     *       "statusCode": 400
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1509,13 +1299,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1525,13 +1308,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1541,27 +1317,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "breaking_change",
-                     *       "message": "Breaking changes detected. Use force: true with a reason to override.",
-                     *       "statusCode": 409,
-                     *       "compatReport": {
-                     *         "previousVersion": "1.1.0",
-                     *         "classification": "major",
-                     *         "suggestedVersion": "2.0.0",
-                     *         "breakingChanges": [
-                     *           {
-                     *             "id": "chg-2",
-                     *             "rule": "response-property-removed",
-                     *             "description": "Response property 'userId' was removed from GET /users/{id}",
-                     *             "path": "/users/{id}/GET/response/200/userId"
-                     *           }
-                     *         ],
-                     *         "safeChanges": []
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["BreakingChangeError"];
                 };
             };
@@ -1571,13 +1326,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "prerelease_constraint",
-                     *       "message": "Cannot push pre-release version. payments-api@1.1.0 is already a release version.",
-                     *       "statusCode": 422
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1587,13 +1335,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1604,10 +1345,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
             };
             cookie?: never;
@@ -1620,37 +1358,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "spec": {
-                     *           "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *           "name": "payments-api",
-                     *           "type": "openapi",
-                     *           "description": "Payments service API",
-                     *           "owner": "platform-team",
-                     *           "sourceRepo": "https://github.com/acme/payments-service",
-                     *           "tags": [
-                     *             "payments",
-                     *             "public"
-                     *           ],
-                     *           "createdAt": "2026-04-25T10:30:00.000Z",
-                     *           "updatedAt": "2026-06-07T14:00:00.000Z"
-                     *         },
-                     *         "latestVersion": {
-                     *           "id": "ver-uuid-1",
-                     *           "specId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *           "semver": "1.2.0",
-                     *           "checksum": "sha256-abc123",
-                     *           "gitRef": "a1b2c3d4",
-                     *           "pushedBy": "github-actions[bot]",
-                     *           "previousVersion": "1.1.0",
-                     *           "isPrerelease": false,
-                     *           "createdAt": "2026-06-07T14:00:00.000Z"
-                     *         }
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["GetSpecResponse"];
                 };
             };
@@ -1660,13 +1367,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1676,13 +1376,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1692,13 +1385,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Spec \"payments-api\" not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1708,13 +1394,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1725,10 +1404,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
             };
             cookie?: never;
@@ -1748,13 +1424,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1764,13 +1433,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1780,13 +1442,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Spec \"payments-api\" not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1796,13 +1451,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1813,21 +1461,13 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                /**
-                 * @example {
-                 *       "content": "openapi: 3.1.0\ninfo:\n  title: Payments API\n  version: 1.0.0\npaths:\n  /payments:\n    get:\n      operationId: listPayments\n      responses:\n        '200':\n          description: OK\n"
-                 *     }
-                 */
                 "application/json": components["schemas"]["ValidateSpecRequest"];
             };
         };
@@ -1838,28 +1478,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "valid": true,
-                     *         "compatReport": {
-                     *           "previousVersion": "1.1.0",
-                     *           "classification": "minor",
-                     *           "suggestedVersion": "1.2.0",
-                     *           "breakingChanges": [],
-                     *           "safeChanges": [
-                     *             {
-                     *               "id": "chg-1",
-                     *               "rule": "endpoint-added",
-                     *               "description": "Endpoint GET /payments/{id}/refunds added",
-                     *               "path": "/payments/{id}/refunds/GET"
-                     *             }
-                     *           ]
-                     *         },
-                     *         "warnings": []
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["ValidateSpecResponse"];
                 };
             };
@@ -1869,13 +1487,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "bad_request",
-                     *       "message": "Request body must be valid JSON",
-                     *       "statusCode": 400
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1885,13 +1496,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1901,13 +1505,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1917,13 +1514,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Spec \"payments-api\" not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1933,13 +1523,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -1955,10 +1538,7 @@ interface operations {
             };
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
             };
             cookie?: never;
@@ -1971,40 +1551,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": [
-                     *         {
-                     *           "id": "ver-uuid-1",
-                     *           "specId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *           "semver": "1.2.0",
-                     *           "checksum": "sha256-abc123",
-                     *           "gitRef": "a1b2c3d4",
-                     *           "pushedBy": "github-actions[bot]",
-                     *           "previousVersion": "1.1.0",
-                     *           "isPrerelease": false,
-                     *           "createdAt": "2026-06-07T14:00:00.000Z"
-                     *         },
-                     *         {
-                     *           "id": "ver-uuid-0",
-                     *           "specId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *           "semver": "1.1.0",
-                     *           "checksum": "sha256-old456",
-                     *           "gitRef": "b2c3d4e5",
-                     *           "pushedBy": "github-actions[bot]",
-                     *           "previousVersion": "1.0.0",
-                     *           "isPrerelease": false,
-                     *           "createdAt": "2026-05-01T09:00:00.000Z"
-                     *         }
-                     *       ],
-                     *       "pagination": {
-                     *         "hasMore": false,
-                     *         "limit": 10,
-                     *         "offset": 0,
-                     *         "total": 2
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["VersionsPage"];
                 };
             };
@@ -2014,13 +1560,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2030,13 +1569,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2046,13 +1578,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Spec \"payments-api\" not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2062,13 +1587,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2079,15 +1597,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
-                /**
-                 * @description Semantic version
-                 * @example 1.2.0
-                 */
+                /** @description Semantic version */
                 semver: components["parameters"]["semver"];
             };
             cookie?: never;
@@ -2100,21 +1612,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "id": "ver-uuid-1",
-                     *         "specId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-                     *         "semver": "1.2.0",
-                     *         "checksum": "sha256-abc123",
-                     *         "gitRef": "a1b2c3d4",
-                     *         "pushedBy": "github-actions[bot]",
-                     *         "previousVersion": "1.1.0",
-                     *         "isPrerelease": false,
-                     *         "createdAt": "2026-06-07T14:00:00.000Z"
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["GetVersionResponse"];
                 };
             };
@@ -2124,13 +1621,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2140,13 +1630,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2156,13 +1639,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Version 9.9.9 not found for spec \"payments-api\"",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2172,13 +1648,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2189,10 +1658,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
             };
             cookie?: never;
@@ -2215,13 +1681,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2231,13 +1690,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2247,13 +1699,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Spec \"payments-api\" not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2263,13 +1708,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2280,10 +1718,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
             };
             cookie?: never;
@@ -2306,13 +1741,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2322,13 +1750,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2338,13 +1759,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Spec \"payments-api\" not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2354,13 +1768,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2371,15 +1778,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
-                /**
-                 * @description Semantic version
-                 * @example 1.2.0
-                 */
+                /** @description Semantic version */
                 semver: components["parameters"]["semver"];
             };
             cookie?: never;
@@ -2402,13 +1803,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2418,13 +1812,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2434,13 +1821,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Version 9.9.9 not found for spec \"payments-api\"",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2450,13 +1830,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2467,15 +1840,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
-                /**
-                 * @description Semantic version
-                 * @example 1.2.0
-                 */
+                /** @description Semantic version */
                 semver: components["parameters"]["semver"];
             };
             cookie?: never;
@@ -2498,13 +1865,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2514,13 +1874,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2530,13 +1883,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Version 9.9.9 not found for spec \"payments-api\"",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2546,13 +1892,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2563,15 +1902,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
-                /**
-                 * @description Semantic version
-                 * @example 1.2.0
-                 */
+                /** @description Semantic version */
                 semver: components["parameters"]["semver"];
             };
             cookie?: never;
@@ -2584,24 +1917,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "previousVersion": "1.1.0",
-                     *         "classification": "minor",
-                     *         "suggestedVersion": "1.2.0",
-                     *         "breakingChanges": [],
-                     *         "safeChanges": [
-                     *           {
-                     *             "id": "chg-1",
-                     *             "rule": "endpoint-added",
-                     *             "description": "Endpoint GET /payments/{id}/refunds added",
-                     *             "path": "/payments/{id}/refunds/GET"
-                     *           }
-                     *         ]
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["GetCompatReportResponse"];
                 };
             };
@@ -2611,13 +1926,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2627,13 +1935,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2643,13 +1944,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Compat report not found for payments-api@1.0.0",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2659,13 +1953,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2674,23 +1961,14 @@ interface operations {
     compareVersions: {
         parameters: {
             query: {
-                /**
-                 * @description Starting version (inclusive). If newer than `to`, the order is normalized.
-                 * @example 1.0.0
-                 */
+                /** @description Starting version (inclusive). If newer than `to`, the order is normalized. */
                 from: string;
-                /**
-                 * @description Ending version (inclusive). If older than `from`, the order is normalized.
-                 * @example 1.3.0
-                 */
+                /** @description Ending version (inclusive). If older than `from`, the order is normalized. */
                 to: string;
             };
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly spec identifier
-                 * @example payments-api
-                 */
+                /** @description URL-friendly spec identifier */
                 name: components["parameters"]["specName"];
             };
             cookie?: never;
@@ -2703,53 +1981,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "from": "1.0.0",
-                     *         "to": "1.3.0",
-                     *         "steps": [
-                     *           {
-                     *             "version": "1.1.0",
-                     *             "previousVersion": "1.0.0",
-                     *             "classification": "minor",
-                     *             "breakingChanges": [],
-                     *             "safeChanges": [
-                     *               {
-                     *                 "id": "chg-1",
-                     *                 "rule": "endpoint-added",
-                     *                 "description": "Endpoint GET /payments/{id}/refunds added",
-                     *                 "path": "/payments/{id}/refunds/GET",
-                     *                 "category": "structural"
-                     *               }
-                     *             ]
-                     *           },
-                     *           {
-                     *             "version": "1.2.0",
-                     *             "previousVersion": "1.1.0",
-                     *             "classification": "patch",
-                     *             "breakingChanges": [],
-                     *             "safeChanges": []
-                     *           },
-                     *           {
-                     *             "version": "1.3.0",
-                     *             "previousVersion": "1.2.0",
-                     *             "classification": "major",
-                     *             "breakingChanges": [
-                     *               {
-                     *                 "id": "chg-2",
-                     *                 "rule": "response-property-removed",
-                     *                 "description": "Response property 'userId' was removed from GET /users/{id}",
-                     *                 "path": "/users/{id}/GET/response/200/userId",
-                     *                 "category": "structural"
-                     *               }
-                     *             ],
-                     *             "safeChanges": []
-                     *           }
-                     *         ]
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["CompareVersionsResponse"];
                 };
             };
@@ -2759,13 +1990,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2775,13 +1999,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2791,13 +2008,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Version 1.3.0 not found for spec \"payments-api\"",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2807,13 +2017,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2834,21 +2037,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": [
-                     *         {
-                     *           "id": "cfg-uuid-1",
-                     *           "name": "payments-api-gateway",
-                     *           "provider": "kong",
-                     *           "specName": "payments-api",
-                     *           "specSemver": "1.2.0",
-                     *           "createdAt": "2026-04-25T10:30:00.000Z",
-                     *           "updatedAt": "2026-06-07T14:00:00.000Z"
-                     *         }
-                     *       ]
-                     *     }
-                     */
                     "application/json": components["schemas"]["ListGatewayConfigsResponse"];
                 };
             };
@@ -2858,13 +2046,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2874,13 +2055,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2890,13 +2064,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -2911,64 +2078,6 @@ interface operations {
         };
         requestBody: {
             content: {
-                /**
-                 * @example {
-                 *       "name": "payments-api-gateway",
-                 *       "provider": "kong",
-                 *       "specName": "payments-api",
-                 *       "specSemver": "1.2.0",
-                 *       "routes": [
-                 *         {
-                 *           "path": "/payments",
-                 *           "methods": [
-                 *             "GET",
-                 *             "POST"
-                 *           ]
-                 *         },
-                 *         {
-                 *           "path": "/payments/{id}",
-                 *           "methods": [
-                 *             "GET",
-                 *             "PUT",
-                 *             "DELETE"
-                 *           ]
-                 *         }
-                 *       ],
-                 *       "environments": {
-                 *         "staging": {
-                 *           "kongAddr": "http://kong-staging:8001",
-                 *           "upstream": "http://payments-staging:8080",
-                 *           "plugins": [
-                 *             {
-                 *               "name": "rate-limiting",
-                 *               "config": {
-                 *                 "minute": 1000
-                 *               },
-                 *               "order": 1
-                 *             },
-                 *             {
-                 *               "name": "jwt",
-                 *               "config": {
-                 *                 "issuer": "https://auth.example.com"
-                 *               },
-                 *               "order": 2
-                 *             }
-                 *           ]
-                 *         }
-                 *       },
-                 *       "callerIdentification": {
-                 *         "strategy": "first-match",
-                 *         "rules": [
-                 *           {
-                 *             "source": "header:x-consumer-id",
-                 *             "confidence": "high"
-                 *           }
-                 *         ]
-                 *       },
-                 *       "content": "apiVersion: v1\nkind: GatewayConfig",
-                 *       "pushedBy": "github-actions[bot]"
-                 *     }
-                 */
                 "application/json": components["schemas"]["PushGatewayConfigRequest"];
             };
         };
@@ -2979,63 +2088,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "config": {
-                     *           "id": "cfg-uuid-1",
-                     *           "name": "payments-api-gateway",
-                     *           "provider": "kong",
-                     *           "specName": "payments-api",
-                     *           "specSemver": "1.2.0",
-                     *           "createdAt": "2026-04-25T10:30:00.000Z",
-                     *           "updatedAt": "2026-06-07T14:00:00.000Z"
-                     *         },
-                     *         "version": {
-                     *           "id": "ver-uuid-1",
-                     *           "gatewayConfigId": "cfg-uuid-1",
-                     *           "routes": [
-                     *             {
-                     *               "path": "/payments",
-                     *               "methods": [
-                     *                 "GET",
-                     *                 "POST"
-                     *               ]
-                     *             }
-                     *           ],
-                     *           "environments": [
-                     *             {
-                     *               "name": "staging",
-                     *               "kongAddr": "http://kong-staging:8001",
-                     *               "upstream": "http://payments-staging:8080",
-                     *               "plugins": [
-                     *                 {
-                     *                   "name": "rate-limiting",
-                     *                   "config": {
-                     *                     "minute": 1000
-                     *                   },
-                     *                   "order": 1
-                     *                 }
-                     *               ]
-                     *             }
-                     *           ],
-                     *           "callerIdentification": {
-                     *             "strategy": "first-match",
-                     *             "rules": [
-                     *               {
-                     *                 "source": "header:x-consumer-id",
-                     *                 "confidence": "high"
-                     *               }
-                     *             ]
-                     *           },
-                     *           "content": "apiVersion: v1\nkind: GatewayConfig",
-                     *           "checksum": "sha256-abc123",
-                     *           "pushedBy": "github-actions[bot]",
-                     *           "createdAt": "2026-06-07T14:00:00.000Z"
-                     *         }
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["PushGatewayConfigResponse"];
                 };
             };
@@ -3045,13 +2097,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "bad_request",
-                     *       "message": "Missing required field: name",
-                     *       "statusCode": 400
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3061,13 +2106,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3077,13 +2115,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3093,13 +2124,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "name_exists",
-                     *       "message": "Gateway config name 'payments-api-gateway' already exists with a different spec",
-                     *       "statusCode": 409
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3109,13 +2133,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unsupported_provider",
-                     *       "message": "Unsupported provider 'nginx'",
-                     *       "statusCode": 422
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3125,13 +2142,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3142,10 +2152,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly gateway config identifier
-                 * @example payments-api-gateway
-                 */
+                /** @description URL-friendly gateway config identifier */
                 name: components["parameters"]["gatewayConfigName"];
             };
             cookie?: never;
@@ -3158,19 +2165,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "id": "cfg-uuid-1",
-                     *         "name": "payments-api-gateway",
-                     *         "provider": "kong",
-                     *         "specName": "payments-api",
-                     *         "specSemver": "1.2.0",
-                     *         "createdAt": "2026-04-25T10:30:00.000Z",
-                     *         "updatedAt": "2026-06-07T14:00:00.000Z"
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["GetGatewayConfigResponse"];
                 };
             };
@@ -3180,13 +2174,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3196,13 +2183,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3212,13 +2192,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Gateway config \"payments-api-gateway\" not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3228,13 +2201,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3245,10 +2211,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly gateway config identifier
-                 * @example payments-api-gateway
-                 */
+                /** @description URL-friendly gateway config identifier */
                 name: components["parameters"]["gatewayConfigName"];
             };
             cookie?: never;
@@ -3261,53 +2224,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": [
-                     *         {
-                     *           "id": "ver-uuid-1",
-                     *           "gatewayConfigId": "cfg-uuid-1",
-                     *           "routes": [
-                     *             {
-                     *               "path": "/payments",
-                     *               "methods": [
-                     *                 "GET",
-                     *                 "POST"
-                     *               ]
-                     *             }
-                     *           ],
-                     *           "environments": [
-                     *             {
-                     *               "name": "staging",
-                     *               "kongAddr": "http://kong-staging:8001",
-                     *               "upstream": "http://payments-staging:8080",
-                     *               "plugins": [
-                     *                 {
-                     *                   "name": "rate-limiting",
-                     *                   "config": {
-                     *                     "minute": 1000
-                     *                   },
-                     *                   "order": 1
-                     *                 }
-                     *               ]
-                     *             }
-                     *           ],
-                     *           "callerIdentification": {
-                     *             "strategy": "first-match",
-                     *             "rules": [
-                     *               {
-                     *                 "source": "header:x-consumer-id",
-                     *                 "confidence": "high"
-                     *               }
-                     *             ]
-                     *           },
-                     *           "checksum": "sha256-abc123",
-                     *           "pushedBy": "github-actions[bot]",
-                     *           "createdAt": "2026-06-07T14:00:00.000Z"
-                     *         }
-                     *       ]
-                     *     }
-                     */
                     "application/json": components["schemas"]["ListGatewayConfigVersionsResponse"];
                 };
             };
@@ -3317,13 +2233,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3333,13 +2242,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3349,13 +2251,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Gateway config \"payments-api-gateway\" not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3365,13 +2260,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3382,15 +2270,9 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description URL-friendly gateway config identifier
-                 * @example payments-api-gateway
-                 */
+                /** @description URL-friendly gateway config identifier */
                 name: components["parameters"]["gatewayConfigName"];
-                /**
-                 * @description Gateway config version UUID
-                 * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
-                 */
+                /** @description Gateway config version UUID */
                 versionId: components["parameters"]["versionId"];
             };
             cookie?: never;
@@ -3403,52 +2285,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "id": "ver-uuid-1",
-                     *         "gatewayConfigId": "cfg-uuid-1",
-                     *         "routes": [
-                     *           {
-                     *             "path": "/payments",
-                     *             "methods": [
-                     *               "GET",
-                     *               "POST"
-                     *             ]
-                     *           }
-                     *         ],
-                     *         "environments": [
-                     *           {
-                     *             "name": "staging",
-                     *             "kongAddr": "http://kong-staging:8001",
-                     *             "upstream": "http://payments-staging:8080",
-                     *             "plugins": [
-                     *               {
-                     *                 "name": "rate-limiting",
-                     *                 "config": {
-                     *                   "minute": 1000
-                     *                 },
-                     *                 "order": 1
-                     *               }
-                     *             ]
-                     *           }
-                     *         ],
-                     *         "callerIdentification": {
-                     *           "strategy": "first-match",
-                     *           "rules": [
-                     *             {
-                     *               "source": "header:x-consumer-id",
-                     *               "confidence": "high"
-                     *             }
-                     *           ]
-                     *         },
-                     *         "content": "apiVersion: v1\nkind: GatewayConfig",
-                     *         "checksum": "sha256-abc123",
-                     *         "pushedBy": "github-actions[bot]",
-                     *         "createdAt": "2026-06-07T14:00:00.000Z"
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["GetGatewayConfigVersionResponse"];
                 };
             };
@@ -3458,13 +2294,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3474,13 +2303,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3490,13 +2312,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Version ver-uuid-99 not found for gateway config \"payments-api-gateway\"",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3506,13 +2321,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3523,41 +2331,15 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description Gateway provider (e.g., kong)
-                 * @example kong
-                 */
+                /** @description Gateway provider (e.g., kong) */
                 provider: components["parameters"]["provider"];
-                /**
-                 * @description Deployment environment (e.g., staging, production)
-                 * @example staging
-                 */
+                /** @description Deployment environment (e.g., staging, production) */
                 environment: components["parameters"]["environment"];
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                /**
-                 * @example {
-                 *       "service": {
-                 *         "name": "payments-api-gateway"
-                 *       },
-                 *       "request": {
-                 *         "method": "GET",
-                 *         "uri": "/payments",
-                 *         "headers": {
-                 *           "x-consumer-id": "consumer-123"
-                 *         }
-                 *       },
-                 *       "response": {
-                 *         "status": 200
-                 *       },
-                 *       "latencies": {
-                 *         "request": 42
-                 *       }
-                 *     }
-                 */
                 "application/json": Record<string, never>;
             };
         };
@@ -3568,11 +2350,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "status": "ok"
-                     *     }
-                     */
                     "application/json": {
                         /** @example ok */
                         status?: string;
@@ -3585,13 +2362,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "bad_request",
-                     *       "message": "Missing service.name in gateway log payload",
-                     *       "statusCode": 400
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3601,13 +2371,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3617,13 +2380,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3633,13 +2389,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3679,33 +2428,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": [
-                     *         {
-                     *           "id": "log-uuid-1",
-                     *           "provider": "kong",
-                     *           "gatewayConfigName": "payments-api-gateway",
-                     *           "environment": "staging",
-                     *           "method": "GET",
-                     *           "path": "/payments",
-                     *           "routePath": "/payments",
-                     *           "status": 200,
-                     *           "callerId": "consumer-123",
-                     *           "callerSource": "header:x-consumer-id",
-                     *           "callerConfidence": "high",
-                     *           "occurredAt": "2026-06-07T14:00:00.000Z",
-                     *           "createdAt": "2026-06-07T14:00:01.000Z"
-                     *         }
-                     *       ],
-                     *       "pagination": {
-                     *         "hasMore": false,
-                     *         "limit": 50,
-                     *         "offset": 0,
-                     *         "total": 1
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["ListGatewayLogsResponse"];
                 };
             };
@@ -3715,13 +2437,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3731,13 +2446,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3747,13 +2455,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3783,21 +2484,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": [
-                     *         {
-                     *           "gatewayConfigName": "payments-api-gateway",
-                     *           "environment": "staging",
-                     *           "method": "GET",
-                     *           "routePath": "/payments",
-                     *           "lastSeenAt": "2026-06-07T14:00:00.000Z",
-                     *           "totalCalls": 15042,
-                     *           "uniqueCallerIds": 128
-                     *         }
-                     *       ]
-                     *     }
-                     */
                     "application/json": components["schemas"]["GetGatewayLogStatsResponse"];
                 };
             };
@@ -3807,13 +2493,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3823,13 +2502,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3839,13 +2511,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3856,10 +2521,7 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /**
-                 * @description Gateway log entry UUID
-                 * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
-                 */
+                /** @description Gateway log entry UUID */
                 id: components["parameters"]["logId"];
             };
             cookie?: never;
@@ -3872,25 +2534,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "data": {
-                     *         "id": "log-uuid-1",
-                     *         "provider": "kong",
-                     *         "gatewayConfigName": "payments-api-gateway",
-                     *         "environment": "staging",
-                     *         "method": "GET",
-                     *         "path": "/payments",
-                     *         "routePath": "/payments",
-                     *         "status": 200,
-                     *         "callerId": "consumer-123",
-                     *         "callerSource": "header:x-consumer-id",
-                     *         "callerConfidence": "high",
-                     *         "occurredAt": "2026-06-07T14:00:00.000Z",
-                     *         "createdAt": "2026-06-07T14:00:01.000Z"
-                     *       }
-                     *     }
-                     */
                     "application/json": components["schemas"]["GetGatewayLogResponse"];
                 };
             };
@@ -3900,13 +2543,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "unauthorized",
-                     *       "message": "Invalid or missing bearer token",
-                     *       "statusCode": 401
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3916,13 +2552,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "forbidden",
-                     *       "message": "Missing required scope: specs:write",
-                     *       "statusCode": 403
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3932,13 +2561,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "not_found",
-                     *       "message": "Log not found",
-                     *       "statusCode": 404
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };
@@ -3948,13 +2570,6 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "internal_error",
-                     *       "message": "Internal server error",
-                     *       "statusCode": 500
-                     *     }
-                     */
                     "application/json": components["schemas"]["ApiError"];
                 };
             };