echopai 2.5.0 → 2.6.1

package/dist/bin.js

@@ -2,8 +2,7 @@
 
 // src/bin.ts
 import { spawn } from "node:child_process";
-import { existsSync as existsSync4 } from "node:fs";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { fileURLToPath } from "node:url";
 import { Command as Command31, Option as Option23 } from "commander";
 
 // src/_generated/commands.ts
@@ -229,6 +228,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 +2753,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);
@@ -2993,6 +3056,137 @@ function buildCommandTree(program, dispatch) {
   }
 }
 
+// src/runtime/dist.ts
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+var RELEASE_BASE = process.env.ECHOPAI_RELEASE_BASE?.replace(/\/+$/, "") || "https://downloads.echopai.com/echopai-cli-releases";
+var VERSION_RE = /^[0-9]+\.[0-9]+\.[0-9]+(-\S+)?$/;
+var SHA256_RE = /^[a-f0-9]{64}$/;
+var FETCH_TIMEOUT_MS = 8000;
+function isStandaloneFromUrl(url) {
+  return url.includes("$bunfs") || url.includes("~BUN");
+}
+function isStandaloneBinary() {
+  return isStandaloneFromUrl(import.meta.url);
+}
+function computePlatformKey(i) {
+  let arch = i.arch === "x64" || i.arch === "amd64" ? "x64" : i.arch === "arm64" ? "arm64" : null;
+  if (!arch)
+    return null;
+  if (i.platform === "darwin") {
+    if (arch === "x64" && i.isRosetta)
+      arch = "arm64";
+    return `darwin-${arch}`;
+  }
+  if (i.platform === "win32") {
+    return arch === "x64" ? "windows-x64" : null;
+  }
+  if (i.platform === "linux") {
+    if (arch === "x64") {
+      if (i.isMusl)
+        return "linux-x64-musl";
+      return i.hasAvx2 ? "linux-x64" : "linux-x64-baseline";
+    }
+    return i.isMusl ? "linux-arm64-musl" : "linux-arm64";
+  }
+  return null;
+}
+function detectMusl() {
+  return existsSync("/lib/libc.musl-x86_64.so.1") || existsSync("/lib/libc.musl-aarch64.so.1");
+}
+function detectAvx2() {
+  try {
+    return /\bavx2\b/.test(readFileSync("/proc/cpuinfo", "utf8"));
+  } catch {
+    return false;
+  }
+}
+function detectRosetta() {
+  try {
+    const r = spawnSync("sysctl", ["-n", "sysctl.proc_translated"], {
+      encoding: "utf8",
+      timeout: 1000
+    });
+    return r.stdout.trim() === "1";
+  } catch {
+    return false;
+  }
+}
+function detectPlatformKey() {
+  return computePlatformKey({
+    platform: process.platform,
+    arch: process.arch,
+    isMusl: process.platform === "linux" ? detectMusl() : false,
+    hasAvx2: process.platform === "linux" && process.arch === "x64" ? detectAvx2() : true,
+    isRosetta: process.platform === "darwin" && process.arch === "x64" ? detectRosetta() : false
+  });
+}
+function parseManifestChecksum(manifest, platform) {
+  if (!manifest || typeof manifest !== "object")
+    return null;
+  const platforms = manifest.platforms;
+  if (!platforms || typeof platforms !== "object")
+    return null;
+  const entry = platforms[platform];
+  if (!entry || typeof entry !== "object")
+    return null;
+  const cs = entry.checksum;
+  return typeof cs === "string" && SHA256_RE.test(cs) ? cs : null;
+}
+async function fetchText(url) {
+  const ac = new AbortController;
+  const timer = setTimeout(() => ac.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(url, { signal: ac.signal });
+    if (!res.ok)
+      return null;
+    return await res.text();
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function resolveLatestFromCdn() {
+  const txt = await fetchText(`${RELEASE_BASE}/latest`);
+  if (txt == null)
+    return null;
+  const v = txt.trim();
+  return VERSION_RE.test(v) ? v : null;
+}
+async function fetchManifest(version) {
+  const txt = await fetchText(`${RELEASE_BASE}/${version}/manifest.json`);
+  if (txt == null)
+    return null;
+  try {
+    return JSON.parse(txt);
+  } catch {
+    return null;
+  }
+}
+function binaryUrl(version, platform) {
+  const name = platform.startsWith("windows-") ? "echopai.exe" : "echopai";
+  return `${RELEASE_BASE}/${version}/${platform}/${name}`;
+}
+async function downloadAndVerify(url, expectedSha) {
+  const ac = new AbortController;
+  const timer = setTimeout(() => ac.abort(), FETCH_TIMEOUT_MS * 4);
+  try {
+    const res = await fetch(url, { signal: ac.signal });
+    if (!res.ok)
+      throw new Error(`下载失败 HTTP ${res.status}: ${url}`);
+    const buf = Buffer.from(await res.arrayBuffer());
+    const actual = createHash("sha256").update(buf).digest("hex");
+    if (actual !== expectedSha) {
+      throw new Error(`校验和不匹配（期望 ${expectedSha}，实际 ${actual}）`);
+    }
+    return buf;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
 // src/runtime/invoker.ts
 import AjvPkg from "ajv";
 import addFormatsPkg from "ajv-formats";
@@ -3499,9 +3693,9 @@ function resolveRequestId(serverHeader, clientGenerated) {
 // src/runtime/trace.ts
 import {
   appendFileSync,
-  existsSync as existsSync2,
+  existsSync as existsSync3,
   mkdirSync as mkdirSync2,
-  readFileSync as readFileSync2,
+  readFileSync as readFileSync3,
   renameSync,
   statSync
 } from "node:fs";
@@ -3522,7 +3716,7 @@ function appendTrace(record, opts) {
   const maxBytes = opts?.ringMaxBytes ?? RING_MAX_BYTES;
   try {
     mkdirSync2(dirname(file), { recursive: true });
-    if (existsSync2(file)) {
+    if (existsSync3(file)) {
       const size = statSync(file).size;
       if (size >= maxBytes) {
         renameSync(file, file + ".1");
@@ -3534,9 +3728,9 @@ function appendTrace(record, opts) {
 }
 function readNdjsonLines(file) {
   try {
-    if (!existsSync2(file))
+    if (!existsSync3(file))
       return [];
-    const raw = readFileSync2(file, "utf-8");
+    const raw = readFileSync3(file, "utf-8");
     const out = [];
     for (const line of raw.split(`
 `)) {
@@ -3760,12 +3954,12 @@ function renderError(env) {
 }
 
 // src/runtime/update_check.ts
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync3, renameSync as renameSync2 } from "node:fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync2, mkdirSync as mkdirSync3, renameSync as renameSync2 } from "node:fs";
 import os2 from "node:os";
 import path2 from "node:path";
 
 // src/version.ts
-var CLI_VERSION = "2.5.0";
+var CLI_VERSION = "2.6.1";
 
 // src/runtime/update_check.ts
 var UPDATE_CACHE_PATH = path2.join(os2.homedir(), ".config", "echopai", "update_cache.json");
@@ -3800,7 +3994,7 @@ function isNewer(latest, current) {
 }
 function readCachedUpdate() {
   try {
-    const raw = readFileSync3(UPDATE_CACHE_PATH, "utf-8");
+    const raw = readFileSync4(UPDATE_CACHE_PATH, "utf-8");
     const obj = JSON.parse(raw);
     if (typeof obj.checked_at === "string" && typeof obj.current === "string" && typeof obj.latest === "string") {
       return obj;
@@ -4215,139 +4409,6 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { Command as Command20, Option as Option18 } from "commander";
 
-// src/runtime/dist.ts
-import { spawnSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";
-import { fileURLToPath } from "node:url";
-var RELEASE_BASE = process.env.ECHOPAI_RELEASE_BASE?.replace(/\/+$/, "") || "https://downloads.echopai.com/echopai-cli-releases";
-var VERSION_RE = /^[0-9]+\.[0-9]+\.[0-9]+(-\S+)?$/;
-var SHA256_RE = /^[a-f0-9]{64}$/;
-var FETCH_TIMEOUT_MS = 8000;
-function isStandaloneBinary() {
-  try {
-    return !existsSync3(fileURLToPath(import.meta.url));
-  } catch {
-    return true;
-  }
-}
-function computePlatformKey(i) {
-  let arch = i.arch === "x64" || i.arch === "amd64" ? "x64" : i.arch === "arm64" ? "arm64" : null;
-  if (!arch)
-    return null;
-  if (i.platform === "darwin") {
-    if (arch === "x64" && i.isRosetta)
-      arch = "arm64";
-    return `darwin-${arch}`;
-  }
-  if (i.platform === "win32") {
-    return arch === "x64" ? "windows-x64" : null;
-  }
-  if (i.platform === "linux") {
-    if (arch === "x64") {
-      if (i.isMusl)
-        return "linux-x64-musl";
-      return i.hasAvx2 ? "linux-x64" : "linux-x64-baseline";
-    }
-    return i.isMusl ? "linux-arm64-musl" : "linux-arm64";
-  }
-  return null;
-}
-function detectMusl() {
-  return existsSync3("/lib/libc.musl-x86_64.so.1") || existsSync3("/lib/libc.musl-aarch64.so.1");
-}
-function detectAvx2() {
-  try {
-    return /\bavx2\b/.test(readFileSync4("/proc/cpuinfo", "utf8"));
-  } catch {
-    return false;
-  }
-}
-function detectRosetta() {
-  try {
-    const r = spawnSync("sysctl", ["-n", "sysctl.proc_translated"], {
-      encoding: "utf8",
-      timeout: 1000
-    });
-    return r.stdout.trim() === "1";
-  } catch {
-    return false;
-  }
-}
-function detectPlatformKey() {
-  return computePlatformKey({
-    platform: process.platform,
-    arch: process.arch,
-    isMusl: process.platform === "linux" ? detectMusl() : false,
-    hasAvx2: process.platform === "linux" && process.arch === "x64" ? detectAvx2() : true,
-    isRosetta: process.platform === "darwin" && process.arch === "x64" ? detectRosetta() : false
-  });
-}
-function parseManifestChecksum(manifest, platform) {
-  if (!manifest || typeof manifest !== "object")
-    return null;
-  const platforms = manifest.platforms;
-  if (!platforms || typeof platforms !== "object")
-    return null;
-  const entry = platforms[platform];
-  if (!entry || typeof entry !== "object")
-    return null;
-  const cs = entry.checksum;
-  return typeof cs === "string" && SHA256_RE.test(cs) ? cs : null;
-}
-async function fetchText(url) {
-  const ac = new AbortController;
-  const timer = setTimeout(() => ac.abort(), FETCH_TIMEOUT_MS);
-  try {
-    const res = await fetch(url, { signal: ac.signal });
-    if (!res.ok)
-      return null;
-    return await res.text();
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-async function resolveLatestFromCdn() {
-  const txt = await fetchText(`${RELEASE_BASE}/latest`);
-  if (txt == null)
-    return null;
-  const v = txt.trim();
-  return VERSION_RE.test(v) ? v : null;
-}
-async function fetchManifest(version) {
-  const txt = await fetchText(`${RELEASE_BASE}/${version}/manifest.json`);
-  if (txt == null)
-    return null;
-  try {
-    return JSON.parse(txt);
-  } catch {
-    return null;
-  }
-}
-function binaryUrl(version, platform) {
-  const name = platform.startsWith("windows-") ? "echopai.exe" : "echopai";
-  return `${RELEASE_BASE}/${version}/${platform}/${name}`;
-}
-async function downloadAndVerify(url, expectedSha) {
-  const ac = new AbortController;
-  const timer = setTimeout(() => ac.abort(), FETCH_TIMEOUT_MS * 4);
-  try {
-    const res = await fetch(url, { signal: ac.signal });
-    if (!res.ok)
-      throw new Error(`下载失败 HTTP ${res.status}: ${url}`);
-    const buf = Buffer.from(await res.arrayBuffer());
-    const actual = createHash("sha256").update(buf).digest("hex");
-    if (actual !== expectedSha) {
-      throw new Error(`校验和不匹配（期望 ${expectedSha}，实际 ${actual}）`);
-    }
-    return buf;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
 // src/runtime/whoami_cache.ts
 var DEFAULT_TTL_MS = 5 * 60 * 1000;
 var cache = null;
@@ -4592,6 +4653,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 +4755,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 +6316,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 +6703,7 @@ var ALL_VERB_SPECS = [
   viewsSpec,
   reportSpec,
   newsSpec,
+  announcementsSearchSpec,
   announcementsFeedSpec,
   announcementsStockSpec,
   announcementsDetailSpec,
@@ -7442,6 +7550,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。",
@@ -8279,15 +8392,14 @@ if (process.env._ECHOPAI_UPDATE_WORKER === "1") {
 try {
   const optedOut = process.env.CI || process.env.ECHOPAI_DISABLE_UPDATE_CHECK || !process.stderr.isTTY;
   if (!optedOut && !process.env._ECHOPAI_UPDATE_WORKER) {
-    let scriptPath;
-    try {
-      const p = fileURLToPath2(import.meta.url);
-      if (existsSync4(p))
-        scriptPath = p;
-    } catch {
-      scriptPath = undefined;
+    let reexecArgs = [];
+    if (!isStandaloneBinary()) {
+      try {
+        reexecArgs = [fileURLToPath(import.meta.url)];
+      } catch {
+        reexecArgs = [];
+      }
     }
-    const reexecArgs = scriptPath ? [scriptPath] : [];
     const child = spawn(process.execPath, reexecArgs, {
       detached: true,
       stdio: "ignore",

package/package.json

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