echopai 2.2.0 → 2.3.0

package/dist/_generated/operations.js

@@ -143,6 +143,148 @@ export const OPERATIONS = {
             ]
         }
     },
+    "announcements.detail": {
+        "cliKey": "announcements.detail",
+        "cliName": "announcements detail",
+        "method": "GET",
+        "path": "/v1/announcements/{announcement_id}",
+        "description": "返回公告完整内容：content_md、content_text、cninfo 元数据、解析状态。",
+        "summary": "Fetch a single announcement by id",
+        "positional": [
+            "announcement_id"
+        ],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "announcements:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "announcement_id": {
+                    "type": "string",
+                    "format": "uuid",
+                    "description": "UUID（feed / stock 返回的 items[].id）。"
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "announcement_id"
+            ]
+        }
+    },
+    "announcements.feed": {
+        "cliKey": "announcements.feed",
+        "cliName": "announcements feed",
+        "method": "GET",
+        "path": "/v1/announcements/feed",
+        "description": "A 股公告 feed，按 published_at 降序、同日按 cninfo source_id 降序。可按 type / since 过滤。需要 `announcements:read` scope。",
+        "summary": "List recent A-share announcements",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "offset",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "announcements:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "since": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "ISO datetime 下限（published_at >= since）。"
+                },
+                "type": {
+                    "type": "string",
+                    "maxLength": 64,
+                    "description": "分类 slug（见 classifier.py TYPES，如 annual_report、equity_change）。"
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 200,
+                    "default": 50,
+                    "description": "Max items per page."
+                },
+                "offset": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "default": 0,
+                    "description": "Pagination offset (items to skip)."
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "announcements.stock": {
+        "cliKey": "announcements.stock",
+        "cliName": "announcements stock",
+        "method": "GET",
+        "path": "/v1/announcements/stock",
+        "description": "指定股票代码的公告列表（含历史窗口）。代码接受 6 位纯数字或 SSE:600519 / SZSE:000001 / BSE:430000 形式。需要 `announcements:read` scope。",
+        "summary": "List announcements for a specific A-share security",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "offset",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "announcements:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "code": {
+                    "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
+                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                    "example": "SSE:600519"
+                },
+                "since_days": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 1825,
+                    "default": 30,
+                    "description": "回看天数（最多 5 年）。"
+                },
+                "type": {
+                    "type": "string",
+                    "maxLength": 64,
+                    "description": "分类 slug 过滤（与 /v1/announcements/feed 同集合）。"
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 200,
+                    "default": 50,
+                    "description": "Max items per page."
+                },
+                "offset": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "default": 0,
+                    "description": "Pagination offset (items to skip)."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "code"
+            ]
+        }
+    },
     "auth.whoami": {
         "cliKey": "auth.whoami",
         "cliName": "auth whoami",
@@ -189,8 +331,8 @@ export const OPERATIONS = {
             "properties": {
                 "code": {
                     "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
                     "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Single canonical code.",
                     "example": "SSE:600519"
                 },
                 "from": {
@@ -240,7 +382,9 @@ export const OPERATIONS = {
                     "type": "array",
                     "items": {
                         "type": "string",
-                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$"
+                        "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
+                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                        "example": "SSE:600519"
                     },
                     "minItems": 1,
                     "maxItems": 100,
@@ -293,8 +437,8 @@ export const OPERATIONS = {
             "properties": {
                 "code": {
                     "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
                     "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Single canonical code.",
                     "example": "SSE:600519"
                 },
                 "date": {
@@ -337,7 +481,9 @@ export const OPERATIONS = {
                     "type": "array",
                     "items": {
                         "type": "string",
-                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$"
+                        "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
+                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                        "example": "SSE:600519"
                     },
                     "minItems": 1,
                     "maxItems": 20,
@@ -352,17 +498,396 @@ export const OPERATIONS = {
                     "format": "date",
                     "description": "Inclusive start date (YYYY-MM-DD)."
                 },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive end date. Range must be ≤ 7 calendar days."
+                "to": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Inclusive end date. Range must be ≤ 7 calendar days."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "codes",
+                "from",
+                "to"
+            ]
+        }
+    },
+    "concepts.alerts": {
+        "cliKey": "concepts.alerts",
+        "cliName": "concepts alerts",
+        "method": "GET",
+        "path": "/v1/concepts/alerts",
+        "description": "Returns the live `concept_alerts:active` hash. Two rules:\n  - big_move: abs(pct_change) > 3%\n  - limit_up_cluster: limit_up_count >= 3 AND stock_count >= 5\nSee PLAN_CONCEPT_INDUSTRY_QUOTE §5.5 \"异动检测与推送\".\n",
+        "summary": "Currently active concept alerts (big_move / limit_up_cluster)",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": false,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": false
+        }
+    },
+    "concepts.alerts-history": {
+        "cliKey": "concepts.alerts-history",
+        "cliName": "concepts alerts-history",
+        "method": "GET",
+        "path": "/v1/concepts/alerts/history",
+        "description": "Concept异动 historical events (default last 24h). Filter by rule (big_move / limit_up_cluster) and time window. Used by AI agent / admin review.",
+        "summary": "Concept alerts history (last 24h)",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": false,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "from": {
+                    "type": "integer",
+                    "description": "Unix ms; default = now - 24h"
+                },
+                "to": {
+                    "type": "integer",
+                    "description": "Window end. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now)."
+                },
+                "rule": {
+                    "type": "string",
+                    "enum": [
+                        "big_move",
+                        "limit_up_cluster"
+                    ],
+                    "description": "Filter by alert rule: big_move (|pct| > 3%) or limit_up_cluster (≥3 limit-ups & ≥5 stocks)."
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 2000,
+                    "default": 500,
+                    "description": "Maximum number of items to return."
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "concepts.daily-bars": {
+        "cliKey": "concepts.daily-bars",
+        "cliName": "concepts daily-bars",
+        "method": "GET",
+        "path": "/v1/concepts/{concept_id}/daily-bars",
+        "description": "Returns daily OHLC (concept index points, not stock prices average),\nbreadth fields, and is_backfilled flag. See PLAN §5.4 algorithm.\n",
+        "summary": "Concept index daily bars (chain-linked equal-weight, base 1000)",
+        "positional": [
+            "concept_id"
+        ],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "bars:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "concept_id": {
+                    "type": "integer",
+                    "description": "Concept primary key (PG concepts.id)."
+                },
+                "from": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Window start. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now - 24h)."
+                },
+                "to": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Window end. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now)."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "concept_id",
+                "from",
+                "to"
+            ]
+        }
+    },
+    "concepts.list": {
+        "cliKey": "concepts.list",
+        "cliName": "concepts list",
+        "method": "GET",
+        "path": "/v1/concepts",
+        "description": "Concept list joining CH `v_concept_meta` with Redis snapshot hash\n`stockpulse:concept_snapshots:latest`. Each item includes 6 live\nfields (pct_change / index_value / up/down_count / limit_up_count /\namount) refreshed every ~15s by stockpulse-rs collector.\n\nSource / status / index are computed per PLAN_CONCEPT_INDUSTRY_QUOTE\n§5.4 algorithm (chain-linked equal-weight returns, base = 1000).\n",
+        "summary": "List concepts with live snapshot (6 fields)",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "status": {
+                    "type": "string",
+                    "enum": [
+                        "active",
+                        "pending_review",
+                        "deprecated"
+                    ],
+                    "default": "active",
+                    "description": "Concept status filter (active / pending_review / deprecated)."
+                },
+                "sort": {
+                    "type": "string",
+                    "enum": [
+                        "pct",
+                        "amount",
+                        "limit_up",
+                        "stock_count"
+                    ],
+                    "default": "pct",
+                    "description": "Sort field for the snapshot view: pct / amount / limit_up / stock_count."
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 1000,
+                    "default": 500,
+                    "description": "Maximum number of items to return."
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "concepts.minute-bars": {
+        "cliKey": "concepts.minute-bars",
+        "cliName": "concepts minute-bars",
+        "method": "GET",
+        "path": "/v1/concepts/{concept_id}/minute-bars",
+        "description": "Concept index minute-level OHLC (chain-linked equal-weight, base = 1000), max 7 days per request. See PLAN_CONCEPT_INDUSTRY_QUOTE §5.4.",
+        "summary": "Concept index minute bars (max 7 days)",
+        "positional": [
+            "concept_id"
+        ],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "bars:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "concept_id": {
+                    "type": "integer",
+                    "description": "Concept primary key (PG concepts.id)."
+                },
+                "from": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Window start. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now - 24h)."
+                },
+                "to": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Window end. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now)."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "concept_id",
+                "from",
+                "to"
+            ]
+        }
+    },
+    "concepts.news": {
+        "cliKey": "concepts.news",
+        "cliName": "concepts news",
+        "method": "GET",
+        "path": "/v1/concepts/{concept_id}/news",
+        "description": "Short-term implementation: ILIKE on news.title + content with the\nconcept name and full_name. Long-term: news AI tagging.\n",
+        "summary": "Related news matching concept name (ILIKE)",
+        "positional": [
+            "concept_id"
+        ],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "news:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "concept_id": {
+                    "type": "integer",
+                    "description": "Concept primary key (PG concepts.id)."
+                },
+                "days": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 365,
+                    "default": 30,
+                    "description": "Lookback window in days for news search."
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 200,
+                    "default": 50,
+                    "description": "Maximum number of items to return."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "concept_id"
+            ]
+        }
+    },
+    "concepts.show": {
+        "cliKey": "concepts.show",
+        "cliName": "concepts show",
+        "method": "GET",
+        "path": "/v1/concepts/{concept_id}",
+        "description": "Detail view for one concept: meta (full_name / source / status / approved_at / first_listed_at) plus current member securities with their latest snapshots.",
+        "summary": "Concept detail (meta + member securities)",
+        "positional": [
+            "concept_id"
+        ],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "concept_id": {
+                    "type": "integer",
+                    "description": "Concept primary key (PG concepts.id)."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "concept_id"
+            ]
+        }
+    },
+    "concepts.snapshot": {
+        "cliKey": "concepts.snapshot",
+        "cliName": "concepts snapshot",
+        "method": "GET",
+        "path": "/v1/concepts/snapshot",
+        "description": "Returns the full concept_snapshots:latest hash. Use ?codes= to filter.",
+        "summary": "Bulk Redis snapshot of all concepts",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "codes": {
+                    "type": "string",
+                    "description": "Comma-separated concept_id list (e.g. `1,2,3`); omit for all."
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "concepts.views": {
+        "cliKey": "concepts.views",
+        "cliName": "concepts views",
+        "method": "GET",
+        "path": "/v1/concepts/{concept_id}/views",
+        "description": "JOIN concept_views × broker_views (ai_status=done) sorted by published_at desc.",
+        "summary": "Broker views associated with this concept",
+        "positional": [
+            "concept_id"
+        ],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "views:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "concept_id": {
+                    "type": "integer",
+                    "description": "Concept primary key (PG concepts.id)."
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 200,
+                    "default": 50,
+                    "description": "Maximum number of items to return."
                 }
             },
             "additionalProperties": false,
             "required": [
-                "codes",
-                "from",
-                "to"
+                "concept_id"
             ]
         }
     },
@@ -389,8 +914,9 @@ export const OPERATIONS = {
             "properties": {
                 "code": {
                     "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
                     "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Canonical security code, e.g. SSE:600519."
+                    "example": "SSE:600519"
                 },
                 "views_since_days": {
                     "type": "integer",
@@ -443,8 +969,8 @@ export const OPERATIONS = {
             "properties": {
                 "code": {
                     "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
                     "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Canonical A-share code.",
                     "example": "SSE:600519"
                 },
                 "date": {
@@ -483,8 +1009,8 @@ export const OPERATIONS = {
             "properties": {
                 "code": {
                     "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
                     "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Canonical A-share code.",
                     "example": "SSE:600519"
                 },
                 "date": {
@@ -505,7 +1031,7 @@ export const OPERATIONS = {
         "cliName": "financials reports",
         "method": "GET",
         "path": "/v1/financials/reports",
-        "description": "返回该股票最近 N 期财务报告的核心指标（EPS/BPS/ROE/毛利率/营收/净利润/总\n资产/归母权益/经营现金流/总股本 等 ~25 字段）。可按 `kind` 过滤季报/半年报/\n年报。每期 `announce_date` 字段告知何时市场可见，建议结合回测时使用。\n",
+        "description": "返回该股票最近 N 期财务报告的核心指标（EPS/BPS/ROE/毛利率/营收/净利润/总\n资产/归母权益/经营现金流/总股本 等 ~25 字段）。可按 `kind` 过滤季报/半年报/\n年报。每期 `announce_date` 字段告知何时市场可见，建议结合回测时使用。\n\n**`kind` 口径说明**：\n\n- `Q1` / `H1` / `Q3` / `annual` —— 四个标准季度末快照（3-31 / 6-30 /\n  9-30 / 12-31），TDX 财务源数据全部落在这四个 report_date。\n- `preliminary` —— **当前数据源结构上不存在**。业绩预告 / 快报 是 indicators\n  行内的字段（`forecast_ni_lower` / `forecast_ni_upper` /\n  `express_ni_parent` / `express_revenue` 等），通过 `financials.series`\n  metric 参数访问，不是单独的 report_kind 行。`kind=preliminary` 会返\n  空列表 + meta.note。\n",
         "summary": "Recent financial reports for one A-share security",
         "positional": [],
         "outputDefault": "json",
@@ -523,8 +1049,8 @@ export const OPERATIONS = {
             "properties": {
                 "code": {
                     "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
                     "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Canonical A-share code.",
                     "example": "SSE:600519"
                 },
                 "limit": {
@@ -575,8 +1101,8 @@ export const OPERATIONS = {
             "properties": {
                 "code": {
                     "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
                     "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Canonical A-share code.",
                     "example": "SSE:600519"
                 },
                 "metric": {
@@ -739,6 +1265,311 @@ export const OPERATIONS = {
             "additionalProperties": false
         }
     },
+    "industries.alerts": {
+        "cliKey": "industries.alerts",
+        "cliName": "industries alerts",
+        "method": "GET",
+        "path": "/v1/industries/alerts",
+        "description": "Currently active industry alerts (big_move / limit_up_cluster). Same rule set as concepts.",
+        "summary": "Currently active industry alerts",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": false,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": false
+        }
+    },
+    "industries.daily-bars": {
+        "cliKey": "industries.daily-bars",
+        "cliName": "industries daily-bars",
+        "method": "GET",
+        "path": "/v1/industries/{key}/daily-bars",
+        "description": "Industry index daily OHLC (chain-linked equal-weight, base = 1000). Path key format `<sw_industry_code>:<sw_level>` (e.g. `401001:1`).",
+        "summary": "Industry index daily bars",
+        "positional": [
+            "key"
+        ],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "bars:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "key": {
+                    "type": "string",
+                    "description": "Industry key in `<sw_industry_code>:<sw_level>` format (e.g. `401001:1`).",
+                    "example": "401001:1"
+                },
+                "from": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Window start. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now - 24h)."
+                },
+                "to": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Window end. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now)."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "key",
+                "from",
+                "to"
+            ]
+        }
+    },
+    "industries.list": {
+        "cliKey": "industries.list",
+        "cliName": "industries list",
+        "method": "GET",
+        "path": "/v1/industries",
+        "description": "Industry index list joining CH `v_industry_meta` with Redis snapshot.\n申万一级 (level=1) ≈ 127 industries, 申万二级 (level=2) ≈ 348.\nChain-linked equal-weight algorithm identical to concepts (PLAN §5.4).\n",
+        "summary": "List industries (申万 L1/L2) with live snapshot",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "level": {
+                    "type": "integer",
+                    "enum": [
+                        1,
+                        2
+                    ],
+                    "default": 1,
+                    "description": "申万 industry level (1 or 2)."
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 1000,
+                    "default": 500,
+                    "description": "Maximum number of items to return."
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "industries.show": {
+        "cliKey": "industries.show",
+        "cliName": "industries show",
+        "method": "GET",
+        "path": "/v1/industries/{key}",
+        "description": "Path key format: `<sw_industry_code>:<sw_level>` (e.g. `401001:1`).",
+        "summary": "Industry detail (meta + today members)",
+        "positional": [
+            "key"
+        ],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "key": {
+                    "type": "string",
+                    "description": "Industry key in `<sw_industry_code>:<sw_level>` format (e.g. `401001:1`).",
+                    "example": "401001:1"
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "key"
+            ]
+        }
+    },
+    "industries.snapshot": {
+        "cliKey": "industries.snapshot",
+        "cliName": "industries snapshot",
+        "method": "GET",
+        "path": "/v1/industries/snapshot",
+        "description": "Bulk Redis snapshot for 申万 industries (level 1 ≈ 127, level 2 ≈ 348). Use `codes` to narrow. Mirrors `/v1/concepts/snapshot` shape.",
+        "summary": "Bulk Redis snapshot of all industries",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "codes": {
+                    "type": "string",
+                    "description": "Comma-separated `sw_code:level` (e.g. `401001:1,401002:1`); omit for all"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "limit-up.history": {
+        "cliKey": "limit-up.history",
+        "cliName": "limit-up history",
+        "method": "GET",
+        "path": "/v1/limit-up/history",
+        "description": "近 N 个交易日每日涨停数 + 最高连板 + 炸板数。涨停数 / 最高连板来源\n`market_limit_up_pool` (仅 status=limit_up)；炸板数来源\n`market_breadth_intraday`（all_a_ex_st 当日最新分钟行）。\n\n响应按 trade_date asc 排序（旧日期在前）。需要 `quote:*` scope。\n",
+        "summary": "A-share limit-up daily trend (last N days)",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "days": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 250,
+                    "default": 30,
+                    "description": "回看天数（1-250，默认 30）。"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "limit-up.pool": {
+        "cliKey": "limit-up.pool",
+        "cliName": "limit-up pool",
+        "method": "GET",
+        "path": "/v1/limit-up/pool",
+        "description": "当日（或指定 `trade_date`）涨停股池逐股明细：首/末次封板时间、最终涨幅、\n封单金额/封单量、炸板次数、连板数、N 日板内统计、一字板标记、当前 status\n(limit_up / broken)、板块分类。\n\n盘前回退规则（与所有行情类页面一致）：\n  - `< 9:00`：返回 max(trade_date) 的最新一日数据（昨日）\n  - `9:00-9:14`：集合竞价前空窗期，items=[] / trade_date=null\n  - `>= 9:15`：collector 已写入今日数据\n\n排序：连板数 desc → 板内板数 desc → 封单金额 desc。需要 `quote:*` scope。\n",
+        "summary": "A-share limit-up pool (per-stock detail) for a given trade date",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "trade_date": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "ISO date YYYY-MM-DD；不传走 latest（含盘前回退）。"
+                },
+                "include": {
+                    "type": "string",
+                    "enum": [
+                        "active",
+                        "all"
+                    ],
+                    "default": "active",
+                    "description": "active（默认）= 排除 ST/退市；all = 全部。"
+                },
+                "include_broken": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "true 时连炸板（status=broken）也一起返回；默认只返回当前封板 status=limit_up。"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "limit-up.summary": {
+        "cliKey": "limit-up.summary",
+        "cliName": "limit-up summary",
+        "method": "GET",
+        "path": "/v1/limit-up/summary",
+        "description": "涨停股池聚合统计：涨停数、炸板数、跌停数、最高连板高度、连板梯队\n`ladder: [{ height, count }, ...]`。\n\n炸板数 / 跌停数 与情绪页同源（`market_breadth_intraday` 当日最新分钟行）；\n连板梯队仅统计当前封板 status=limit_up 的个股。\n\n盘前回退规则与 `limit-up/pool` 一致。需要 `quote:*` scope。\n",
+        "summary": "A-share limit-up summary (counts + height ladder) for a given trade date",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "quote:l1",
+            "quote:l2",
+            "quote:delayed"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "trade_date": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "ISO date YYYY-MM-DD；不传走 latest。"
+                },
+                "include": {
+                    "type": "string",
+                    "enum": [
+                        "active",
+                        "all"
+                    ],
+                    "default": "active",
+                    "description": "active（默认 all_a_ex_st 口径）/ all（all_a 口径）。"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
     "market.status": {
         "cliKey": "market.status",
         "cliName": "market status",
@@ -843,9 +1674,9 @@ export const OPERATIONS = {
             "properties": {
                 "security": {
                     "type": "string",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Canonical security code.",
-                    "example": "SSE:600519"
+                    "description": "Any-market canonical code: A-share | HK (5-digit zero-padded) | US (uppercase ticker). For search/views/news endpoints.",
+                    "pattern": "^((SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\\-]{0,5})$",
+                    "example": "HK:00700"
                 },
                 "since_hours": {
                     "type": "integer",
@@ -966,7 +1797,9 @@ export const OPERATIONS = {
                     "type": "array",
                     "items": {
                         "type": "string",
-                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$"
+                        "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
+                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                        "example": "SSE:600519"
                     },
                     "minItems": 1,
                     "maxItems": 200,
@@ -1116,8 +1949,8 @@ export const OPERATIONS = {
             "properties": {
                 "code": {
                     "type": "string",
+                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
                     "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Canonical A-share code.",
                     "example": "SSE:600519"
                 }
             },
@@ -1172,7 +2005,7 @@ export const OPERATIONS = {
         "cliName": "sentiment breadth",
         "method": "GET",
         "path": "/v1/sentiment/breadth",
-        "description": "Intraday breadth time series. Requires `sentiment:read` scope.",
+        "description": "Intraday breadth time series for one trading day.\n`trade_date` 缺省 → 今日（盘前 9:00 前返回空 items）；显式传 YYYY-MM-DD 可\n拉历史任意交易日（来源 ClickHouse `market_breadth_intraday`，剔除 13:00\n稀疏分钟，单日最多 241 行）。Requires `sentiment:read` scope.\n",
         "summary": "Intraday breadth time series",
         "positional": [],
         "outputDefault": "json",
@@ -1200,6 +2033,11 @@ export const OPERATIONS = {
                     ],
                     "default": "all_a_ex_st",
                     "description": "Universe filter."
+                },
+                "trade_date": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "ISO date YYYY-MM-DD；不传走今日（盘前 9:00 前返空）。"
                 }
             },
             "additionalProperties": false
@@ -1210,7 +2048,7 @@ export const OPERATIONS = {
         "cliName": "sentiment overview",
         "method": "GET",
         "path": "/v1/sentiment/overview",
-        "description": "Aggregate sentiment: limit-up/down counts, breadth, divergence index, top movers. Requires `sentiment:read` scope.",
+        "description": "Aggregate sentiment snapshot for one trading day's latest minute:\nlimit-up/down counts, breadth, divergence index, MA / 52w breadth.\n`trade_date` 缺省 → 今日（Redis 实时，盘前 9:00 前返空结构）；显式传\nYYYY-MM-DD 拉历史任意日（最后一分钟聚合行，来源 ClickHouse\n`market_breadth_intraday`）。Requires `sentiment:read` scope.\n",
         "summary": "Aggregate market sentiment indicators",
         "positional": [],
         "outputDefault": "json",
@@ -1239,6 +2077,11 @@ export const OPERATIONS = {
                     "default": "all_a_ex_st",
                     "description": "Universe filter.",
                     "example": "main_board"
+                },
+                "trade_date": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "ISO date YYYY-MM-DD；不传走今日（实时）。"
                 }
             },
             "additionalProperties": false
@@ -1273,7 +2116,7 @@ export const OPERATIONS = {
         "cliName": "sentiment turnover",
         "method": "GET",
         "path": "/v1/sentiment/turnover",
-        "description": "Intraday turnover time series. Requires `sentiment:read` scope.",
+        "description": "Intraday turnover time series across one or more trading days.\n`trade_date` 缺省 → 今日（盘前 9:00 前返空 items）；显式 YYYY-MM-DD 拉\n历史任意交易日的当日 + 之前 `days-1` 天。Response 含 `current_turnover`\n/ `predicted_total` / `delta_vs_yesterday` headline 字段。Requires\n`sentiment:read` scope.\n",
         "summary": "Intraday turnover time series",
         "positional": [],
         "outputDefault": "json",
@@ -1301,6 +2144,18 @@ export const OPERATIONS = {
                     ],
                     "default": "all_a_ex_st",
                     "description": "Universe filter."
+                },
+                "trade_date": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "ISO date YYYY-MM-DD；不传走今日。"
+                },
+                "days": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 5,
+                    "default": 1,
+                    "description": "取该 trade_date 当日 + 之前 days-1 天的时序，用于同分钟同比 (1-5)。"
                 }
             },
             "additionalProperties": false
@@ -1499,8 +2354,9 @@ export const OPERATIONS = {
                 },
                 "security": {
                     "type": "string",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "description": "Filter by security code."
+                    "description": "Any-market canonical code: A-share | HK (5-digit zero-padded) | US (uppercase ticker). For search/views/news endpoints.",
+                    "pattern": "^((SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\\-]{0,5})$",
+                    "example": "HK:00700"
                 },
                 "since_days": {
                     "type": "integer",