Merge: Add Rankings Drop Audit workflow and resolve conflicts with v3.12.0

Author: cyberandy

.bin/rebuild-api.sh

@@ -15,4 +15,5 @@ npm run docusaurus clean-api-docs long-tail && npm run docusaurus gen-api-docs l
 npm run docusaurus clean-api-docs manager && npm run docusaurus gen-api-docs manager
 npm run docusaurus clean-api-docs middleware && npm run docusaurus gen-api-docs middleware
 npm run docusaurus clean-api-docs sitemap-generator && npm run docusaurus gen-api-docs sitemap-generator
-npm run docusaurus clean-api-docs summarizer && npm run docusaurus gen-api-docs summarizer
+npm run docusaurus clean-api-docs summarizer && npm run docusaurus gen-api-docs summarizer
+npm run docusaurus clean-api-docs query-fan-out && npm run docusaurus gen-api-docs query-fan-out

README.md

@@ -24,6 +24,22 @@ $ yarn build
 
 This command generates static content into the `build` directory and can be served using any static contents hosting service.
 
+### Type Checking
+
+```
+$ npm run typecheck
+```
+
+This runs TypeScript checks using the project `tsconfig.json` (which extends the Docusaurus base config).
+
+### Sidebar Checks
+
+```
+$ npm run test:sidebars
+```
+
+This verifies that API sidebar modules can be loaded from either `.js` or `.ts` files.
+
 ### Deployment
 
 Using SSH:
@@ -88,4 +104,4 @@ If you are using GitHub pages for hosting, this command is a convenient way to b
 npm run docusaurus clean-api-docs analysis && npm run docusaurus gen-api-docs analysis
 npm run docusaurus clean-api-docs events && npm run docusaurus gen-api-docs events
 npm run docusaurus clean-api-docs manager && npm run docusaurus gen-api-docs manager
-```
+```

TODO.md

@@ -0,0 +1,7 @@
+# TODO
+
+- [x] 2026-02-05 Bump docs version to 3.12.0 and refresh the Version Notice with the Monitor API guide.
+- [x] 2026-02-05 Fix typecheck by aligning tsconfig/types and sidebar imports.
+- [x] 2026-02-05 Make sidebar loading resilient to .js/.ts generation differences and add a test.
+- [x] 2026-02-05 Bump patch version to 3.12.1 for sidebar build fix.
+- [x] 2026-02-05 Add 34.52.203.209 to the IP whitelist.

api/ai_visibility_audits.yaml

@@ -24,7 +24,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/AnalyzeURLRequest"
+              "$ref": "#/components/schemas/AnalyzeContentRequest"
       responses:
         '200':
           description: Successful Response
@@ -42,9 +42,6 @@ components:
   schemas:
     AIVisibilityAnalysisResult:
       properties:
-        url:
-          type: string
-          title: Url
         num_queries_requested:
           type: integer
           title: Num Queries Requested
@@ -77,7 +74,6 @@ components:
           readOnly: true
       type: object
       required:
-      - url
       - num_queries_requested
       - coverage_threshold
       - entity_name
@@ -88,15 +84,23 @@ components:
       - content_chunks_count
       - coverage_score
       title: AIVisibilityAnalysisResult
-    AnalyzeURLRequest:
+    AnalyzeContentRequest:
       properties:
         url:
-          type: string
-          maxLength: 2083
-          minLength: 1
-          format: uri
+          anyOf:
+          - type: string
+            maxLength: 2083
+            minLength: 1
+            format: uri
+          - type: 'null'
           title: Url
-          description: The URL to analyze
+          description: URL to analyze
+        text:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Text
+          description: Raw text to analyze
         num_queries:
           type: integer
           maximum: 20
@@ -112,9 +116,7 @@ components:
           description: The threshold for answering synthetic queries
           default: 0.65
       type: object
-      required:
-      - url
-      title: AnalyzeURLRequest
+      title: AnalyzeContentRequest
     HTTPValidationError:
       properties:
         detail: