echopai 2.0.0 → 2.2.0

package/dist/_generated/operations.js

@@ -165,72 +165,6 @@ export const OPERATIONS = {
             "additionalProperties": false
         }
     },
-    "backtest.excess-distribution": {
-        "cliKey": "backtest.excess-distribution",
-        "cliName": "backtest excess-distribution",
-        "method": "GET",
-        "path": "/v1/backtest/excess-distribution",
-        "description": "信号相对基准（沪深 300 / 中证 1000 等）持有期超额收益的直方分布。",
-        "summary": "Excess-return distribution over a benchmark",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "backtest.rolling-win-rate": {
-        "cliKey": "backtest.rolling-win-rate",
-        "cliName": "backtest rolling-win-rate",
-        "method": "GET",
-        "path": "/v1/backtest/rolling-win-rate",
-        "description": "信号在滚动窗口（默认 60 个交易日）内的胜率时间序列。",
-        "summary": "Rolling win rate of a signal series",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "backtest.summary": {
-        "cliKey": "backtest.summary",
-        "cliName": "backtest summary",
-        "method": "GET",
-        "path": "/v1/backtest/summary",
-        "description": "信号回测汇总：胜率、平均超额收益、Sharpe-like 评分、最大回撤等。",
-        "summary": "Backtest summary metrics for a signal series",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
     "bars.daily": {
         "cliKey": "bars.daily",
         "cliName": "bars daily",
@@ -437,7 +371,7 @@ export const OPERATIONS = {
         "cliName": "digest get",
         "method": "GET",
         "path": "/v1/digest/{code}",
-        "description": "Composite endpoint: in one HTTP call returns views (PRIMARY research),\nresearch-entity performance (quality layer), real-time quote, market\nsentiment context, and supplementary news. Partial-failure tolerant:\neach bucket is independently fetched and per-bucket failures surface\nin `meta.partial_failures[]` rather than poisoning the response. If\nevery sub-bucket fails the endpoint returns 502.\n\nBucket scopes are checked *per bucket* (not at gateway level): a\ntoken with only `views:read` gets the views bucket populated and the\nrest reported as `scope_insufficient` partial failures. This mirrors\nthe CLI fan-out contract exactly so `echopai digest` can either call\nthis endpoint (preferred, single round-trip) or fall back to local\nfan-out without behavior drift.\n\nSee `docs/PLAN_CLI_V2_AGENT_SURFACE.md` §3.3 (digest spec) and §11\nPhase 5.2 (server endpoint).\n",
+        "description": "Composite endpoint: in one HTTP call returns views (PRIMARY research),\nreal-time quote, valuation snapshot (PE/PB/PS/换手率/股息率/量比 等 14 字段),\nmarket sentiment context, and supplementary news.\nPartial-failure tolerant:\neach bucket is independently fetched and per-bucket failures surface\nin `meta.partial_failures[]` rather than poisoning the response. If\nevery sub-bucket fails the endpoint returns 502.\n\nBucket scopes are checked *per bucket* (not at gateway level): a\ntoken with only `views:read` gets the views bucket populated and the\nrest reported as `scope_insufficient` partial failures. This mirrors\nthe CLI fan-out contract exactly so `echopai digest` can either call\nthis endpoint (preferred, single round-trip) or fall back to local\nfan-out without behavior drift.\n\nSee `docs/PLAN_CLI_V2_AGENT_SURFACE.md` §3.3 (digest spec) and §11\nPhase 5.2 (server endpoint).\n",
         "summary": "One-shot research digest for a single security (composite)",
         "positional": [
             "code"
@@ -486,6 +420,325 @@ export const OPERATIONS = {
             ]
         }
     },
+    "financials.pit": {
+        "cliKey": "financials.pit",
+        "cliName": "financials pit",
+        "method": "GET",
+        "path": "/v1/financials/pit",
+        "description": "基于 TDX 财务数据的 Point-in-time 查询。给定 `code` 和 `date`，返回该\n`trade_date` 当时市场上可见的最新一期财务报告（`announce_date <= date`，\n无公告日时保守延迟 90 天）。专为回测、AI agent、量化策略防未来函数泄漏。\n\n返回字段包括：EPS（基本/扣非/稀释）、BPS、ROE、毛利率、营收/净利润/总资产/\n归母权益等核心 ~25 字段。\n",
+        "summary": "Point-in-time financial indicators for one A-share at a given date",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "financials:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "code": {
+                    "type": "string",
+                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                    "description": "Canonical A-share code.",
+                    "example": "SSE:600519"
+                },
+                "date": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Trade date in YYYY-MM-DD; defaults to today.",
+                    "example": "2024-11-01"
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "code"
+            ]
+        }
+    },
+    "financials.quote-snapshot": {
+        "cliKey": "financials.quote-snapshot",
+        "cliName": "financials quote-snapshot",
+        "method": "GET",
+        "path": "/v1/financials/quote-snapshot",
+        "description": "一站式估值快照 —— 一次返回 14 个字段，**全部基于 TDX 原始数据 + Sina 实时\n价自算，不依赖 Tushare**：\n\n- 估值: `pe` / `pe_ttm` / `pb` / `ps` / `ps_ttm`\n- 股本（万股）: `total_share` / `float_share` / `free_share`\n- 市值（万元）: `total_mv` / `circ_mv`\n- 流动性: `turnover_rate` / `turnover_rate_f`（%）/ `volume_ratio`（倍）\n- 分红: `dv_ratio` / `dv_ttm`（%）\n\n计算口径：\n- PE-TTM = 当前总市值 / 近 4 季度滚动净利润（PIT 表 `ni_parent_ttm`）\n- PE     = 当前总市值 / 上年报净利润（`ni_parent_last1y`）\n- PB     = 当前总市值 / 归母净资产（`equity_parent`，PIT 防穿越）\n- 换手率 = 当日累计成交量 / 流通股本 × 100\n- 量比   = 当日累计 / 近 5 日同时段累计平均（实时模式）\n          / 近 5 日全日成交量平均（指定历史日期模式）\n- 股息率 = Σ(去年 / 近12月内派息事件 派现/10) / 现价 × 100\n\n默认 `date` 留空 → 实时（Sina 5s 快照价 + 当日累计成交量）；\n给 `date=YYYY-MM-DD` 则按当日 close 取值（用于历史回测 / 校验）。\n\n财报数据走 `security_financial_indicators_pit` PIT 视图：保证 `visible_date`\n≤ trade_date，避免未来函数。\n\n准确性已对照 Tushare `daily_basic` 校验（见 `scripts/validation/validate_quote_snapshot_vs_tushare.py`）。\n",
+        "summary": "Real-time valuation / share / turnover snapshot for one A-share",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "financials:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "code": {
+                    "type": "string",
+                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                    "description": "Canonical A-share code.",
+                    "example": "SSE:600519"
+                },
+                "date": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Trade date YYYY-MM-DD; omit for real-time (Redis snapshot price).\n",
+                    "example": "2026-05-13"
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "code"
+            ]
+        }
+    },
+    "financials.reports": {
+        "cliKey": "financials.reports",
+        "cliName": "financials reports",
+        "method": "GET",
+        "path": "/v1/financials/reports",
+        "description": "返回该股票最近 N 期财务报告的核心指标（EPS/BPS/ROE/毛利率/营收/净利润/总\n资产/归母权益/经营现金流/总股本 等 ~25 字段）。可按 `kind` 过滤季报/半年报/\n年报。每期 `announce_date` 字段告知何时市场可见，建议结合回测时使用。\n",
+        "summary": "Recent financial reports for one A-share security",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "financials:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "code": {
+                    "type": "string",
+                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                    "description": "Canonical A-share code.",
+                    "example": "SSE:600519"
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 100,
+                    "default": 12,
+                    "description": "Max periods to return (1-100, default 12)."
+                },
+                "kind": {
+                    "type": "string",
+                    "enum": [
+                        "Q1",
+                        "H1",
+                        "Q3",
+                        "annual",
+                        "preliminary"
+                    ],
+                    "description": "Filter by report kind."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "code"
+            ]
+        }
+    },
+    "financials.series": {
+        "cliKey": "financials.series",
+        "cliName": "financials series",
+        "method": "GET",
+        "path": "/v1/financials/series",
+        "description": "返回某只股票某个财务指标的历史时间序列（按报告期排列）。`metric` 是\nindicators 表中的字段名（如 `roe_simple` / `revenue` / `ni_parent` /\n`debt_asset_ratio` / `gross_margin` / `eps_basic` 等共 150 个）。\n\n典型用法：画茅台 10 年 ROE 走势、对比 5 只白酒股 net_margin。\n",
+        "summary": "Time series of a single financial metric for one security",
+        "positional": [],
+        "outputDefault": "json",
+        "pagination": "none",
+        "stream": false,
+        "billable": true,
+        "idempotencyRequired": false,
+        "scopesAny": [
+            "financials:read"
+        ],
+        "sideEffect": "read",
+        "dryRunSupported": false,
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "code": {
+                    "type": "string",
+                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                    "description": "Canonical A-share code.",
+                    "example": "SSE:600519"
+                },
+                "metric": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64,
+                    "description": "Indicator field name (e.g. roe_simple, revenue, ni_parent).",
+                    "example": "roe_simple"
+                },
+                "from": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Inclusive earliest report_date."
+                },
+                "to": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Inclusive latest report_date."
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 200,
+                    "default": 40,
+                    "description": "Max points (1-200, default 40)."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "code",
+                "metric"
+            ]
+        }
+    },
+    "index.daily-bars": {
+        "cliKey": "index.daily-bars",
+        "cliName": "index daily-bars",
+        "method": "GET",
+        "path": "/v1/index/bars/daily",
+        "description": "指数日线 OHLC。覆盖 v2 表中的指数（上证综指 `SSE:000001` / 深证成指\n`SZSE:399001` / 沪深300 `SSE:000300` / 北证50 `BSE:899050` / 中证系列 `CSI:000922` 等）。\n与 `/v1/bars/daily` 同语义，但 index 没有 `turnover_rate` / `paused` 等股票特有字段。\n",
+        "summary": "Daily OHLC bars for one A-share index",
+        "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": {
+                "code": {
+                    "type": "string",
+                    "description": "Canonical index code.",
+                    "example": "SSE:000001"
+                },
+                "from": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Inclusive start date (YYYY-MM-DD).",
+                    "example": "2024-01-01"
+                },
+                "to": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Inclusive end date.",
+                    "example": "2024-12-31"
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "code",
+                "from",
+                "to"
+            ]
+        }
+    },
+    "index.minute-bars": {
+        "cliKey": "index.minute-bars",
+        "cliName": "index minute-bars",
+        "method": "GET",
+        "path": "/v1/index/bars/minute",
+        "description": "指数 1min OHLC。日期范围 ≤ 7 天（与 `/v1/bars/minute-batch` 对齐）。\n返回 `bar_time` / `trade_date` / OHLC / volume / amount / pct_change。\n",
+        "summary": "Minute OHLC bars for one A-share index",
+        "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": {
+                "code": {
+                    "type": "string",
+                    "description": "Canonical index code.",
+                    "example": "SSE:000001"
+                },
+                "from": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Inclusive start date (YYYY-MM-DD)."
+                },
+                "to": {
+                    "type": "string",
+                    "format": "date",
+                    "description": "Inclusive end date. Range ≤ 7 calendar days."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "code",
+                "from",
+                "to"
+            ]
+        }
+    },
+    "index.snapshot": {
+        "cliKey": "index.snapshot",
+        "cliName": "index snapshot",
+        "method": "GET",
+        "path": "/v1/index/snapshot",
+        "description": "Returns the latest real-time snapshot for the 172 indices that Sina\nexposes a quote for (SSE / SZSE / BSE — includes 北证50 `BSE:899050`\nand 专精特新 `899601.BJ`). Source is the Redis hash\n`stockpulse:index_snapshots:latest` which the Rust collector refreshes\nevery ~15 seconds during market hours; outside trading hours the last\nintraday snapshot is returned.\n\nUse `codes` to narrow to a subset (canonical format `SSE:000001` (exchange-prefix; legacy `000001.SH` is also accepted but discouraged)).\nOmit to receive all 172.\n\nNote: CSI-series indices (e.g. `CSI:000922`) are not available here —\nSina has no quote feed for them. Daily/minute history for those still\nlives behind `/api/internal/index/{daily-bars,minute-bars-range}`.\n\nRequires `quote:l1`, `quote:l2`, or `quote:delayed` scope.\n",
+        "summary": "Real-time snapshot of all Sina-OK A-share indices (172 indices)",
+        "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 canonical index codes (e.g. `SSE:000001,SZSE:399001,BSE:899050`).\nOmit to return all 172.\n",
+                    "example": "SSE:000001,SZSE:399001,BSE:899050"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
     "market.status": {
         "cliKey": "market.status",
         "cliName": "market status",
@@ -540,7 +793,7 @@ export const OPERATIONS = {
         "cliName": "news get",
         "method": "GET",
         "path": "/v1/news/{news_id}",
-        "description": "返回新闻完整内容：title、content snippet、source URL、tagged securities。",
+        "description": "返回新闻完整内容：title、content snippet、tagged securities。（采集端字段 source / source_id / source_url 对外不暴露，admin 路径 /v1/admin/news/{id} 可见。）",
         "summary": "Fetch a single news item by id",
         "positional": [
             "news_id"
@@ -620,7 +873,7 @@ export const OPERATIONS = {
         "cliName": "news search",
         "method": "GET",
         "path": "/v1/news/search",
-        "description": "Full-text search recent news / market briefs. Returns title, source, published_at, snippet, tagged securities. Requires `news:read` scope. Note: news fields are user-generated; meta.untrusted_text_fields lists fields that need sanitization before passing to an LLM.",
+        "description": "Full-text search recent news / market briefs. Returns title, published_at, snippet, tagged securities. (Internal collector identifiers — `source`/`source_id`/`source_url` — are NOT exposed publicly; admin tools see them via /v1/admin/*.) Requires `news:read` scope. Note: news fields are user-generated; meta.untrusted_text_fields lists fields that need sanitization before passing to an LLM.",
         "summary": "Full-text search recent news",
         "positional": [],
         "outputDefault": "json",
@@ -664,28 +917,6 @@ export const OPERATIONS = {
             ]
         }
     },
-    "news.sources": {
-        "cliKey": "news.sources",
-        "cliName": "news sources",
-        "method": "GET",
-        "path": "/v1/news/sources",
-        "description": "返回新闻 source 标识列表（如 `cls`、`jin10`、`twitter`、`wallstreetcn`），可用于 list/search 的 source 过滤。",
-        "summary": "List canonical news source identifiers",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
     "payment.plans": {
         "cliKey": "payment.plans",
         "cliName": "payment plans",
@@ -796,45 +1027,81 @@ export const OPERATIONS = {
             "additionalProperties": false
         }
     },
-    "research.entity-performance": {
-        "cliKey": "research.entity-performance",
-        "cliName": "research entity-performance",
+    "search.semantic": {
+        "cliKey": "search.semantic",
+        "cliName": "search semantic",
         "method": "GET",
-        "path": "/v1/research-entities/{entity_id}/performance",
-        "description": "单个研究实体的细化绩效指标，对照 `/v1/research-entities/performance`。",
-        "summary": "Performance of one research entity",
-        "positional": [
-            "entity_id"
-        ],
+        "path": "/v1/search",
+        "description": "语义 + 模糊泛化搜索。结合 entity 精确匹配（公司代码/分析师）、向量召回（pgvector\n+ DashScope embedding）、trigram 模糊、ILIKE 精确四路召回，RRF 融合后用 reranker\n精排，叠时间衰减 + views 加权（views 主源优先）。\n\n- 搜\"锂电池\"会带出新能源产业链（正极/负极/碳酸锂/宁德时代…）\n- 搜\"芯片\"会带出存储芯片/洁净室/晶圆代工…\n- mode=exact 兼容老 ILIKE 行为，仅在精确关键词命中时返回。\n",
+        "summary": "Hybrid semantic search across news + analyst views",
+        "positional": [],
         "outputDefault": "json",
         "pagination": "none",
         "stream": false,
-        "billable": false,
+        "billable": true,
         "idempotencyRequired": false,
-        "scopesAny": [],
+        "scopesAny": [
+            "news:read",
+            "views:read"
+        ],
         "sideEffect": "read",
         "dryRunSupported": false,
         "inputSchema": {
             "type": "object",
             "properties": {
-                "entity_id": {
+                "q": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200,
+                    "description": "Free-text query (Chinese or English).",
+                    "example": "锂电池"
+                },
+                "type": {
+                    "type": "string",
+                    "enum": [
+                        "news",
+                        "views",
+                        "all"
+                    ],
+                    "default": "all",
+                    "description": "Search scope: news | views | all"
+                },
+                "mode": {
                     "type": "string",
-                    "description": "Research-entity id (returned by research-entities.list / matcher)."
+                    "enum": [
+                        "hybrid",
+                        "exact"
+                    ],
+                    "default": "hybrid",
+                    "description": "hybrid = 语义 + 精确融合 + rerank；exact = 仅 ILIKE 兼容老逻辑"
+                },
+                "hours": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 720,
+                    "description": "Lookback window in hours."
+                },
+                "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 50,
+                    "default": 20,
+                    "description": "Max items returned."
                 }
             },
             "additionalProperties": false,
             "required": [
-                "entity_id"
+                "q"
             ]
         }
     },
-    "research.entity-performance-list": {
-        "cliKey": "research.entity-performance-list",
-        "cliName": "research entity-performance-list",
+    "securities.industry": {
+        "cliKey": "securities.industry",
+        "cliName": "securities industry",
         "method": "GET",
-        "path": "/v1/research-entities/performance",
-        "description": "全体研究实体（analyst / team / institution）的命中率、平均目标价达成率、覆盖股票数等汇总。需要 `research:read` scope。",
-        "summary": "Aggregate performance of research entities",
+        "path": "/v1/securities/industry",
+        "description": "返回该股票的 TDX 自定义行业代码（T1001 食品饮料等）与申万行业三级代码\nL1/L2/L3（X5001 食品饮料 / X500102 白酒 等）。\n\n用法：\n- 股票详情页\"申万行业：白酒 / 食品饮料\"标签\n- 筛选器交叉过滤：行业 + ROE/营收增长率\n- AI agent `find_peers(code)` 用申万二级行业找同业\n",
+        "summary": "TDX + 申万 industry classification for one A-share security",
         "positional": [],
         "outputDefault": "json",
         "pagination": "none",
@@ -846,8 +1113,18 @@ export const OPERATIONS = {
         "dryRunSupported": false,
         "inputSchema": {
             "type": "object",
-            "properties": {},
-            "additionalProperties": false
+            "properties": {
+                "code": {
+                    "type": "string",
+                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
+                    "description": "Canonical A-share code.",
+                    "example": "SSE:600519"
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "code"
+            ]
         }
     },
     "semantic.find": {
@@ -1029,60 +1306,6 @@ export const OPERATIONS = {
             "additionalProperties": false
         }
     },
-    "signals.outcome": {
-        "cliKey": "signals.outcome",
-        "cliName": "signals outcome",
-        "method": "GET",
-        "path": "/v1/signals/{signal_id}/outcome",
-        "description": "单条 signal 的细化结果追踪。",
-        "summary": "Outcome trace for a single signal",
-        "positional": [
-            "signal_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "signal_id": {
-                    "type": "string",
-                    "description": "Signal id (returned by signals/outcomes items[].signal_id)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "signal_id"
-            ]
-        }
-    },
-    "signals.outcomes": {
-        "cliKey": "signals.outcomes",
-        "cliName": "signals outcomes",
-        "method": "GET",
-        "path": "/v1/signals/outcomes",
-        "description": "返回分析师 views 派生信号的实际结果（目标价命中 / 止损 / 到期），含命中时长、最大回撤等。",
-        "summary": "Outcomes of analyst-view-derived signals",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "offset",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
     "squawk.audio": {
         "cliKey": "squawk.audio",
         "cliName": "squawk audio",