echopai 2.2.0 → 2.3.0

package/dist/verbs/announcements.js

@@ -0,0 +1,195 @@
+/**
+ * `echopai announcements ...` + MCP tools `announcements_feed` /
+ * `announcements_stock` / `announcements_detail`.
+ *
+ * A 股公告 (cninfo 主源)：
+ *   - feed    —— 全市场最近公告，按 published_at desc
+ *   - stock   —— 指定 canonical_code 的公告历史窗口（最长 5 年）
+ *   - detail  —— 单条公告完整正文（content_md + content_text + meta）
+ *
+ * 三个 op 共享 `announcements:read` scope，calling 协议参数与底层 OpenAPI
+ * 一致（type slug / since_days 等）。MCP 注册成三个 discrete tool，AI agent
+ * 可按 "我要看 X 的财报披露" / "今天市场公告" / "把这条公告全文给我" 各自取用。
+ */
+import { Command, Option } from "commander";
+import { z } from "zod";
+import { OPERATIONS } from "../_generated/operations.js";
+import { executeVerb, emitVerbError } from "../runtime/verb_cmd.js";
+import { callOp } from "../runtime/verb_runner.js";
+const CODE_RE = /^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/;
+const ISO_DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?$/;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export const 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`.",
+    inputSchema: {
+        type: z
+            .string()
+            .max(64)
+            .optional()
+            .describe("分类 slug 过滤（如 annual_report / equity_change / restructuring）。"),
+        since: z
+            .string()
+            .regex(ISO_DATETIME_RE)
+            .optional()
+            .describe("ISO datetime 下限（published_at >= since）。"),
+        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.feed"];
+        if (!op)
+            throw new Error("announcements.feed op missing");
+        const callArgs = {
+            limit: args.limit,
+            offset: args.offset,
+        };
+        if (args.type)
+            callArgs.type = args.type;
+        if (args.since)
+            callArgs.since = args.since;
+        return callOp(op, callArgs, ctx);
+    },
+    backingOps: ["announcements.feed"],
+};
+export const announcementsStockSpec = {
+    name: "announcements_stock",
+    description: "Announcement history for a single A-share security (cninfo). Default lookback 30 days, max 5 years. AH dual-listing: pass the A-share canonical (announcements are A-share only — HK side has separate HKEX disclosures not covered here).",
+    inputSchema: {
+        code: z
+            .string()
+            .regex(CODE_RE)
+            .describe("A-share canonical code (e.g. SSE:600519)"),
+        since_days: z
+            .number()
+            .int()
+            .min(1)
+            .max(1825)
+            .default(30)
+            .describe("Lookback window in days (1-1825, default 30)"),
+        type: z
+            .string()
+            .max(64)
+            .optional()
+            .describe("分类 slug 过滤（与 feed 同集合）"),
+        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.stock"];
+        if (!op)
+            throw new Error("announcements.stock op missing");
+        const callArgs = {
+            code: args.code,
+            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.stock"],
+};
+export const announcementsDetailSpec = {
+    name: "announcements_detail",
+    description: "Fetch one announcement by id (UUID from feed/stock items[].id). Returns full content_md + content_text + cninfo meta + parse status. Use when the summary in feed/stock is not enough and you need the full document body for citation or NLP.",
+    inputSchema: {
+        announcement_id: z
+            .string()
+            .regex(UUID_RE)
+            .describe("UUID (feed / stock 返回的 items[].id)"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["announcements.detail"];
+        if (!op)
+            throw new Error("announcements.detail op missing");
+        return callOp(op, { announcement_id: args.announcement_id }, ctx);
+    },
+    backingOps: ["announcements.detail"],
+};
+function clampInt(raw, min, max, fallback) {
+    const n = Math.floor(Number(raw));
+    if (!Number.isFinite(n))
+        return fallback;
+    if (n < min)
+        return min;
+    if (n > max)
+        return max;
+    return n;
+}
+export function buildAnnouncementsCommand() {
+    const cmd = new Command("announcements").description("A-share announcements (cninfo) — recent feed, per-stock history, single-item detail.");
+    const feed = cmd.command("feed").description(announcementsFeedSpec.description);
+    feed.addOption(new Option("--type <slug>", "Filter by 分类 slug (annual_report, equity_change, ...)"));
+    feed.addOption(new Option("--since <ISO-datetime>", "Lower bound published_at (RFC3339)"));
+    feed.addOption(new Option("--limit <n>", "Max items (1-200)").default("50"));
+    feed.addOption(new Option("--offset <n>", "Pagination offset").default("0"));
+    feed.action(async (opts) => {
+        if (!OPERATIONS["announcements.feed"]) {
+            emitVerbError("internal_error", "announcements.feed missing", undefined, 2);
+        }
+        const args = {
+            limit: clampInt(opts.limit, 1, 200, 50),
+            offset: Math.max(0, Math.floor(Number(opts.offset)) || 0),
+        };
+        if (opts.type)
+            args.type = opts.type;
+        if (opts.since)
+            args.since = opts.since;
+        await executeVerb(async (ctx) => announcementsFeedSpec.handler(args, ctx));
+    });
+    const stock = cmd.command("stock").description(announcementsStockSpec.description);
+    stock.addOption(new Option("--code <canonical_code>", "A-share canonical (e.g. SSE:600519)")
+        .makeOptionMandatory(true));
+    stock.addOption(new Option("--since-days <n>", "Lookback window in days (1-1825)").default("30"));
+    stock.addOption(new Option("--type <slug>", "Filter by 分类 slug"));
+    stock.addOption(new Option("--limit <n>", "Max items (1-200)").default("50"));
+    stock.addOption(new Option("--offset <n>", "Pagination offset").default("0"));
+    stock.action(async (opts) => {
+        if (!OPERATIONS["announcements.stock"]) {
+            emitVerbError("internal_error", "announcements.stock missing", undefined, 2);
+        }
+        const args = {
+            code: opts.code,
+            since_days: clampInt(opts.sinceDays, 1, 1825, 30),
+            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) => announcementsStockSpec.handler(args, ctx));
+    });
+    const detail = cmd
+        .command("detail <announcement_id>")
+        .description(announcementsDetailSpec.description);
+    detail.action(async (announcementId) => {
+        if (!OPERATIONS["announcements.detail"]) {
+            emitVerbError("internal_error", "announcements.detail missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => announcementsDetailSpec.handler({ announcement_id: announcementId }, ctx));
+    });
+    return cmd;
+}

package/dist/verbs/concepts.js

@@ -0,0 +1,393 @@
+/**
+ * `echopai concepts ...` + MCP tools for the concept-index family.
+ *
+ * Concept = THS / DC / 自定义 概念板块。所有指数采用 PLAN_CONCEPT_INDUSTRY_QUOTE
+ * §5.4 链式等权计算（base 1000）。9 个子端点：
+ *
+ *   list             —— 全量概念元数据 + 6 字段实时快照（默认 active）
+ *   snapshot         —— 全量 Redis snapshot hash（可 codes= 过滤）
+ *   show             —— 单个概念 meta + 当前成份股 + 个股最新行情
+ *   alerts           —— 当前激活的概念异动（big_move / limit_up_cluster）
+ *   alerts-history   —— 24h 异动历史（可按 rule / 时窗过滤）
+ *   daily-bars       —— 概念指数日 K（链式等权）
+ *   minute-bars      —— 概念指数分钟 K（max 7 天/请求）
+ *   news             —— 与概念名匹配的相关新闻
+ *   views            —— 关联券商观点（concept_views × broker_views JOIN）
+ *
+ * MCP 注册为 9 个 discrete tool；CLI 收纳到单个 `concepts` noun 下子命令。
+ */
+import { Command, Option } from "commander";
+import { z } from "zod";
+import { OPERATIONS } from "../_generated/operations.js";
+import { executeVerb, emitVerbError } from "../runtime/verb_cmd.js";
+import { callOp } from "../runtime/verb_runner.js";
+const STATUS_VALUES = ["active", "pending_review", "deprecated"];
+// Server-supported sort keys (stockpulse-rs concepts.rs sort_by chain).
+const SERVER_SORT_VALUES = ["pct", "amount", "limit_up", "stock_count"];
+// Client-side sort keys — fetched with server sort=pct (any), then re-sorted
+// over the live snapshot fields returned per item. 涨速 (`speed_3min`) /
+// 换手率 (no per-concept turnover; here it means 个股层面 turnover_rate
+// aggregate is not present — `turnover` is alias of `amount`).
+const CLIENT_SORT_VALUES = ["speed"];
+const SORT_VALUES = [...SERVER_SORT_VALUES, ...CLIENT_SORT_VALUES];
+const RULE_VALUES = ["big_move", "limit_up_cluster"];
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function clampInt(raw, min, max, fallback) {
+    const n = Math.floor(Number(raw));
+    if (!Number.isFinite(n))
+        return fallback;
+    if (n < min)
+        return min;
+    if (n > max)
+        return max;
+    return n;
+}
+function parseConceptId(raw) {
+    const n = Math.floor(Number(raw));
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new Error(`concept_id must be a positive integer (got ${raw})`);
+    }
+    return n;
+}
+export const conceptsListSpec = {
+    name: "concepts_list",
+    description: "List concepts with live 6-field snapshot (pct_change / index_value / up_count / down_count / limit_up_count / amount / speed_3min) joined from Redis. Default sort by pct (desc). Use as the entry point for browsing the concept universe — narrow down by sort and pick top movers, then drill in with `concepts_show` / `concepts_daily_bars`. Sort keys: `pct` / `amount` / `limit_up` / `stock_count` are pushed to the server; `speed` is applied client-side over `speed_3min` (3-minute pct delta).",
+    inputSchema: {
+        status: z.enum(STATUS_VALUES).default("active").describe("Concept status filter"),
+        sort: z
+            .enum(SORT_VALUES)
+            .default("pct")
+            .describe("Sort field: pct / amount / limit_up / stock_count / speed"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .default(500)
+            .describe("Max items (1-1000, default 500)"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["concepts.list"];
+        if (!op)
+            throw new Error("concepts.list op missing");
+        const sort = String(args.sort ?? "pct");
+        const isClientSort = CLIENT_SORT_VALUES.includes(sort);
+        // Client-side sort: fetch the full universe (server max 1000) so the
+        // re-rank sees every concept, then slice to user-requested `limit`.
+        // Server-side sort: pass-through (server enforces limit honestly).
+        const serverArgs = {
+            status: args.status,
+            sort: isClientSort ? "pct" : sort,
+            limit: isClientSort ? 1000 : args.limit,
+        };
+        const env = await callOp(op, serverArgs, ctx);
+        if (!isClientSort)
+            return env;
+        return resortListEnvelopeBySpeed(env, Number(args.limit ?? 500));
+    },
+    backingOps: ["concepts.list"],
+};
+function resortListEnvelopeBySpeed(env, limit) {
+    const body = env.data;
+    if (!body || typeof body !== "object" || !Array.isArray(body.items)) {
+        return env;
+    }
+    const items = body.items.slice();
+    items.sort((a, b) => {
+        const av = numericOrNeg(a.speed_3min);
+        const bv = numericOrNeg(b.speed_3min);
+        return bv - av;
+    });
+    const sliced = items.slice(0, Math.max(1, Math.floor(limit)));
+    const data = { ...body, items: sliced };
+    const meta = { ...(env.meta ?? {}), client_sort: "speed" };
+    return { data, meta };
+}
+function numericOrNeg(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return v;
+    if (typeof v === "string") {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return Number.NEGATIVE_INFINITY;
+}
+export const conceptsSnapshotSpec = {
+    name: "concepts_snapshot",
+    description: "Bulk Redis snapshot of all concepts. Use `codes` (comma-separated concept_id list) to filter; omit for the full set. Cheaper than `concepts_list` when only the live numbers are needed without joining meta.",
+    inputSchema: {
+        codes: z
+            .string()
+            .optional()
+            .describe("Comma-separated concept_id list (e.g. `1,2,3`); omit for all."),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["concepts.snapshot"];
+        if (!op)
+            throw new Error("concepts.snapshot op missing");
+        const callArgs = {};
+        if (args.codes)
+            callArgs.codes = args.codes;
+        return callOp(op, callArgs, ctx);
+    },
+    backingOps: ["concepts.snapshot"],
+};
+export const conceptsShowSpec = {
+    name: "concepts_show",
+    description: "Detail for one concept: meta (full_name / source / status / approved_at / first_listed_at) plus current member securities with their latest snapshots. Use after `concepts_list` to inspect a specific theme.",
+    inputSchema: {
+        concept_id: z.number().int().positive().describe("Concept primary key (PG concepts.id)"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["concepts.show"];
+        if (!op)
+            throw new Error("concepts.show op missing");
+        return callOp(op, { concept_id: args.concept_id }, ctx);
+    },
+    backingOps: ["concepts.show"],
+};
+export const conceptsAlertsSpec = {
+    name: "concepts_alerts",
+    description: "Currently active concept alerts. Two rules: `big_move` (|pct_change| > 3%) and `limit_up_cluster` (limit_up_count >= 3 AND stock_count >= 5). Cheap, non-billable. Use as the agent's signal for 'which themes are running hot right now'.",
+    inputSchema: {},
+    handler: async (_args, ctx) => {
+        const op = OPERATIONS["concepts.alerts"];
+        if (!op)
+            throw new Error("concepts.alerts op missing");
+        return callOp(op, {}, ctx);
+    },
+    backingOps: ["concepts.alerts"],
+};
+export const conceptsAlertsHistorySpec = {
+    name: "concepts_alerts_history",
+    description: "Concept-alert historical events (default last 24h). Filter by `rule` (big_move / limit_up_cluster) and Unix-ms `from`/`to` window. Used by AI agent / admin to review what fired and when.",
+    inputSchema: {
+        from: z
+            .number()
+            .int()
+            .optional()
+            .describe("Unix ms; default = now - 24h"),
+        to: z.number().int().optional().describe("Unix ms; default = now"),
+        rule: z.enum(RULE_VALUES).optional().describe("Filter by alert rule"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(2000)
+            .default(500)
+            .describe("Max items (1-2000, default 500)"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["concepts.alerts-history"];
+        if (!op)
+            throw new Error("concepts.alerts-history op missing");
+        const callArgs = { limit: args.limit };
+        if (args.from !== undefined)
+            callArgs.from = args.from;
+        if (args.to !== undefined)
+            callArgs.to = args.to;
+        if (args.rule)
+            callArgs.rule = args.rule;
+        return callOp(op, callArgs, ctx);
+    },
+    backingOps: ["concepts.alerts-history"],
+};
+export const conceptsDailyBarsSpec = {
+    name: "concepts_daily_bars",
+    description: "Daily OHLC for a concept index (chain-linked equal-weight, base 1000). Returns breadth fields and `is_backfilled` flag. Requires `bars:read` scope.",
+    inputSchema: {
+        concept_id: z.number().int().positive().describe("Concept primary key"),
+        from: z.string().regex(DATE_RE).describe("Inclusive start date YYYY-MM-DD"),
+        to: z.string().regex(DATE_RE).describe("Inclusive end date YYYY-MM-DD"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["concepts.daily-bars"];
+        if (!op)
+            throw new Error("concepts.daily-bars op missing");
+        return callOp(op, { concept_id: args.concept_id, from: args.from, to: args.to }, ctx);
+    },
+    backingOps: ["concepts.daily-bars"],
+};
+export const conceptsMinuteBarsSpec = {
+    name: "concepts_minute_bars",
+    description: "Concept-index minute-level OHLC (chain-linked equal-weight, base 1000). Max 7 days per request. Requires `bars:read` scope.",
+    inputSchema: {
+        concept_id: z.number().int().positive().describe("Concept primary key"),
+        from: z.string().regex(DATE_RE).describe("Inclusive start date YYYY-MM-DD"),
+        to: z.string().regex(DATE_RE).describe("Inclusive end date YYYY-MM-DD (max 7 days)"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["concepts.minute-bars"];
+        if (!op)
+            throw new Error("concepts.minute-bars op missing");
+        return callOp(op, { concept_id: args.concept_id, from: args.from, to: args.to }, ctx);
+    },
+    backingOps: ["concepts.minute-bars"],
+};
+export const conceptsNewsSpec = {
+    name: "concepts_news",
+    description: "Recent news mentioning the concept name (ILIKE on news.title + content). Short-term implementation; long-term will switch to AI tagging. Requires `news:read` scope.",
+    inputSchema: {
+        concept_id: z.number().int().positive().describe("Concept primary key"),
+        days: z
+            .number()
+            .int()
+            .min(1)
+            .max(365)
+            .default(30)
+            .describe("Lookback window in days (1-365, default 30)"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .default(50)
+            .describe("Max items (1-200, default 50)"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["concepts.news"];
+        if (!op)
+            throw new Error("concepts.news op missing");
+        return callOp(op, { concept_id: args.concept_id, days: args.days, limit: args.limit }, ctx);
+    },
+    backingOps: ["concepts.news"],
+};
+export const conceptsViewsSpec = {
+    name: "concepts_views",
+    description: "Broker views associated with a concept (concept_views × broker_views, ai_status=done), sorted by published_at desc. Primary research source for a theme. Requires `views:read` scope.",
+    inputSchema: {
+        concept_id: z.number().int().positive().describe("Concept primary key"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .default(50)
+            .describe("Max items (1-200, default 50)"),
+    },
+    handler: async (args, ctx) => {
+        const op = OPERATIONS["concepts.views"];
+        if (!op)
+            throw new Error("concepts.views op missing");
+        return callOp(op, { concept_id: args.concept_id, limit: args.limit }, ctx);
+    },
+    backingOps: ["concepts.views"],
+};
+export function buildConceptsCommand() {
+    const cmd = new Command("concepts").description("Concept indices — list / snapshot / show / alerts / alerts-history / daily-bars / minute-bars / news / views.");
+    const list = cmd.command("list").description(conceptsListSpec.description);
+    list.addOption(new Option("--status <s>", "Status filter").choices([...STATUS_VALUES]).default("active"));
+    list.addOption(new Option("--sort <field>", "Sort field").choices([...SORT_VALUES]).default("pct"));
+    list.addOption(new Option("--limit <n>", "Max items (1-1000)").default("500"));
+    list.action(async (opts) => {
+        if (!OPERATIONS["concepts.list"]) {
+            emitVerbError("internal_error", "concepts.list missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => conceptsListSpec.handler({
+            status: opts.status,
+            sort: opts.sort,
+            limit: clampInt(opts.limit, 1, 1000, 500),
+        }, ctx));
+    });
+    const snapshot = cmd.command("snapshot").description(conceptsSnapshotSpec.description);
+    snapshot.addOption(new Option("--codes <ids>", "Comma-separated concept_id list"));
+    snapshot.action(async (opts) => {
+        if (!OPERATIONS["concepts.snapshot"]) {
+            emitVerbError("internal_error", "concepts.snapshot missing", undefined, 2);
+        }
+        const args = {};
+        if (opts.codes)
+            args.codes = opts.codes;
+        await executeVerb(async (ctx) => conceptsSnapshotSpec.handler(args, ctx));
+    });
+    const show = cmd
+        .command("show <concept_id>")
+        .description(conceptsShowSpec.description);
+    show.action(async (conceptIdRaw) => {
+        if (!OPERATIONS["concepts.show"]) {
+            emitVerbError("internal_error", "concepts.show missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => conceptsShowSpec.handler({ concept_id: parseConceptId(conceptIdRaw) }, ctx));
+    });
+    const alerts = cmd.command("alerts").description(conceptsAlertsSpec.description);
+    alerts.action(async () => {
+        if (!OPERATIONS["concepts.alerts"]) {
+            emitVerbError("internal_error", "concepts.alerts missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => conceptsAlertsSpec.handler({}, ctx));
+    });
+    const alertsHist = cmd
+        .command("alerts-history")
+        .description(conceptsAlertsHistorySpec.description);
+    alertsHist.addOption(new Option("--from <unix_ms>", "Unix ms lower bound; default now-24h"));
+    alertsHist.addOption(new Option("--to <unix_ms>", "Unix ms upper bound; default now"));
+    alertsHist.addOption(new Option("--rule <r>", "Filter by rule").choices([...RULE_VALUES]));
+    alertsHist.addOption(new Option("--limit <n>", "Max items (1-2000)").default("500"));
+    alertsHist.action(async (opts) => {
+        if (!OPERATIONS["concepts.alerts-history"]) {
+            emitVerbError("internal_error", "concepts.alerts-history missing", undefined, 2);
+        }
+        const args = { limit: clampInt(opts.limit, 1, 2000, 500) };
+        if (opts.from !== undefined) {
+            const n = Math.floor(Number(opts.from));
+            if (Number.isFinite(n))
+                args.from = n;
+        }
+        if (opts.to !== undefined) {
+            const n = Math.floor(Number(opts.to));
+            if (Number.isFinite(n))
+                args.to = n;
+        }
+        if (opts.rule)
+            args.rule = opts.rule;
+        await executeVerb(async (ctx) => conceptsAlertsHistorySpec.handler(args, ctx));
+    });
+    const daily = cmd
+        .command("daily-bars <concept_id>")
+        .description(conceptsDailyBarsSpec.description);
+    daily.addOption(new Option("--from <YYYY-MM-DD>", "Inclusive start date").makeOptionMandatory(true));
+    daily.addOption(new Option("--to <YYYY-MM-DD>", "Inclusive end date").makeOptionMandatory(true));
+    daily.action(async (conceptIdRaw, opts) => {
+        if (!OPERATIONS["concepts.daily-bars"]) {
+            emitVerbError("internal_error", "concepts.daily-bars missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => conceptsDailyBarsSpec.handler({ concept_id: parseConceptId(conceptIdRaw), from: opts.from, to: opts.to }, ctx));
+    });
+    const minute = cmd
+        .command("minute-bars <concept_id>")
+        .description(conceptsMinuteBarsSpec.description);
+    minute.addOption(new Option("--from <YYYY-MM-DD>", "Inclusive start date").makeOptionMandatory(true));
+    minute.addOption(new Option("--to <YYYY-MM-DD>", "Inclusive end date (max 7 days)").makeOptionMandatory(true));
+    minute.action(async (conceptIdRaw, opts) => {
+        if (!OPERATIONS["concepts.minute-bars"]) {
+            emitVerbError("internal_error", "concepts.minute-bars missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => conceptsMinuteBarsSpec.handler({ concept_id: parseConceptId(conceptIdRaw), from: opts.from, to: opts.to }, ctx));
+    });
+    const news = cmd.command("news <concept_id>").description(conceptsNewsSpec.description);
+    news.addOption(new Option("--days <n>", "Lookback window (1-365)").default("30"));
+    news.addOption(new Option("--limit <n>", "Max items (1-200)").default("50"));
+    news.action(async (conceptIdRaw, opts) => {
+        if (!OPERATIONS["concepts.news"]) {
+            emitVerbError("internal_error", "concepts.news missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => conceptsNewsSpec.handler({
+            concept_id: parseConceptId(conceptIdRaw),
+            days: clampInt(opts.days, 1, 365, 30),
+            limit: clampInt(opts.limit, 1, 200, 50),
+        }, ctx));
+    });
+    const views = cmd.command("views <concept_id>").description(conceptsViewsSpec.description);
+    views.addOption(new Option("--limit <n>", "Max items (1-200)").default("50"));
+    views.action(async (conceptIdRaw, opts) => {
+        if (!OPERATIONS["concepts.views"]) {
+            emitVerbError("internal_error", "concepts.views missing", undefined, 2);
+        }
+        await executeVerb(async (ctx) => conceptsViewsSpec.handler({
+            concept_id: parseConceptId(conceptIdRaw),
+            limit: clampInt(opts.limit, 1, 200, 50),
+        }, ctx));
+    });
+    return cmd;
+}

package/dist/verbs/digest.js

@@ -43,10 +43,14 @@ import { executeVerb, emitVerbError } from "../runtime/verb_cmd.js";
 import { callOp } from "../runtime/verb_runner.js";
 /** Buckets in the order the description establishes (views first, news last). */
 const BUCKETS = ["views", "quote", "snapshot", "sentiment", "news"];
+// digest 故意保持 A 股 only：fan-out 里 quote / 14-field snapshot / sentiment 都是
+// StockPulse Rust API 上的 A 股 endpoint，HK/US 没有 capability（PR #D capability gate
+// 只把 HK/US 加进 search，没有 quote/chart）。混进 HK/US 会得到 partial_failures 一片红。
+// 等 HK/US 行情接入再放开（独立立项）。
 const CODE_REGEX = /^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/;
 export const digestSpec = {
     name: "digest",
-    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, and supplementary news. 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>'.",
+    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, and supplementary news. 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>'. AH dual-listing: for an A+H listed company always pass the A-share canonical (e.g. SSE:601398), not the HK side.",
     inputSchema: {
         code: z
             .string()
@@ -330,7 +334,10 @@ export function buildDigestCommand() {
     cmd.addOption(new Option("--limit-per-bucket <n>", "Items per bucket (1-50)").default("10"));
     cmd.action(async (opts) => {
         if (!CODE_REGEX.test(opts.code)) {
-            emitVerbError("invalid_args", `code ${JSON.stringify(opts.code)} is not a canonical_code (expected SSE|SZSE|BSE:NNNNNN)`, "Use `echopai lookup --text <name>` to resolve to a canonical_code first.", 1);
+            const isHkUs = /^(HK|US):/.test(opts.code);
+            emitVerbError("invalid_args", `code ${JSON.stringify(opts.code)} is not a canonical_code (expected SSE|SZSE|BSE:NNNNNN)`, isHkUs
+                ? "digest fan-out depends on A-share quote/chart/sentiment endpoints — HK/US not yet supported. Use `search` or `views` for HK/US."
+                : "Use `echopai lookup --text <name>` to resolve to a canonical_code first.", 1);
         }
         const args = {
             code: opts.code,