echopai 2.5.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",
@@ -2694,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);
@@ -4592,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`.",
@@ -4668,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)"));
@@ -6209,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")
   },
@@ -6596,6 +6706,7 @@ var ALL_VERB_SPECS = [
   viewsSpec,
   reportSpec,
   newsSpec,
+  announcementsSearchSpec,
   announcementsFeedSpec,
   announcementsStockSpec,
   announcementsDetailSpec,
@@ -7442,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。",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "echopai",
-  "version": "2.5.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",