echopai 2.4.0 → 2.6.0

package/dist/bin.js

@@ -229,6 +229,66 @@ var OPERATIONS = {
       additionalProperties: false
     }
   },
+  "announcements.search": {
+    cliKey: "announcements.search",
+    cliName: "announcements search",
+    method: "GET",
+    path: "/v1/announcements/search",
+    description: "公告混合搜索：名称 / 代码做结构化过滤 + 关键词 BM25 全文（ParadeDB jieba，覆盖 title / ai_summary / content_md 前 1500 字）。q 含 6 位代码或内嵌 A 股名 → 按代码精确过滤；残余或纯文本 → BM25 按相关度×时间衰减排序；纯代码/名称则按 published_at 倒序列出。需要 `announcements:read` scope。",
+    summary: "Hybrid search over 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: {
+        q: {
+          type: "string",
+          minLength: 1,
+          maxLength: 100,
+          description: '名称 / 代码 / 关键词，可混合（如 "新华医疗 回购"、"600587"、"回购"）。',
+          example: "新华医疗 回购"
+        },
+        type: {
+          type: "string",
+          maxLength: 64,
+          description: "分类 slug 过滤（与 /v1/announcements/feed 同集合）。"
+        },
+        since_days: {
+          type: "integer",
+          minimum: 1,
+          maximum: 1825,
+          default: 90,
+          description: "回看天数（最多 5 年）。"
+        },
+        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: [
+        "q"
+      ]
+    }
+  },
   "announcements.stock": {
     cliKey: "announcements.stock",
     cliName: "announcements stock",
@@ -960,9 +1020,9 @@ Phase 5.2 (server endpoint).
         views_since_days: {
           type: "integer",
           minimum: 1,
-          maximum: 90,
+          maximum: 30,
           default: 7,
-          description: "Views lookback in days (1-90)."
+          description: "Views lookback in days (1-30; views feed caps at 30d. Use the `views` verb's from/to for longer history)."
         },
         news_hours: {
           type: "integer",
@@ -1489,6 +1549,39 @@ Phase 5.2 (server endpoint).
       additionalProperties: false
     }
   },
+  "limit-up.analysis": {
+    cliKey: "limit-up.analysis",
+    cliName: "limit-up analysis",
+    method: "GET",
+    path: "/v1/limit-up/analysis",
+    description: '涨停股 LLM 归因：逐股「主导题材 leading_concept + 概念标签 concept_tags +\n涨停理由 reason」。题材由 LLM 依据最新研报 / 机构观点 / 快讯判定，**不依赖概念\n图谱**（可含图谱里还没有的全新题材），每交易日北京 9:45 / 11:00 / 12:30 / 14:00 /\n14:40 / 18:00 共 6 个时段自动刷新（后跑时段在前次基础上 refine）。\n\n与 `limit-up/pool` 互补：pool 给"涨停了哪些票"（行情数据，stockpulse 上游），\n本接口给"为什么涨停 / 属什么题材"（LLM 归因，echopai api 上游）。pool 里的\ngraph-based `leading_concept` 是另一条数据，本接口的 `leading_concept` 才是\nLLM 判定结果。\n\n⚠️ **trade_date 不传 = 库内最新「已归因」交易日**（非自然最新交易日）：归因每个\n时段按当时池快照写库，今日**首个时段（北京约 09:47）落库前**，不传 trade_date\n会返回**上一交易日**的归因（不是今日空结果）——agent 拿当日数据请显式传今日\ntrade_date 并以 `trade_date` / `generated_at` 字段核对时效。显式传某交易日而该日\n尚未归因时，`analyses` 为空。\n\n平面归属：本接口在 **vu 平面**（前端 apiFetch 同源），与 `market/status` 同款\n`x-audience: vu`；行情类 `limit-up/pool|summary|history` 在 sp 平面（前端 spFetch）。\n需要 `market:read` 或任一 `quote:*` scope。\n',
+    summary: "A-share limit-up LLM attribution (per-stock leading theme + reason)",
+    positional: [],
+    outputDefault: "json",
+    pagination: "none",
+    stream: false,
+    billable: true,
+    idempotencyRequired: false,
+    scopesAny: [
+      "market:read",
+      "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；不传走库内**最新已归因**交易日（今日首段落库前会回退到上一交易日）。"
+        }
+      },
+      additionalProperties: false
+    }
+  },
   "limit-up.history": {
     cliKey: "limit-up.history",
     cliName: "limit-up history",
@@ -1723,7 +1816,17 @@ Phase 5.2 (server endpoint).
           minimum: 1,
           maximum: 720,
           default: 24,
-          description: "Lookback window in hours (max 720 = 30 days)."
+          description: "Rolling-feed lookback in hours (≤720 = 30d). For longer history use from/to."
+        },
+        from: {
+          type: "string",
+          format: "date",
+          description: "History range start (China date YYYY-MM-DD). Range mode: with the security filter present, long history is capped at 365 days and Pro-only (non-Pro clamped to 30 days)."
+        },
+        to: {
+          type: "string",
+          format: "date",
+          description: "History range end (inclusive, China date; defaults to today). Only used with from."
         },
         limit: {
           type: "integer",
@@ -1731,6 +1834,12 @@ Phase 5.2 (server endpoint).
           maximum: 100,
           default: 20,
           description: "Max items per page."
+        },
+        offset: {
+          type: "integer",
+          minimum: 0,
+          default: 0,
+          description: "Pagination offset (page through long history ranges)."
         }
       },
       additionalProperties: false,
@@ -1770,9 +1879,19 @@ Phase 5.2 (server endpoint).
         since_hours: {
           type: "integer",
           minimum: 1,
-          maximum: 168,
+          maximum: 720,
           default: 24,
-          description: "Lookback window in hours."
+          description: "Rolling-feed lookback in hours (≤720 = 30d). For longer history use from/to."
+        },
+        from: {
+          type: "string",
+          format: "date",
+          description: "History range start (China date YYYY-MM-DD). Range mode: with the query filter present, long history is capped at 365 days and Pro-only (non-Pro clamped to 30 days)."
+        },
+        to: {
+          type: "string",
+          format: "date",
+          description: "History range end (inclusive, China date; defaults to today). Only used with from."
         },
         limit: {
           type: "integer",
@@ -1780,6 +1899,12 @@ Phase 5.2 (server endpoint).
           maximum: 100,
           default: 20,
           description: "Max items per page."
+        },
+        offset: {
+          type: "integer",
+          minimum: 0,
+          default: 0,
+          description: "Pagination offset (page through long history ranges)."
         }
       },
       additionalProperties: false,
@@ -2330,70 +2455,6 @@ L1/L2/L3（X5001 食品饮料 / X500102 白酒 等）。
       additionalProperties: false
     }
   },
-  "squawk.audio": {
-    cliKey: "squawk.audio",
-    cliName: "squawk audio",
-    method: "GET",
-    path: "/v1/squawk/{item_id}/audio",
-    description: "返回 squawk 项的 TTS 音频（MP3）。直接 stream，可作为 `<audio>` src 用。",
-    summary: "Stream squawk TTS audio",
-    positional: [
-      "item_id"
-    ],
-    outputDefault: "json",
-    pagination: "none",
-    stream: false,
-    billable: false,
-    idempotencyRequired: false,
-    scopesAny: [],
-    sideEffect: "read",
-    dryRunSupported: false,
-    inputSchema: {
-      type: "object",
-      properties: {
-        item_id: {
-          type: "string",
-          description: "Squawk item id (returned by squawk.recent items[].id)."
-        }
-      },
-      additionalProperties: false,
-      required: [
-        "item_id"
-      ]
-    }
-  },
-  "squawk.waveform": {
-    cliKey: "squawk.waveform",
-    cliName: "squawk waveform",
-    method: "GET",
-    path: "/v1/squawk/{item_id}/waveform",
-    description: "返回 squawk 音频的预计算波形 peak 数据，用于客户端波形可视化。",
-    summary: "Waveform peaks for squawk audio",
-    positional: [
-      "item_id"
-    ],
-    outputDefault: "json",
-    pagination: "none",
-    stream: false,
-    billable: false,
-    idempotencyRequired: false,
-    scopesAny: [],
-    sideEffect: "read",
-    dryRunSupported: false,
-    inputSchema: {
-      type: "object",
-      properties: {
-        item_id: {
-          type: "string",
-          description: "Squawk item id (returned by squawk.recent items[].id)."
-        }
-      },
-      additionalProperties: false,
-      required: [
-        "item_id"
-      ]
-    }
-  },
   "stocks.hot": {
     cliKey: "stocks.hot",
     cliName: "stocks hot",
@@ -2586,9 +2647,19 @@ L1/L2/L3（X5001 食品饮料 / X500102 白酒 等）。
         since_days: {
           type: "integer",
           minimum: 1,
-          maximum: 90,
+          maximum: 30,
           default: 7,
-          description: "Lookback window in days. (Translated to hours upstream.)"
+          description: "Rolling-feed lookback in days (≤30, translated to hours upstream). For longer history use from/to instead."
+        },
+        from: {
+          type: "string",
+          format: "date",
+          description: "History range start (China calendar date YYYY-MM-DD). When set, switches to range mode: requires a narrowing filter (security/institution/analyst); long history is capped at 365 days and is Pro-only (non-Pro silently clamped to 30 days)."
+        },
+        to: {
+          type: "string",
+          format: "date",
+          description: "History range end (inclusive, China date; defaults to today). Only used with from."
         },
         limit: {
           type: "integer",
@@ -2596,6 +2667,12 @@ L1/L2/L3（X5001 食品饮料 / X500102 白酒 等）。
           maximum: 100,
           default: 30,
           description: "Max items per page."
+        },
+        offset: {
+          type: "integer",
+          minimum: 0,
+          default: 0,
+          description: "Pagination offset (page through long history ranges)."
         }
       },
       additionalProperties: false
@@ -2677,6 +2754,10 @@ function buildCommandTree(program, dispatch) {
       const cmd = noun.command("feed");
       attachOperation(cmd, OPERATIONS["announcements.feed"], dispatch);
     }
+    {
+      const cmd = noun.command("search");
+      attachOperation(cmd, OPERATIONS["announcements.search"], dispatch);
+    }
     {
       const cmd = noun.command("stock");
       attachOperation(cmd, OPERATIONS["announcements.stock"], dispatch);
@@ -2821,6 +2902,10 @@ function buildCommandTree(program, dispatch) {
   {
     const noun = program.command("limit-up");
     noun.description("limit-up commands");
+    {
+      const cmd = noun.command("analysis");
+      attachOperation(cmd, OPERATIONS["limit-up.analysis"], dispatch);
+    }
     {
       const cmd = noun.command("history");
       attachOperation(cmd, OPERATIONS["limit-up.history"], dispatch);
@@ -2938,18 +3023,6 @@ function buildCommandTree(program, dispatch) {
       attachOperation(cmd, OPERATIONS["sentiment.turnover"], dispatch);
     }
   }
-  {
-    const noun = program.command("squawk");
-    noun.description("squawk commands");
-    {
-      const cmd = noun.command("audio");
-      attachOperation(cmd, OPERATIONS["squawk.audio"], dispatch);
-    }
-    {
-      const cmd = noun.command("waveform");
-      attachOperation(cmd, OPERATIONS["squawk.waveform"], dispatch);
-    }
-  }
   {
     const noun = program.command("stocks");
     noun.description("stocks commands");
@@ -3756,7 +3829,7 @@ import os2 from "node:os";
 import path2 from "node:path";
 
 // src/version.ts
-var CLI_VERSION = "2.4.0";
+var CLI_VERSION = "2.5.0";
 
 // src/runtime/update_check.ts
 var UPDATE_CACHE_PATH = path2.join(os2.homedir(), ".config", "echopai", "update_cache.json");
@@ -4583,6 +4656,32 @@ function buildQueryString3(params, method) {
 var CODE_RE = /^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/;
 var ISO_DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?$/;
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var announcementsSearchSpec = {
+  name: "announcements_search",
+  description: 'Hybrid search over A-share announcements (cninfo): mix Chinese company name / 6-digit code / free-text keyword in one query. Name or code → structured filter by stock; keyword → BM25 full-text (ParadeDB jieba over title + ai_summary + first 1500 chars of body), ranked by relevance × recency. Use when you DON\'T already have a canonical_code — e.g. "新华医疗 回购", "600587", or just "回购". For a known stock\'s full disclosure history prefer `announcements_stock`; for the market-wide recent feed prefer `announcements_feed`.',
+  inputSchema: {
+    q: z.string().min(1).max(100).describe('名称 / 代码 / 关键词，可混合（如 "新华医疗 回购"、"600587"、"回购"）'),
+    type: z.string().max(64).optional().describe("分类 slug 过滤（与 feed 同集合）"),
+    since_days: z.number().int().min(1).max(1825).default(90).describe("回看天数（1-1825，默认 90）"),
+    limit: z.number().int().min(1).max(200).default(50).describe("Max items (1-200, default 50)"),
+    offset: z.number().int().min(0).default(0).describe("Pagination offset")
+  },
+  handler: async (args, ctx) => {
+    const op = OPERATIONS["announcements.search"];
+    if (!op)
+      throw new Error("announcements.search op missing");
+    const callArgs = {
+      q: args.q,
+      since_days: args.since_days,
+      limit: args.limit,
+      offset: args.offset
+    };
+    if (args.type)
+      callArgs.type = args.type;
+    return callOp(op, callArgs, ctx);
+  },
+  backingOps: ["announcements.search"]
+};
 var announcementsFeedSpec = {
   name: "announcements_feed",
   description: "Recent A-share announcement feed (cninfo source, sorted by published_at desc). Filter by `type` slug (e.g. annual_report / equity_change / restructuring) or `since` lower bound. Use when surveying market-wide disclosures over a recent window — for a specific stock prefer `announcements_stock`.",
@@ -4659,7 +4758,27 @@ function clampInt(raw, min, max, fallback) {
   return n;
 }
 function buildAnnouncementsCommand() {
-  const cmd = new Command3("announcements").description("A-share announcements (cninfo) — recent feed, per-stock history, single-item detail.");
+  const cmd = new Command3("announcements").description("A-share announcements (cninfo) — hybrid search, recent feed, per-stock history, single-item detail.");
+  const search = cmd.command("search").description(announcementsSearchSpec.description);
+  search.addOption(new Option2("--q <text>", "名称 / 代码 / 关键词，可混合").makeOptionMandatory(true));
+  search.addOption(new Option2("--type <slug>", "Filter by 分类 slug"));
+  search.addOption(new Option2("--since-days <n>", "Lookback window in days (1-1825)").default("90"));
+  search.addOption(new Option2("--limit <n>", "Max items (1-200)").default("50"));
+  search.addOption(new Option2("--offset <n>", "Pagination offset").default("0"));
+  search.action(async (opts) => {
+    if (!OPERATIONS["announcements.search"]) {
+      emitVerbError("internal_error", "announcements.search missing", undefined, 2);
+    }
+    const args = {
+      q: opts.q,
+      since_days: clampInt(opts.sinceDays, 1, 1825, 90),
+      limit: clampInt(opts.limit, 1, 200, 50),
+      offset: Math.max(0, Math.floor(Number(opts.offset)) || 0)
+    };
+    if (opts.type)
+      args.type = opts.type;
+    await executeVerb(async (ctx) => announcementsSearchSpec.handler(args, ctx));
+  });
   const feed = cmd.command("feed").description(announcementsFeedSpec.description);
   feed.addOption(new Option2("--type <slug>", "Filter by 分类 slug (annual_report, equity_change, ...)"));
   feed.addOption(new Option2("--since <ISO-datetime>", "Lower bound published_at (RFC3339)"));
@@ -5178,7 +5297,7 @@ var digestSpec = {
   description: "One-shot research digest for a single security: fan-out across views (PRIMARY), quote, 14-field valuation snapshot (PE/PB/PS/turnover/dividend/volume-ratio), market sentiment, supplementary news, and ownership_events (last-30d insider holder trades + share repurchases, plus next-30d lockup expirations — structured corporate-action reinforcement). Returns separated buckets — does NOT rank views vs news for the agent. Partial failures surface in meta.partial_failures[] without poisoning successful buckets. Use as the agent's first call when asked 'what's going on with <stock>'. Works across A-share | HK | US: A-share returns all buckets, while HK/US (e.g. HK:00700, US:BABA) return only the views + news buckets — quote / valuation / sentiment / ownership are A-share-only and are skipped (not reported as failures). AH dual-listing: for an A+H listed company pass the A-share canonical (e.g. SSE:601398) for the full picture; use the HK code only if the user explicitly wants the HK side.",
   inputSchema: {
     code: z5.string().regex(CODE_REGEX).describe("Canonical code: A-share SSE:600519 | HK HK:00700 | US US:BABA. HK/US return only views+news. Use `lookup` first if you only have a name."),
-    views_since_days: z5.number().int().min(1).max(90).default(7).describe("Lookback for views bucket (days, default 7 — research horizon)"),
+    views_since_days: z5.number().int().min(1).max(30).default(7).describe("Lookback for views bucket (days, 1-30; views feed caps at 30d). For longer research history use the `views` verb's from/to."),
     news_hours: z5.number().int().min(1).max(168).default(24).describe("Lookback for news bucket (hours, default 24 — event horizon)"),
     limit_per_bucket: z5.number().int().min(1).max(50).default(10).describe("Per-bucket item cap (views/news). Quote/snapshot/sentiment aren't paginated here.")
   },
@@ -5391,7 +5510,7 @@ function clamp2(raw, min, max, fallback) {
 function buildDigestCommand() {
   const cmd = new Command7(digestSpec.name).description(digestSpec.description);
   cmd.addOption(new Option6("--code <canonical_code>", "Canonical code: SSE:600519 | HK:00700 | US:BABA (HK/US return only views+news)").makeOptionMandatory(true));
-  cmd.addOption(new Option6("--views-since-days <n>", "Views lookback in days (1-90)").default("7"));
+  cmd.addOption(new Option6("--views-since-days <n>", "Views lookback in days (1-30)").default("7"));
   cmd.addOption(new Option6("--news-hours <n>", "News lookback in hours (1-168)").default("24"));
   cmd.addOption(new Option6("--limit-per-bucket <n>", "Items per bucket (1-50)").default("10"));
   cmd.action(async (opts) => {
@@ -5400,7 +5519,7 @@ function buildDigestCommand() {
     }
     const args = {
       code: opts.code,
-      views_since_days: clamp2(opts.viewsSinceDays, 1, 90, 7),
+      views_since_days: clamp2(opts.viewsSinceDays, 1, 30, 7),
       news_hours: clamp2(opts.newsHours, 1, 168, 24),
       limit_per_bucket: clamp2(opts.limitPerBucket, 1, 50, 10)
     };
@@ -5771,8 +5890,25 @@ var limitUpHistorySpec = {
   },
   backingOps: ["limit-up.history"]
 };
+var limitUpAnalysisSpec = {
+  name: "limit_up_analysis",
+  description: "Per-stock limit-up LLM attribution for a given trade date: leading_concept (主导题材) + concept_tags (相关标签) + reason (涨停理由). Themes are judged by an LLM from the latest research / views / news (NOT from the concept graph, so brand-new themes are covered) and refreshed across 6 Beijing slots daily. Complements limit-up pool (which says '哪些票涨停'); this says '为什么涨停/属什么题材'. STALE-DATA WARNING: omitting trade_date returns the latest *attributed* trading day, NOT necessarily today — before today's first slot lands (~09:47 Beijing) it falls back to the PREVIOUS day's attribution. For today's data pass trade_date explicitly and verify the returned trade_date / generated_at fields. An explicit trade_date with no attribution yet returns an empty analyses list.",
+  inputSchema: {
+    trade_date: z8.string().regex(DATE_RE5).optional().describe("ISO date YYYY-MM-DD; omit for the latest *attributed* day (falls back to the previous day until today's first slot lands ~09:47 Beijing — pass today explicitly for today's data)")
+  },
+  handler: async (args, ctx) => {
+    const op = OPERATIONS["limit-up.analysis"];
+    if (!op)
+      throw new Error("limit-up.analysis op missing");
+    const callArgs = {};
+    if (args.trade_date)
+      callArgs.trade_date = args.trade_date;
+    return callOp(op, callArgs, ctx);
+  },
+  backingOps: ["limit-up.analysis"]
+};
 function buildLimitUpCommand() {
-  const cmd = new Command11("limit-up").description("A-share limit-up board — pool (per-stock detail) / summary (counts + ladder) / history (daily trend).");
+  const cmd = new Command11("limit-up").description("A-share limit-up board — pool (per-stock detail) / summary (counts + ladder) / history (daily trend) / analysis (LLM 题材归因).");
   const pool = cmd.command("pool").description(limitUpPoolSpec.description);
   pool.addOption(new Option9("--trade-date <YYYY-MM-DD>", "Trade date; omit for latest"));
   pool.addOption(new Option9("--include <s>", "active = 排除 ST/退市; all = 全部").choices([...INCLUDE_VALUES]).default("active"));
@@ -5809,6 +5945,17 @@ function buildLimitUpCommand() {
     }
     await executeVerb(async (ctx) => limitUpHistorySpec.handler({ days: clampInt5(opts.days, 1, 250, 30) }, ctx));
   });
+  const analysis = cmd.command("analysis").description(limitUpAnalysisSpec.description);
+  analysis.addOption(new Option9("--trade-date <YYYY-MM-DD>", "Trade date; omit for latest"));
+  analysis.action(async (opts) => {
+    if (!OPERATIONS["limit-up.analysis"]) {
+      emitVerbError("internal_error", "limit-up.analysis missing", undefined, 2);
+    }
+    const args = {};
+    if (opts.tradeDate)
+      args.trade_date = opts.tradeDate;
+    await executeVerb(async (ctx) => limitUpAnalysisSpec.handler(args, ctx));
+  });
   return cmd;
 }
 // src/verbs/lookup.ts
@@ -6019,29 +6166,46 @@ var newsSpec = {
   inputSchema: {
     code: z11.string().regex(/^((SSE|SZSE|BSE):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\-]{0,5})$/).optional().describe("Filter by security canonical_code (e.g. SSE:600519, HK:00700). Takes precedence over `query`."),
     query: z11.string().optional().describe("Free-text query (Chinese or English) matched against news content; omit for time-window feed. Do NOT pass canonical_code here — use `code` instead."),
-    hours: z11.number().int().min(1).max(168).default(24).describe("Lookback window in hours (default 24 — much narrower than views)"),
-    limit: z11.number().int().min(1).max(100).default(20).describe("Max items")
+    hours: z11.number().int().min(1).max(168).default(24).describe("Rolling-feed lookback in hours (default 24 — much narrower than views). For longer history use from/to with code or query."),
+    from: z11.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("History range start (China date YYYY-MM-DD). Range mode: needs code or query; Pro-only up to 365 days back."),
+    to: z11.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("History range end (inclusive, China date; defaults to today). Use with from."),
+    offset: z11.number().int().min(0).optional().describe("Pagination offset for paging through long history ranges."),
+    limit: z11.number().int().min(1).max(100).default(20).describe("Max items per page")
   },
   handler: async (args, ctx) => {
-    if (args.code) {
-      const op2 = OPERATIONS["news.list"];
-      if (!op2)
-        throw new Error("news.list op missing");
-      return callOp(op2, { security: args.code, since_hours: args.hours, limit: args.limit }, ctx);
-    }
-    if (args.query) {
-      const op2 = OPERATIONS["news.search"];
-      if (!op2)
-        throw new Error("news.search op missing");
-      return callOp(op2, { query: args.query, since_hours: args.hours, limit: args.limit }, ctx);
-    }
-    const op = OPERATIONS["news.feed"];
+    const { opKey, callArgs } = buildNewsCall(args);
+    const op = OPERATIONS[opKey];
     if (!op)
-      throw new Error("news.feed op missing");
-    return callOp(op, {}, ctx);
+      throw new Error(`${opKey} op missing`);
+    return callOp(op, callArgs, ctx);
   },
   backingOps: ["news.list", "news.search", "news.feed"]
 };
+function buildNewsCall(args) {
+  const hasRange = typeof args.from === "string" && args.from.length > 0;
+  const withWindow = (a) => {
+    if (typeof args.limit === "number")
+      a.limit = args.limit;
+    if (typeof args.offset === "number")
+      a.offset = args.offset;
+    if (hasRange) {
+      a.from = args.from;
+      if (typeof args.to === "string" && args.to.length > 0)
+        a.to = args.to;
+    } else {
+      a.since_hours = args.hours;
+    }
+    return a;
+  };
+  if (args.code)
+    return { opKey: "news.list", callArgs: withWindow({ security: args.code }) };
+  if (args.query)
+    return { opKey: "news.search", callArgs: withWindow({ query: args.query }) };
+  if (hasRange) {
+    throw new Error("range history (from/to) requires --code or --query; the bare feed has no narrowing filter");
+  }
+  return { opKey: "news.feed", callArgs: {} };
+}
 function clamp3(raw, min, max, fallback) {
   const n = Math.floor(Number(raw));
   if (!Number.isFinite(n))
@@ -6056,17 +6220,25 @@ function buildNewsCommand() {
   const cmd = new Command14(newsSpec.name).description(newsSpec.description);
   cmd.addOption(new Option12("--code <canonical_code>", "Filter by security canonical_code (A | HK | US, e.g. SSE:600519, HK:00700); takes precedence over --query"));
   cmd.addOption(new Option12("--query <text>", "Free-text query; omit for time-window feed"));
-  cmd.addOption(new Option12("--hours <n>", "Lookback window (1-168 hours)").default("24"));
+  cmd.addOption(new Option12("--hours <n>", "Rolling-feed lookback (1-168 hours)").default("24"));
+  cmd.addOption(new Option12("--from <date>", "History range start YYYY-MM-DD (range mode; needs --code or --query)"));
+  cmd.addOption(new Option12("--to <date>", "History range end YYYY-MM-DD (inclusive; default today)"));
+  cmd.addOption(new Option12("--offset <n>", "Pagination offset for long history").default("0"));
   cmd.addOption(new Option12("--limit <n>", "Max items").default("20"));
   cmd.action(async (opts) => {
     const args = {
       hours: clamp3(opts.hours, 1, 168, 24),
+      offset: clamp3(opts.offset, 0, 1e5, 0),
       limit: clamp3(opts.limit, 1, 100, 20)
     };
     if (opts.code)
       args.code = opts.code;
     if (opts.query)
       args.query = opts.query;
+    if (opts.from)
+      args.from = opts.from;
+    if (opts.to)
+      args.to = opts.to;
     await executeVerb(async (ctx) => newsSpec.handler(args, ctx));
   });
   return cmd;
@@ -6147,11 +6319,11 @@ import { Command as Command17, Option as Option15 } from "commander";
 import { z as z14 } from "zod";
 var searchSpec = {
   name: "search",
-  description: "HYBRID semantic search across analyst views + news (views weighted higher per feedback_views_over_news). Combines entity lookup (company codes, analyst names), pgvector kNN, trigram fuzzy and exact ILIKE; RRF-fused then reranked. Best for theme/concept queries: '锂电池' brings out 正极材料/碳酸锂/宁德时代; '芯片' brings out 存储芯片/洁净室/晶圆代工. Use `news` or `views` instead if you need strict time-window listing.",
+  description: "Structured-first hybrid search across analyst views + news (views weighted higher per feedback_views_over_news). Three lanes — entity (company codes / names, analyst names), concept-graph hub (theme alias → concept → constituents & research), and ParadeDB BM25 full-text (jieba) — fused with RRF. Deterministic & explainable: no vector kNN, no LLM rerank. Best for theme/concept queries: 'CPO' brings out 光模块/光通信/光芯片; '减肥药' brings out 创新药; '智驾' brings out 智能驾驶. Use `news` or `views` instead if you need strict time-window listing.",
   inputSchema: {
     q: z14.string().min(1).max(200).describe("Free-text query (Chinese or English)"),
     type: z14.enum(["news", "views", "all"]).default("all").describe("Search scope (views weighted higher in 'all')"),
-    mode: z14.enum(["hybrid", "exact"]).default("hybrid").describe("hybrid = semantic + concept expansion + rerank; exact = ILIKE only"),
+    mode: z14.enum(["hybrid", "exact"]).default("hybrid").describe("hybrid = entity + concept-graph + BM25 fused; exact = BM25 keyword only"),
     hours: z14.number().int().min(1).max(720).optional().describe("Lookback window in hours; omit for no time limit"),
     limit: z14.number().int().min(1).max(50).default(20).describe("Max items returned")
   },
@@ -6389,27 +6561,51 @@ var viewsSpec = {
     code: z16.string().regex(/^((SSE|SZSE|BSE):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\-]{0,5})$/).optional().describe("Filter by security canonical_code (e.g. SSE:600519, HK:00700, US:AAPL)"),
     analyst: z16.string().optional().describe("Analyst Chinese name (exact / fuzzy)"),
     institution: z16.string().optional().describe("Broker / institution Chinese name"),
-    since_days: z16.number().int().min(1).max(90).default(7).describe("Lookback window in days (research time-horizon is longer than news)"),
-    limit: z16.number().int().min(1).max(100).default(30).describe("Max items")
+    since_days: z16.number().int().min(1).max(365).default(7).describe("Lookback in days. ≤30 = rolling feed; >30 auto-switches to range history " + "(needs a code/analyst/institution filter; Pro-only up to 365). For an explicit window use from/to."),
+    from: z16.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("History range start (China date YYYY-MM-DD). Range mode: needs a filter; Pro-only up to 365 days back."),
+    to: z16.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("History range end (inclusive, China date; defaults to today). Use with from."),
+    offset: z16.number().int().min(0).optional().describe("Pagination offset for paging through long history ranges."),
+    limit: z16.number().int().min(1).max(100).default(30).describe("Max items per page")
   },
   handler: async (args, ctx) => {
     const op = OPERATIONS["views.recent"];
     if (!op)
       throw new Error("views.recent op missing from codegen");
-    const callArgs = {
-      since_days: args.since_days,
-      limit: args.limit
-    };
-    if (args.code)
-      callArgs.security = args.code;
-    if (args.analyst)
-      callArgs.analyst = args.analyst;
-    if (args.institution)
-      callArgs.institution = args.institution;
-    return callOp(op, callArgs, ctx);
+    return callOp(op, buildViewsCallArgs(args), ctx);
   },
   backingOps: ["views.recent"]
 };
+function buildViewsCallArgs(args) {
+  const hasFilter = Boolean(args.code || args.analyst || args.institution);
+  const sinceDays = typeof args.since_days === "number" ? args.since_days : 7;
+  const callArgs = {};
+  if (typeof args.limit === "number")
+    callArgs.limit = args.limit;
+  if (args.code)
+    callArgs.security = args.code;
+  if (args.analyst)
+    callArgs.analyst = args.analyst;
+  if (args.institution)
+    callArgs.institution = args.institution;
+  if (typeof args.offset === "number")
+    callArgs.offset = args.offset;
+  const explicitRange = typeof args.from === "string" && args.from.length > 0;
+  if (explicitRange || sinceDays > 30) {
+    if (!hasFilter) {
+      throw new Error("range history (from/to or since_days>30) requires a narrowing filter: --code / --analyst / --institution");
+    }
+    callArgs.from = explicitRange ? args.from : chinaDateMinusDays(sinceDays);
+    if (typeof args.to === "string" && args.to.length > 0)
+      callArgs.to = args.to;
+  } else {
+    callArgs.since_days = sinceDays;
+  }
+  return callArgs;
+}
+function chinaDateMinusDays(days) {
+  const chinaMs = Date.now() + 8 * 3600 * 1000 - days * 86400 * 1000;
+  return new Date(chinaMs).toISOString().slice(0, 10);
+}
 var reportSpec = {
   name: "report",
   description: "Fetch the FULL research-report text behind a view (mineru-parsed long-form), for when the `views` summary is not enough. Only works on views where `full_text_available=true` (gdrive sell-side reports). Two-step usage: default `format=outline` returns a few-KB heading map + total_chars + each heading's char_offset; then call `format=full` with `offset` (e.g. an outline char_offset) to read the body in pages — follow `next_offset` to page through large docs instead of pulling everything at once.",
@@ -6450,14 +6646,18 @@ function buildViewsCommand() {
   cmd.addOption(new Option17("--code <canonical_code>", "Filter by security canonical_code"));
   cmd.addOption(new Option17("--analyst <name>", "Analyst Chinese name (exact / fuzzy)"));
   cmd.addOption(new Option17("--institution <name>", "Broker / institution Chinese name"));
-  cmd.addOption(new Option17("--since-days <n>", "Lookback window (1-90 days)").default("7"));
+  cmd.addOption(new Option17("--since-days <n>", "Lookback days (1-365). ≤30 = feed; >30 = range history (needs a filter, Pro-only)").default("7"));
+  cmd.addOption(new Option17("--from <date>", "History range start YYYY-MM-DD (range mode; needs a filter)"));
+  cmd.addOption(new Option17("--to <date>", "History range end YYYY-MM-DD (inclusive; default today)"));
+  cmd.addOption(new Option17("--offset <n>", "Pagination offset for long history").default("0"));
   cmd.addOption(new Option17("--limit <n>", "Max items (1-100)").default("30"));
   cmd.action(async (opts) => {
     if (!OPERATIONS["views.recent"]) {
       emitVerbError("internal_error", "views.recent missing from codegen", undefined, 2);
     }
     const args = {
-      since_days: clamp5(opts.sinceDays, 1, 90, 7),
+      since_days: clamp5(opts.sinceDays, 1, 365, 7),
+      offset: clamp5(opts.offset, 0, 1e5, 0),
       limit: clamp5(opts.limit, 1, 100, 30)
     };
     if (opts.code)
@@ -6466,6 +6666,10 @@ function buildViewsCommand() {
       args.analyst = opts.analyst;
     if (opts.institution)
       args.institution = opts.institution;
+    if (opts.from)
+      args.from = opts.from;
+    if (opts.to)
+      args.to = opts.to;
     await executeVerb(async (ctx) => viewsSpec.handler(args, ctx));
   });
   return cmd;
@@ -6502,6 +6706,7 @@ var ALL_VERB_SPECS = [
   viewsSpec,
   reportSpec,
   newsSpec,
+  announcementsSearchSpec,
   announcementsFeedSpec,
   announcementsStockSpec,
   announcementsDetailSpec,
@@ -6523,6 +6728,7 @@ var ALL_VERB_SPECS = [
   limitUpPoolSpec,
   limitUpSummarySpec,
   limitUpHistorySpec,
+  limitUpAnalysisSpec,
   chartSpec,
   barsBatchSpec,
   scanSpec,
@@ -7347,6 +7553,11 @@ var HELP = {
     description: "A 股公告 feed，按 published_at 降序、同日按 cninfo source_id 降序。可按 type / since 过滤。需要 `announcements:read` scope。",
     example: "echopai announcements feed"
   },
+  "announcements.search": {
+    summary: "Hybrid search over A-share announcements",
+    description: "公告混合搜索：名称 / 代码做结构化过滤 + 关键词 BM25 全文（ParadeDB jieba，覆盖 title / ai_summary / content_md 前 1500 字）。q 含 6 位代码或内嵌 A 股名 → 按代码精确过滤；残余或纯文本 → BM25 按相关度×时间衰减排序；纯代码/名称则按 published_at 倒序列出。需要 `announcements:read` scope。",
+    example: "echopai announcements search --q 新华医疗 回购"
+  },
   "announcements.stock": {
     summary: "List announcements for a specific A-share security",
     description: "指定股票代码的公告列表（含历史窗口）。代码接受 6 位纯数字或 SSE:600519 / SZSE:000001 / BSE:430000 形式。需要 `announcements:read` scope。",
@@ -7521,6 +7732,11 @@ Phase 5.2 (server endpoint).
     description: "Mirrors `/v1/concepts/snapshot` contract (PR #442 review 二轮):\n\n- **With `codes=`** (per-key completeness): hot → warm → CH fallback\n  per industry; missing keys populated.\n- **Without `codes`** (best-effort dump): union of\n  `industry_snapshots:latest` and `industry_snapshots:last_close`\n  Redis hashes. Missing industries are **not** backfilled from CH; use\n  GET `/v1/industries` for a fully populated list.\n\n9:00–9:14 reset window suppresses both Redis hashes and CH fallback.\nEach item carries `_source` ∈ {`latest`, `last_close`, `ch_daily`}.\n申万一级 (level=1) ≈ 127 industries, 申万二级 (level=2) ≈ 348.\n",
     example: "echopai industries snapshot"
   },
+  "limit-up.analysis": {
+    summary: "A-share limit-up LLM attribution (per-stock leading theme + reason)",
+    description: '涨停股 LLM 归因：逐股「主导题材 leading_concept + 概念标签 concept_tags +\n涨停理由 reason」。题材由 LLM 依据最新研报 / 机构观点 / 快讯判定，**不依赖概念\n图谱**（可含图谱里还没有的全新题材），每交易日北京 9:45 / 11:00 / 12:30 / 14:00 /\n14:40 / 18:00 共 6 个时段自动刷新（后跑时段在前次基础上 refine）。\n\n与 `limit-up/pool` 互补：pool 给"涨停了哪些票"（行情数据，stockpulse 上游），\n本接口给"为什么涨停 / 属什么题材"（LLM 归因，echopai api 上游）。pool 里的\ngraph-based `leading_concept` 是另一条数据，本接口的 `leading_concept` 才是\nLLM 判定结果。\n\n⚠️ **trade_date 不传 = 库内最新「已归因」交易日**（非自然最新交易日）：归因每个\n时段按当时池快照写库，今日**首个时段（北京约 09:47）落库前**，不传 trade_date\n会返回**上一交易日**的归因（不是今日空结果）——agent 拿当日数据请显式传今日\ntrade_date 并以 `trade_date` / `generated_at` 字段核对时效。显式传某交易日而该日\n尚未归因时，`analyses` 为空。\n\n平面归属：本接口在 **vu 平面**（前端 apiFetch 同源），与 `market/status` 同款\n`x-audience: vu`；行情类 `limit-up/pool|summary|history` 在 sp 平面（前端 spFetch）。\n需要 `market:read` 或任一 `quote:*` scope。\n',
+    example: "echopai limit-up analysis"
+  },
   "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",
@@ -7649,16 +7865,6 @@ L1/L2/L3（X5001 食品饮料 / X500102 白酒 等）。
     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": {
-    summary: "Stream squawk TTS audio",
-    description: "返回 squawk 项的 TTS 音频（MP3）。直接 stream，可作为 `<audio>` src 用。",
-    example: "echopai squawk audio VALUE"
-  },
-  "squawk.waveform": {
-    summary: "Waveform peaks for squawk audio",
-    description: "返回 squawk 音频的预计算波形 peak 数据，用于客户端波形可视化。",
-    example: "echopai squawk waveform VALUE"
-  },
   "stocks.hot": {
     summary: "Today's hot-stock leaderboard",
     description: "今日最热股票榜（来源 East-Money），按搜索 / 关注 / 评论综合分排序。",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "echopai",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Command-line interface for the EchoPai Open Platform: stock-market data, news, analyst views, sentiment, signals, backtests.",
   "license": "MIT",
   "homepage": "https://echopai.com",