echopai 2.2.0 → 2.3.0

package/dist/_generated/commands.js

@@ -75,6 +75,22 @@ export function buildCommandTree(program, dispatch) {
             attachOperation(cmd, OPERATIONS["agent.session-usage"], dispatch);
         }
     }
+    {
+        const noun = program.command("announcements");
+        noun.description("announcements commands");
+        {
+            const cmd = noun.command("detail");
+            attachOperation(cmd, OPERATIONS["announcements.detail"], dispatch);
+        }
+        {
+            const cmd = noun.command("feed");
+            attachOperation(cmd, OPERATIONS["announcements.feed"], dispatch);
+        }
+        {
+            const cmd = noun.command("stock");
+            attachOperation(cmd, OPERATIONS["announcements.stock"], dispatch);
+        }
+    }
     {
         const noun = program.command("auth");
         noun.description("auth commands");
@@ -103,6 +119,46 @@ export function buildCommandTree(program, dispatch) {
             attachOperation(cmd, OPERATIONS["bars.minute-batch"], dispatch);
         }
     }
+    {
+        const noun = program.command("concepts");
+        noun.description("concepts commands");
+        {
+            const cmd = noun.command("alerts");
+            attachOperation(cmd, OPERATIONS["concepts.alerts"], dispatch);
+        }
+        {
+            const cmd = noun.command("alerts-history");
+            attachOperation(cmd, OPERATIONS["concepts.alerts-history"], dispatch);
+        }
+        {
+            const cmd = noun.command("daily-bars");
+            attachOperation(cmd, OPERATIONS["concepts.daily-bars"], dispatch);
+        }
+        {
+            const cmd = noun.command("list");
+            attachOperation(cmd, OPERATIONS["concepts.list"], dispatch);
+        }
+        {
+            const cmd = noun.command("minute-bars");
+            attachOperation(cmd, OPERATIONS["concepts.minute-bars"], dispatch);
+        }
+        {
+            const cmd = noun.command("news");
+            attachOperation(cmd, OPERATIONS["concepts.news"], dispatch);
+        }
+        {
+            const cmd = noun.command("show");
+            attachOperation(cmd, OPERATIONS["concepts.show"], dispatch);
+        }
+        {
+            const cmd = noun.command("snapshot");
+            attachOperation(cmd, OPERATIONS["concepts.snapshot"], dispatch);
+        }
+        {
+            const cmd = noun.command("views");
+            attachOperation(cmd, OPERATIONS["concepts.views"], dispatch);
+        }
+    }
     {
         const noun = program.command("digest");
         noun.description("digest commands");
@@ -147,6 +203,46 @@ export function buildCommandTree(program, dispatch) {
             attachOperation(cmd, OPERATIONS["index.snapshot"], dispatch);
         }
     }
+    {
+        const noun = program.command("industries");
+        noun.description("industries commands");
+        {
+            const cmd = noun.command("alerts");
+            attachOperation(cmd, OPERATIONS["industries.alerts"], dispatch);
+        }
+        {
+            const cmd = noun.command("daily-bars");
+            attachOperation(cmd, OPERATIONS["industries.daily-bars"], dispatch);
+        }
+        {
+            const cmd = noun.command("list");
+            attachOperation(cmd, OPERATIONS["industries.list"], dispatch);
+        }
+        {
+            const cmd = noun.command("show");
+            attachOperation(cmd, OPERATIONS["industries.show"], dispatch);
+        }
+        {
+            const cmd = noun.command("snapshot");
+            attachOperation(cmd, OPERATIONS["industries.snapshot"], dispatch);
+        }
+    }
+    {
+        const noun = program.command("limit-up");
+        noun.description("limit-up commands");
+        {
+            const cmd = noun.command("history");
+            attachOperation(cmd, OPERATIONS["limit-up.history"], dispatch);
+        }
+        {
+            const cmd = noun.command("pool");
+            attachOperation(cmd, OPERATIONS["limit-up.pool"], dispatch);
+        }
+        {
+            const cmd = noun.command("summary");
+            attachOperation(cmd, OPERATIONS["limit-up.summary"], dispatch);
+        }
+    }
     {
         const noun = program.command("market");
         noun.description("market commands");

package/dist/_generated/help.js

@@ -17,6 +17,21 @@ export const HELP = {
         "description": "返回 session 内累计 billable 调用次数、各 scope 配额消耗。",
         "example": "echopai agent session-usage VALUE"
     },
+    "announcements.detail": {
+        "summary": "Fetch a single announcement by id",
+        "description": "返回公告完整内容：content_md、content_text、cninfo 元数据、解析状态。",
+        "example": "echopai announcements detail VALUE"
+    },
+    "announcements.feed": {
+        "summary": "List recent A-share announcements",
+        "description": "A 股公告 feed，按 published_at 降序、同日按 cninfo source_id 降序。可按 type / since 过滤。需要 `announcements:read` scope。",
+        "example": "echopai announcements feed"
+    },
+    "announcements.stock": {
+        "summary": "List announcements for a specific A-share security",
+        "description": "指定股票代码的公告列表（含历史窗口）。代码接受 6 位纯数字或 SSE:600519 / SZSE:000001 / BSE:430000 形式。需要 `announcements:read` scope。",
+        "example": "echopai announcements stock --code SSE:600519"
+    },
     "auth.whoami": {
         "summary": "Token introspection (CLI/MCP capability discovery)",
         "description": "Returns the calling token's kind, scopes, audience, app metadata,\nrate_limit, allowed_clients, agent_budget (if kind=agent), api_version,\nfeature_flags. Any valid JWT can call — no specific scope required.\n\nCLI/MCP call this once at startup, cache 5 minutes in-process, and use\nthe response to derive `verbs.available` (intersection of curated verb\nscopes with token scopes) and to populate `echopai doctor` checks.\n\nSee `docs/PLAN_CLI_V2_AGENT_SURFACE.md` §5.1.\n",
@@ -42,10 +57,55 @@ export const HELP = {
         "description": "Batch minute OHLC bars for multiple A-share securities. Up to 20 codes\nper call, up to 7 calendar days (≈5 trading days) date range. Single\nClickHouse round-trip; app groups rows by canonical_code.\n\nPartial success envelope same as daily-batch: codes denied by\n`allowed_securities` go to `errors[]`; others to `items[]` with flat\n`bars[]` (each bar carries its own `trade_date` for client grouping).\n\nRequires `bars:30d` or `bars:full` scope.\n",
         "example": "echopai bars minute-batch --codes ['SSE:600519', 'SZSE:000001']"
     },
+    "concepts.alerts": {
+        "summary": "Currently active concept alerts (big_move / limit_up_cluster)",
+        "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",
+        "example": "echopai concepts alerts"
+    },
+    "concepts.alerts-history": {
+        "summary": "Concept alerts history (last 24h)",
+        "description": "Concept异动 historical events (default last 24h). Filter by rule (big_move / limit_up_cluster) and time window. Used by AI agent / admin review.",
+        "example": "echopai concepts alerts-history"
+    },
+    "concepts.daily-bars": {
+        "summary": "Concept index daily bars (chain-linked equal-weight, base 1000)",
+        "description": "Returns daily OHLC (concept index points, not stock prices average),\nbreadth fields, and is_backfilled flag. See PLAN §5.4 algorithm.\n",
+        "example": "echopai concepts daily-bars VALUE"
+    },
+    "concepts.list": {
+        "summary": "List concepts with live snapshot (6 fields)",
+        "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",
+        "example": "echopai concepts list"
+    },
+    "concepts.minute-bars": {
+        "summary": "Concept index minute bars (max 7 days)",
+        "description": "Concept index minute-level OHLC (chain-linked equal-weight, base = 1000), max 7 days per request. See PLAN_CONCEPT_INDUSTRY_QUOTE §5.4.",
+        "example": "echopai concepts minute-bars VALUE"
+    },
+    "concepts.news": {
+        "summary": "Related news matching concept name (ILIKE)",
+        "description": "Short-term implementation: ILIKE on news.title + content with the\nconcept name and full_name. Long-term: news AI tagging.\n",
+        "example": "echopai concepts news VALUE"
+    },
+    "concepts.show": {
+        "summary": "Concept detail (meta + member securities)",
+        "description": "Detail view for one concept: meta (full_name / source / status / approved_at / first_listed_at) plus current member securities with their latest snapshots.",
+        "example": "echopai concepts show VALUE"
+    },
+    "concepts.snapshot": {
+        "summary": "Bulk Redis snapshot of all concepts",
+        "description": "Returns the full concept_snapshots:latest hash. Use ?codes= to filter.",
+        "example": "echopai concepts snapshot"
+    },
+    "concepts.views": {
+        "summary": "Broker views associated with this concept",
+        "description": "JOIN concept_views × broker_views (ai_status=done) sorted by published_at desc.",
+        "example": "echopai concepts views VALUE"
+    },
     "digest.get": {
         "summary": "One-shot research digest for a single security (composite)",
         "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",
-        "example": "echopai digest get VALUE"
+        "example": "echopai digest get SSE:600519"
     },
     "financials.pit": {
         "summary": "Point-in-time financial indicators for one A-share at a given date",
@@ -59,7 +119,7 @@ export const HELP = {
     },
     "financials.reports": {
         "summary": "Recent financial reports for one A-share security",
-        "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",
         "example": "echopai financials reports --code SSE:600519"
     },
     "financials.series": {
@@ -82,6 +142,46 @@ export const HELP = {
         "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",
         "example": "echopai index snapshot --codes SSE:000001,SZSE:399001,BSE:899050"
     },
+    "industries.alerts": {
+        "summary": "Currently active industry alerts",
+        "description": "Currently active industry alerts (big_move / limit_up_cluster). Same rule set as concepts.",
+        "example": "echopai industries alerts"
+    },
+    "industries.daily-bars": {
+        "summary": "Industry index 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`).",
+        "example": "echopai industries daily-bars 401001:1"
+    },
+    "industries.list": {
+        "summary": "List industries (申万 L1/L2) with live snapshot",
+        "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",
+        "example": "echopai industries list"
+    },
+    "industries.show": {
+        "summary": "Industry detail (meta + today members)",
+        "description": "Path key format: `<sw_industry_code>:<sw_level>` (e.g. `401001:1`).",
+        "example": "echopai industries show 401001:1"
+    },
+    "industries.snapshot": {
+        "summary": "Bulk Redis snapshot of all industries",
+        "description": "Bulk Redis snapshot for 申万 industries (level 1 ≈ 127, level 2 ≈ 348). Use `codes` to narrow. Mirrors `/v1/concepts/snapshot` shape.",
+        "example": "echopai industries snapshot"
+    },
+    "limit-up.history": {
+        "summary": "A-share limit-up daily trend (last N days)",
+        "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",
+        "example": "echopai limit-up history"
+    },
+    "limit-up.pool": {
+        "summary": "A-share limit-up pool (per-stock detail) for a given trade date",
+        "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",
+        "example": "echopai limit-up pool"
+    },
+    "limit-up.summary": {
+        "summary": "A-share limit-up summary (counts + height ladder) for a given trade date",
+        "description": "涨停股池聚合统计：涨停数、炸板数、跌停数、最高连板高度、连板梯队\n`ladder: [{ height, count }, ...]`。\n\n炸板数 / 跌停数 与情绪页同源（`market_breadth_intraday` 当日最新分钟行）；\n连板梯队仅统计当前封板 status=limit_up 的个股。\n\n盘前回退规则与 `limit-up/pool` 一致。需要 `quote:*` scope。\n",
+        "example": "echopai limit-up summary"
+    },
     "market.status": {
         "summary": "Current A-share market session state",
         "description": "Current A-share market session: pre-open / open / lunch / closed; current and next trading day; holiday flag. Requires `market:read` or any `quote:*` scope.",
@@ -100,7 +200,7 @@ export const HELP = {
     "news.list": {
         "summary": "List news mentioning a specific security",
         "description": "List news mentioning a specific A-share security, ordered by published_at desc. Requires `news:read` scope.",
-        "example": "echopai news list --security SSE:600519"
+        "example": "echopai news list --security HK:00700"
     },
     "news.search": {
         "summary": "Full-text search recent news",
@@ -139,12 +239,12 @@ export const HELP = {
     },
     "sentiment.breadth": {
         "summary": "Intraday breadth time series",
-        "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",
         "example": "echopai sentiment breadth"
     },
     "sentiment.overview": {
         "summary": "Aggregate market sentiment indicators",
-        "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",
         "example": "echopai sentiment overview --scope main_board"
     },
     "sentiment.pct-distribution": {
@@ -154,7 +254,7 @@ export const HELP = {
     },
     "sentiment.turnover": {
         "summary": "Intraday turnover time series",
-        "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",
         "example": "echopai sentiment turnover"
     },
     "squawk.audio": {
@@ -190,6 +290,6 @@ export const HELP = {
     "views.recent": {
         "summary": "Recent broker / analyst views",
         "description": "List recent broker / analyst views (research notes, price targets, ratings). Filter by analyst, institution, or a specific security. Requires `views:read` scope.",
-        "example": "echopai views recent"
+        "example": "echopai views recent --security HK:00700"
     }
 };