docs(api): sync monit diagnose evidence schema

.agents/skills/api-review/mapping.yaml

@@ -385,6 +385,17 @@ modules:
       - name: fc-rum
         paths: [controller/application, logic/application, types]
 
+  rum/data:
+    priority: 305
+    tag_en: "Data query"
+    tag_zh: "RUM 数据查询"
+    icon: "chart-line"
+    path_prefixes: [/rum/data]
+    providers: [rum]
+    repos:
+      - name: fc-rum
+        paths: [controller/data, logic/data, types]
+
   rum/issue:
     priority: 310
     tag_en: "Issues"
@@ -423,11 +434,11 @@ modules:
     tag_en: "Facets"
     tag_zh: "RUM 自定义字段"
     icon: "filter"
-    path_prefixes: [/rum/facet]
+    path_prefixes: [/rum/facet, /rum/field]
     providers: [rum]
     repos:
       - name: fc-rum
-        paths: [controller/facet, logic/facet, types]
+        paths: [controller/facet, controller/field, logic/facet, logic/field, types]
 
   rum/sourcemap:
     priority: 350
@@ -543,10 +554,68 @@ modules:
     path_prefixes: [/push, /kv, /onboarding]
     providers: [pgy]
 
+  safari/session:
+    priority: 580
+    tag_en: "Sessions"
+    tag_zh: "会话"
+    icon: "comments"
+    path_prefixes: [/safari/session]
+    providers: [safari]
+    repos:
+      - name: fc-safari
+        paths: [cmd/api/sessions, logic/session, types]
+
+  safari/automation:
+    priority: 590
+    tag_en: "Automations"
+    tag_zh: "自动化"
+    icon: "clock"
+    path_prefixes:
+      - /safari/automation/rule
+      - /safari/automation/template
+      - /safari/automation/run
+    providers: [safari]
+    repos:
+      - name: fc-safari
+        paths: [cmd/api/automation, logic/automation, model/automation, types]
+
+  safari/skill:
+    priority: 600
+    tag_en: "Skills"
+    tag_zh: "技能"
+    icon: "wand-magic-sparkles"
+    path_prefixes: [/safari/skill]
+    providers: [safari]
+    repos:
+      - name: fc-safari
+        paths: [cmd/api/skills, logic/skill, types]
+
+  safari/mcp:
+    priority: 610
+    tag_en: "MCP servers"
+    tag_zh: "MCP 服务器"
+    icon: "plug"
+    path_prefixes: [/safari/mcp]
+    providers: [safari]
+    repos:
+      - name: fc-safari
+        paths: [cmd/api/mcp, logic/mcp, types]
+
+  safari/a2a-agent:
+    priority: 620
+    tag_en: "A2A agents"
+    tag_zh: "A2A 智能体"
+    icon: "robot"
+    path_prefixes: [/safari/a2a-agent]
+    providers: [safari]
+    repos:
+      - name: fc-safari
+        paths: [cmd/api/a2a, logic/a2a, types]
+
   _internal/safari:
     hidden: true
-    reason: "AI agent (fc-safari) — separate product surface, not part of the public Flashduty API."
-    path_prefixes: [/safari, /copilot, /ai]
+    reason: "Internal AI agent routes that remain non-public or are not yet published."
+    path_prefixes: [/copilot, /ai]
     providers: [safari, event]
 
   _internal/echo:
@@ -571,4 +640,3 @@ modules:
     reason: "Small unfinished surfaces; revisit when stable."
     path_prefixes: [/collab, /change, /onboarding]
     providers: [event, pgy]
-

.agents/skills/api-review/scripts/parse_pgy_registry.py

@@ -25,10 +25,11 @@
 from pathlib import Path
 
 # A row looks like:
-#   {ID: 15, Method: "POST", Path: "/access/external-exchange",
+#   {Product: "Platform", Method: "POST", Path: "/access/external-exchange",
 #    Name: "access:read:externalExchange", NameCN: "外部认证交换",
 #    Description: "...", Auth: "none", IsDangerous: false, IsAudit: false,
 #    Qps: 100, Provider: "pgy", Domain: "http://127.0.0.1:11482"},
+# Older rows can start with `ID: <number>,`; current name-keyed rows do not.
 #
 # Rows can be prefixed with `//` (commented-out). The convention:
 # - Commented rows = existing production APIs already persisted in the DB.
@@ -38,7 +39,7 @@
 # The file is a cumulative ledger; nothing deletes a row once registered.
 
 ROW_RE = re.compile(
-    r"""^\s*(?P<commented>//\s*)?\{ID:\s*(?P<id>\d+)\s*,\s*(?P<fields>.*)\},?\s*$""",
+    r"""^\s*(?P<commented>//\s*)?\{(?:ID:\s*(?P<id>\d+)\s*,\s*|(?=\s*Product:))(?P<fields>.*)\},?\s*$""",
     re.VERBOSE,
 )
 
@@ -76,10 +77,11 @@ def parse_file(path: Path) -> list[dict]:
                 continue
 
             row: dict = {
-                "id": int(m.group("id")),
                 "commented": m.group("commented") is not None,
                 "line": lineno,
             }
+            if m.group("id") is not None:
+                row["id"] = int(m.group("id"))
 
             for fm in FIELD_RE.finditer(m.group("fields")):
                 key = fm.group("key")

.github/workflows/integration-docs-upload.yml

@@ -1,5 +1,8 @@
 name: Upload integration docs to OSS
 
+env:
+  CDN_URL: 'https://docs-cdn.flashcat.cloud'
+
 on:
   push:
     branches: [main, test]
@@ -9,6 +12,7 @@ on:
       - 'en/on-call/integration/**'
       - 'zh/on-call/configuration/templates.mdx'
       - 'en/on-call/configuration/templates.mdx'
+      - '.github/workflows/integration-docs-upload.yml'
   workflow_dispatch:
     inputs:
       environment:
@@ -40,6 +44,10 @@ jobs:
         working-directory: integration-docs
         run: npm run check
 
+      - name: Test upload URL construction
+        working-directory: integration-docs
+        run: npm run test:upload-url
+
   upload-development:
     needs: build-check
     if: github.ref == 'refs/heads/test' || (github.event_name == 'workflow_dispatch' && github.event.inputs.environment == 'development')
@@ -66,7 +74,6 @@ jobs:
           CDN_BUCKET: ${{ secrets.CDN_BUCKET }}
           CDN_REGION: ${{ secrets.CDN_REGION }}
           CDN_ENDPOINT: ${{ secrets.CDN_ENDPOINT }}
-          CDN_URL: ${{ secrets.CDN_URL }}
           CDN_DIR: '/test/docs'
         run: npm run upload
 
@@ -96,6 +103,5 @@ jobs:
           CDN_BUCKET: ${{ secrets.CDN_BUCKET }}
           CDN_REGION: ${{ secrets.CDN_REGION }}
           CDN_ENDPOINT: ${{ secrets.CDN_ENDPOINT }}
-          CDN_URL: ${{ secrets.CDN_URL }}
           CDN_DIR: '/docs'
         run: npm run upload

.github/workflows/openapi-json-upload.yml

@@ -0,0 +1,105 @@
+name: Upload OpenAPI JSON to OSS
+
+env:
+  CDN_URL: 'https://docs-cdn.flashcat.cloud'
+
+on:
+  push:
+    branches: [main, test]
+    paths:
+      - 'api-reference/*.json'
+      - 'integration-docs/scripts/cdn-url.mjs'
+      - 'integration-docs/scripts/cdn-url.test.mjs'
+      - 'integration-docs/scripts/upload-openapi.mjs'
+      - 'integration-docs/scripts/upload-openapi.test.mjs'
+      - 'integration-docs/package.json'
+      - '.github/workflows/openapi-json-upload.yml'
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Target environment'
+        required: true
+        default: 'development'
+        type: choice
+        options:
+          - development
+          - production
+          - both
+
+jobs:
+  test-openapi-upload:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+
+      - name: Install dependencies
+        working-directory: integration-docs
+        run: npm install
+
+      - name: Test OpenAPI upload script
+        working-directory: integration-docs
+        run: npm run test:openapi-upload
+
+  upload-development:
+    needs: test-openapi-upload
+    if: github.ref == 'refs/heads/test' || (github.event_name == 'workflow_dispatch' && (github.event.inputs.environment == 'development' || github.event.inputs.environment == 'both'))
+    runs-on: ubuntu-latest
+    environment: development
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+
+      - name: Install dependencies
+        working-directory: integration-docs
+        run: npm install
+
+      - name: Upload development OpenAPI JSON
+        working-directory: integration-docs
+        env:
+          CDN_ACCESS_KEY: ${{ secrets.CDN_ACCESS_KEY }}
+          CDN_SECRET_KEY: ${{ secrets.CDN_SECRET_KEY }}
+          CDN_BUCKET: ${{ secrets.CDN_BUCKET }}
+          CDN_REGION: ${{ secrets.CDN_REGION }}
+          CDN_ENDPOINT: ${{ secrets.CDN_ENDPOINT }}
+          CDN_DIR: '/test/docs'
+        run: npm run upload:openapi
+
+  upload-production:
+    needs: test-openapi-upload
+    if: github.ref == 'refs/heads/main' || (github.event_name == 'workflow_dispatch' && (github.event.inputs.environment == 'production' || github.event.inputs.environment == 'both'))
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+
+      - name: Install dependencies
+        working-directory: integration-docs
+        run: npm install
+
+      - name: Upload production OpenAPI JSON
+        working-directory: integration-docs
+        env:
+          CDN_ACCESS_KEY: ${{ secrets.CDN_ACCESS_KEY }}
+          CDN_SECRET_KEY: ${{ secrets.CDN_SECRET_KEY }}
+          CDN_BUCKET: ${{ secrets.CDN_BUCKET }}
+          CDN_REGION: ${{ secrets.CDN_REGION }}
+          CDN_ENDPOINT: ${{ secrets.CDN_ENDPOINT }}
+          CDN_DIR: '/docs'
+        run: npm run upload:openapi