echopai 2.2.0 → 2.4.0

package/dist/tools/schema.js

@@ -1,58 +0,0 @@
-/**
- * `echopai schema [list | get <key> | export]`
- *
- * AI agent ingestion 路径：`echopai schema export | ai-tool` 一次拿全部命令的
- * input JSON Schema + path + method + 示例。
- */
-import { Command } from "commander";
-import { OPERATIONS, listOperations } from "../_generated/operations.js";
-import { HELP } from "../_generated/help.js";
-export function buildSchemaCommand() {
-    const cmd = new Command("schema").description("Inspect / export the CLI command surface");
-    cmd
-        .command("list")
-        .description("Print one line per command: cliKey, method, path, summary")
-        .action(() => {
-        for (const op of listOperations()) {
-            process.stdout.write(JSON.stringify({
-                cliKey: op.cliKey,
-                method: op.method,
-                path: op.path,
-                summary: op.summary,
-            }) + "\n");
-        }
-        process.exit(0);
-    });
-    cmd
-        .command("get <cliKey>")
-        .description("Print full operation def + help (input schema + example)")
-        .action((cliKey) => {
-        const op = OPERATIONS[cliKey];
-        if (!op) {
-            process.stderr.write(JSON.stringify({
-                error: {
-                    code: "schema_not_found",
-                    message: `No command with cliKey '${cliKey}'.`,
-                    recovery_hint: "Run `echopai schema list` for available keys.",
-                },
-            }) + "\n");
-            process.exit(1);
-        }
-        const help = HELP[cliKey] ?? null;
-        const out = { ...op, ...(help ? { example: help.example } : {}) };
-        process.stdout.write(JSON.stringify(out, null, 2) + "\n");
-        process.exit(0);
-    });
-    cmd
-        .command("export")
-        .description("NDJSON dump of full surface (one operation per line) — for AI agents")
-        .action(() => {
-        for (const op of listOperations()) {
-            const help = HELP[op.cliKey];
-            const merged = { ...op, ...(help ? { example: help.example } : {}) };
-            process.stdout.write(JSON.stringify(merged) + "\n");
-        }
-        process.exit(0);
-    });
-    return cmd;
-}

package/dist/tools/trace.js

@@ -1,54 +0,0 @@
-/**
- * `echopai trace [tail | get <request_id>]`
- *
- * 本地调用追溯 ring buffer (~/.echopai/trace.ndjson)。每次 CLI 调用结束都会
- * 写一条 NDJSON。用途：
- *   - 看最近 N 次调用 (tail)
- *   - 用 request_id 反查具体一次 (get)
- *
- * `ECHOPAI_NO_TRACE=1` 关闭写入；`ECHOPAI_TRACE_FILE=/path` 改路径（测试用）。
- */
-import { Command, Option } from "commander";
-import { getTraceByRequestId, resolveTraceFile, tailTraces, } from "../runtime/trace.js";
-export function buildTraceCommand() {
-    const cmd = new Command("trace").description("Inspect local CLI invocation trace (~/.echopai/trace.ndjson)");
-    cmd
-        .command("tail")
-        .description("Print last N trace records (NDJSON)")
-        .addOption(new Option("--lines <n>", "Number of records").default("20"))
-        .action((opts) => {
-        const n = Math.max(1, Math.floor(Number(opts.lines) || 20));
-        const records = tailTraces(n);
-        for (const r of records) {
-            process.stdout.write(JSON.stringify(r) + "\n");
-        }
-        process.exit(0);
-    });
-    cmd
-        .command("get <request_id>")
-        .description("Find a single trace record by request_id")
-        .action((requestId) => {
-        const r = getTraceByRequestId(requestId);
-        if (!r) {
-            process.stderr.write(JSON.stringify({
-                error: {
-                    code: "not_found",
-                    message: `No trace record with request_id '${requestId}'.`,
-                    retryable: false,
-                    recovery_hint: "Trace ring buffer holds ~50MB. Older records rotate to `trace.ndjson.1` and beyond that are lost.",
-                },
-            }) + "\n");
-            process.exit(1);
-        }
-        process.stdout.write(JSON.stringify(r, null, 2) + "\n");
-        process.exit(0);
-    });
-    cmd
-        .command("path")
-        .description("Print the resolved trace file path")
-        .action(() => {
-        process.stdout.write(resolveTraceFile() + "\n");
-        process.exit(0);
-    });
-    return cmd;
-}

package/dist/tools/welcome.js

@@ -1,190 +0,0 @@
-/**
- * `echopai` (bare) / `echopai welcome` — onboarding screen.
- *
- * Goal: give a TTY user a Claude-Code-style landing page when they type
- * `echopai` with no args. Banner → auth status → grouped command examples
- * → pointers to deeper help. AI / CI / non-TTY callers fall back to
- * commander's plain help (handled by the bin.ts dispatcher).
- *
- * No network calls. We probe credentials locally (env / config file) only —
- * a live `whoami` would slow the screen and is the wrong default for the
- * "user just typed `echopai`" path. `echopai status` / `echopai whoami`
- * cover the live-check use case.
- */
-import { Command } from "commander";
-import { resolveCredentials, AuthMissingError } from "../runtime/auth.js";
-import { bold, cyan, dim, green, isTtyHuman, yellow } from "../runtime/tty.js";
-import { CLI_VERSION } from "../version.js";
-function maskKey(key) {
-    // eps_live_<lookup>_<secret> → keep prefix + first 4 of lookup + masked tail.
-    if (key.length <= 16)
-        return "***";
-    return key.slice(0, 13) + "***";
-}
-function snapshotAuth() {
-    try {
-        const creds = resolveCredentials({});
-        if (creds.profile) {
-            return {
-                state: "profile",
-                profile: creds.profile,
-                keyHint: maskKey(creds.key),
-                baseUrl: creds.baseUrl,
-            };
-        }
-        return { state: "env", keyHint: maskKey(creds.key), baseUrl: creds.baseUrl };
-    }
-    catch (e) {
-        if (e instanceof AuthMissingError)
-            return { state: "missing" };
-        throw e;
-    }
-}
-/** Right-pad a string to width `w`, ignoring ANSI escapes for length. */
-function padRight(s, w) {
-    // strip ANSI for length measurement
-    // eslint-disable-next-line no-control-regex
-    const visible = s.replace(/\x1b\[[0-9;]*m/g, "");
-    const pad = Math.max(0, w - visible.length);
-    return s + " ".repeat(pad);
-}
-const COMMAND_GROUPS = [
-    {
-        title: "🔍 快速检索",
-        items: [
-            { cmd: "echopai lookup --text 茅台", note: "中文名 / 拼音首字母 → canonical_code" },
-            { cmd: "echopai digest --code SSE:600519", note: "一键研究摘要（5 桶 fan-out，容忍部分失败）" },
-            { cmd: "echopai search --query \"AI 算力\"", note: "题材 / 概念语义搜索" },
-        ],
-    },
-    {
-        title: "📈 实时行情",
-        items: [
-            { cmd: "echopai quote --codes \"SSE:600519,SZSE:000001\"", note: "1-200 只实时报价" },
-            { cmd: "echopai sentiment", note: "市场情绪总览（涨跌停 / 宽度 / 分化）" },
-            { cmd: "echopai hot", note: "东方财富热门股榜（综合搜索 / 关注 / 评论）" },
-            { cmd: "echopai scan", note: "全市场快照（约 5800 只）" },
-        ],
-    },
-    {
-        title: "💰 基本面 / 估值",
-        items: [
-            { cmd: "echopai financials quote-snapshot --code SSE:600519", note: "估值快照 14 字段（PE/PB/PS/换手率/股息率/量比）★头牌★" },
-            { cmd: "echopai financials pit --code SSE:600519 --date 2024-11-01", note: "Point-in-time 财务指标（回测防穿越）" },
-            { cmd: "echopai financials reports --code SSE:600519 --kind annual", note: "最近 N 期财务报告（~25 字段/期）" },
-            { cmd: "echopai financials series --code SSE:600519 --metric roe_simple", note: "单指标历史时间序列" },
-        ],
-    },
-    {
-        title: "📰 研究 / 资讯",
-        items: [
-            { cmd: "echopai views --code SSE:600519", note: "★主源★ 卖方研报 / 分析师观点（含 research_entity_id 归因）" },
-            { cmd: "echopai news search --query AI --since-hours 24", note: "辅源新闻 / 简讯（短时窗）" },
-        ],
-    },
-    {
-        title: "📊 K 线",
-        items: [
-            { cmd: "echopai chart --code SSE:600519 --from 2026-01-01 --to 2026-05-01", note: "单只 K 线（日线 / 分钟线）" },
-            { cmd: "echopai bars-batch --codes A,B,C --from ... --to ...", note: "批量 K 线（≤100 只）" },
-        ],
-    },
-    {
-        title: "🤖 AI 集成",
-        items: [
-            { cmd: "echopai mcp serve", note: "启动 MCP stdio 服务（Claude Desktop / Cursor / Claude Code）" },
-            { cmd: "echopai schema export", note: "导出全部 operation schema 给 agent 喂养" },
-        ],
-    },
-];
-const POINTERS = [
-    { cmd: "echopai --help", note: "完整命令树" },
-    { cmd: "echopai <verb> --help", note: "查看单个命令的参数和示例" },
-    { cmd: "echopai whoami", note: "在线检查 token 能力 / scopes" },
-    { cmd: "echopai doctor", note: "诊断鉴权 / 网络连通性" },
-    { cmd: "echopai status", note: "查看本地 profile + 鉴权状态" },
-];
-const BANNER_PLAIN = [
-    "  ███████  ██████ ██   ██  ██████  ██████   █████  ██",
-    "  ██      ██      ██   ██ ██    ██ ██   ██ ██   ██ ██",
-    "  █████   ██      ███████ ██    ██ ██████  ███████ ██",
-    "  ██      ██      ██   ██ ██    ██ ██      ██   ██ ██",
-    "  ███████  ██████ ██   ██  ██████  ██      ██   ██ ██",
-];
-export function renderWelcome(now = () => new Date()) {
-    const lines = [];
-    const auth = snapshotAuth();
-    // Banner
-    lines.push("");
-    for (const row of BANNER_PLAIN)
-        lines.push(cyan(row));
-    lines.push("");
-    lines.push(`  ${bold("EchoPai CLI")} ${dim("v" + CLI_VERSION)}  ${dim("·")}  ${dim("面向 AI Agent 的 A 股数据接入终端")}`);
-    lines.push("");
-    // Auth status
-    if (auth.state === "missing") {
-        lines.push(`  ${yellow("●")} ${bold("未登录")} ${dim("—")} 运行 ${cyan("`echopai login --key eps_live_<lookup>_<secret>`")} 或设置环境变量 ${cyan("ECHOPAI_KEY")}`);
-    }
-    else if (auth.state === "env") {
-        lines.push(`  ${green("●")} ${bold("已登录")}（环境变量 ${cyan("ECHOPAI_KEY")}）${dim(`(${auth.keyHint})`)}  →  ${dim(auth.baseUrl)}`);
-    }
-    else {
-        lines.push(`  ${green("●")} ${bold("已登录")} profile ${cyan(auth.profile)} ${dim(`(${auth.keyHint})`)}  →  ${dim(auth.baseUrl)}`);
-    }
-    lines.push("");
-    // Command groups
-    lines.push(`  ${dim("── 常用命令 ─────────────────────────────────────────────────")}`);
-    lines.push("");
-    // Reserve column 1 for cmd, column 2 for note. Compute padding from the
-    // widest cmd across all groups to keep alignment stable.
-    const widest = Math.min(72, COMMAND_GROUPS.flatMap((g) => g.items)
-        .map((it) => it.cmd.length)
-        .reduce((a, b) => Math.max(a, b), 0));
-    for (const group of COMMAND_GROUPS) {
-        lines.push(`  ${bold(group.title)}`);
-        for (const it of group.items) {
-            const cmd = cyan(it.cmd);
-            lines.push(`    ${padRight(cmd, widest + 4)}  ${dim(it.note)}`);
-        }
-        lines.push("");
-    }
-    // Pointers
-    lines.push(`  ${dim("── 更多 ─────────────────────────────────────────────────────")}`);
-    lines.push("");
-    for (const it of POINTERS) {
-        lines.push(`    ${padRight(cyan(it.cmd), widest + 4)}  ${dim(it.note)}`);
-    }
-    lines.push("");
-    lines.push(`  ${dim("文档: https://docs.echopai.com  ·  反馈: https://github.com/evanzhangx/EchoPulse/issues")}`);
-    lines.push("");
-    // Timestamp footer so users know this isn't a stale cache
-    const ts = now().toISOString().replace("T", " ").slice(0, 19);
-    lines.push(`  ${dim("生成于 " + ts + " UTC · Ctrl+C 退出")}`);
-    lines.push("");
-    return lines.join("\n");
-}
-/** Print welcome screen to stdout (no exit — caller decides). */
-export function printWelcome() {
-    process.stdout.write(renderWelcome());
-}
-/**
- * Decide whether bare `echopai` (no args, no flags) should show the welcome
- * screen. False for AI / CI / piped output — they get commander's plain help.
- */
-export function shouldShowWelcome(argv) {
-    // node + script + (no extra args)
-    if (argv.length !== 2)
-        return false;
-    if (!isTtyHuman)
-        return false;
-    if (process.env.CI)
-        return false;
-    return true;
-}
-export function buildWelcomeCommand() {
-    return new Command("welcome")
-        .description("显示欢迎屏（banner + 常用命令 + 鉴权状态）")
-        .action(() => {
-        printWelcome();
-    });
-}

package/dist/tools/whoami.js

@@ -1,132 +0,0 @@
-/**
- * `echopai whoami`
- *
- * 调 /v1/auth/whoami 拿 token 自省 + 派生 operation 可用性：
- *   available:    token 至少有一个 op.scopesAny 中的 scope (或 scopesAny 为空)
- *   unavailable:  op.scopesAny 非空且全部 miss → missing_scopes_any 全部列出
- *
- * 输出标准 envelope；缓存 5min in-process (whoami_cache.ts)。
- *
- * 该命令是 Phase 4 MCP `tools/list` 推导逻辑的同源——MCP server 启动时调用
- * 同一个 getWhoami() 拿能力图。
- */
-import { Command, Option } from "commander";
-import { listOperations } from "../_generated/operations.js";
-import { resolveCredentials, AuthMissingError } from "../runtime/auth.js";
-import { CallApiError } from "../runtime/errors.js";
-import { isTtyHuman, renderError } from "../runtime/tty.js";
-import { clearWhoamiCache, getWhoami } from "../runtime/whoami_cache.js";
-import { CLI_VERSION } from "../version.js";
-export function deriveOperationAvailability(scopes, ops = listOperations()) {
-    const available = [];
-    const unavailable = [];
-    for (const op of ops) {
-        const required = op.scopesAny;
-        const summary = { cliKey: op.cliKey, method: op.method, path: op.path };
-        if (!required || required.length === 0) {
-            available.push(summary);
-            continue;
-        }
-        const hit = required.some((s) => scopes.has(s));
-        if (hit) {
-            available.push(summary);
-        }
-        else {
-            unavailable.push({ ...summary, missing_scopes_any: required.slice() });
-        }
-    }
-    return { available, unavailable };
-}
-export function buildWhoamiOutput(whoami, channel, ops = listOperations()) {
-    const scopeSet = new Set(whoami.scopes);
-    const { available, unavailable } = deriveOperationAvailability(scopeSet, ops);
-    const out = {
-        kind: whoami.kind,
-        scopes: whoami.scopes,
-        channel,
-        operations: { available, unavailable },
-    };
-    if (whoami.app_id)
-        out.app_id = whoami.app_id;
-    if (whoami.org_id)
-        out.org_id = whoami.org_id;
-    if (whoami.app_slug)
-        out.app_slug = whoami.app_slug;
-    if (whoami.audience)
-        out.audience = whoami.audience;
-    if (whoami.api_version)
-        out.api_version = whoami.api_version;
-    if (whoami.allowed_clients)
-        out.allowed_clients = whoami.allowed_clients;
-    if (whoami.feature_flags && Object.keys(whoami.feature_flags).length > 0) {
-        out.feature_flags = whoami.feature_flags;
-    }
-    if (whoami.rate_limit?.qps != null)
-        out.rate_limit_qps = whoami.rate_limit.qps;
-    if (whoami.rate_limit?.monthly_quota != null) {
-        out.monthly_quota = whoami.rate_limit.monthly_quota;
-    }
-    return out;
-}
-export function buildWhoamiCommand() {
-    const cmd = new Command("whoami").description("Show current token capabilities (kind / scopes / available operations)");
-    cmd.addOption(new Option("--no-cache", "Bypass 5-minute whoami cache"));
-    cmd.addOption(new Option("--key <key>", "Override credential (env / config)"));
-    cmd.addOption(new Option("--profile <name>", "Use a specific profile"));
-    cmd.action(async (opts) => {
-        let creds;
-        try {
-            creds = resolveCredentials({
-                ...(opts.key ? { key: opts.key } : {}),
-                ...(opts.profile ? { profile: opts.profile } : {}),
-            });
-        }
-        catch (e) {
-            if (e instanceof AuthMissingError) {
-                emitError("auth_missing", e.message, e.recovery_hint, 1);
-            }
-            throw e;
-        }
-        if (opts.cache === false)
-            clearWhoamiCache();
-        let whoami;
-        try {
-            whoami = await getWhoami({ baseUrl: creds.baseUrl, bearer: creds.key, cliVersion: CLI_VERSION }, { force: opts.cache === false });
-        }
-        catch (e) {
-            if (e instanceof CallApiError) {
-                emitError(e.code, e.message, e.recovery_hint, e.httpStatus && e.httpStatus < 500 ? 1 : 2, e.requestId);
-            }
-            throw e;
-        }
-        const data = buildWhoamiOutput(whoami, "cli");
-        const envelope = {
-            data,
-            meta: {
-                cli_version: CLI_VERSION,
-                ...(whoami.api_version ? { api_version: whoami.api_version } : {}),
-            },
-        };
-        process.stdout.write(JSON.stringify(envelope) + "\n");
-        process.exit(0);
-    });
-    return cmd;
-}
-function emitError(code, message, recoveryHint, exitCode, requestId) {
-    const env = {
-        error: {
-            code,
-            message,
-            retryable: false,
-            ...(recoveryHint ? { recovery_hint: recoveryHint } : {}),
-            ...(requestId ? { request_id: requestId } : {}),
-        },
-    };
-    if (isTtyHuman) {
-        process.stderr.write(renderError(env) + "\n");
-    }
-    else {
-        process.stderr.write(JSON.stringify(env) + "\n");
-    }
-    process.exit(exitCode);
-}

package/dist/verbs/_spec.js

@@ -1,15 +0,0 @@
-/**
- * VerbSpec —— curated verb 的源声明，CLI 与 MCP 两条入口共享。
- *
- * - CLI (commander): build*Command() 内部把 spec.handler 接到 commander.action
- *   外加 executeVerb (process.exit / stderr / 错误 envelope) 包装。
- * - MCP: tools/mcp.ts 启动时枚举所有 spec，把 inputSchema 直接喂 SDK
- *   registerTool，handler 包成 MCP tool callback。
- *
- * 单源声明保证两个入口的 verb 名称 / 参数语义 / 输出形态完全同步。
- *
- * inputSchema 用 Zod raw shape (Record<string, ZodType>) —— MCP SDK 原生
- * 接受；CLI 端不重复用它做校验 (commander Option + 我们 verb 内部的
- * clamp/parse 已足够)。
- */
-export {};

package/dist/verbs/bars_batch.js

@@ -1,66 +0,0 @@
-/**
- * `echopai bars-batch` + MCP tool `bars_batch`.
- */
-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 DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-const CODE_RE = /^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/;
-export const barsBatchSpec = {
-    name: "bars_batch",
-    description: "Batch K-line for multiple A-share securities in one round-trip. Daily: ≤100 codes × ≤1yr; minute: ≤20 codes × ≤7d. Returns partial-success envelope {items, errors}.",
-    inputSchema: {
-        codes: z
-            .array(z.string().regex(CODE_RE))
-            .min(1)
-            .max(100)
-            .describe("Canonical codes (daily ≤100; minute ≤20)"),
-        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"),
-        minute: z
-            .boolean()
-            .optional()
-            .describe("Minute-level bars instead of daily (tighter caps apply)"),
-    },
-    handler: async (args, ctx) => {
-        const isMinute = Boolean(args.minute);
-        const cap = isMinute ? 20 : 100;
-        const codes = args.codes;
-        if (codes.length > cap) {
-            throw new Error(`codes count ${codes.length} exceeds cap ${cap} for ${isMinute ? "minute" : "daily"} bars_batch`);
-        }
-        const cliKey = isMinute ? "bars.minute-batch" : "bars.daily-batch";
-        const op = OPERATIONS[cliKey];
-        if (!op)
-            throw new Error(`${cliKey} op missing from codegen`);
-        return callOp(op, { codes, from: args.from, to: args.to }, ctx);
-    },
-    backingOps: ["bars.daily-batch", "bars.minute-batch"],
-};
-export function buildBarsBatchCommand() {
-    // CLI alias keeps the hyphenated form. MCP tool name uses underscore (MCP
-    // convention; underscores parse cleaner across hosts).
-    const cmd = new Command("bars-batch").description(barsBatchSpec.description);
-    cmd.addOption(new Option("--codes <csv>", "Canonical codes, comma-separated")
-        .makeOptionMandatory(true));
-    cmd.addOption(new Option("--from <date>", "Inclusive start YYYY-MM-DD").makeOptionMandatory(true));
-    cmd.addOption(new Option("--to <date>", "Inclusive end YYYY-MM-DD").makeOptionMandatory(true));
-    cmd.addOption(new Option("--minute", "Minute-level bars instead of daily"));
-    cmd.action(async (opts) => {
-        const codes = opts.codes.split(",").map((s) => s.trim()).filter(Boolean);
-        const isMinute = Boolean(opts.minute);
-        const cap = isMinute ? 20 : 100;
-        if (codes.length === 0 || codes.length > cap) {
-            emitVerbError("invalid_args", `codes count ${codes.length} out of range; expected 1-${cap} for ${isMinute ? "minute" : "daily"} bars-batch`, isMinute
-                ? "Daily mode (default) allows up to 100 codes; drop --minute or chunk the request."
-                : "Chunk the request into batches of ≤100 codes.", 1);
-        }
-        const args = { codes, from: opts.from, to: opts.to };
-        if (opts.minute)
-            args.minute = true;
-        await executeVerb(async (ctx) => barsBatchSpec.handler(args, ctx));
-    });
-    return cmd;
-}

package/dist/verbs/chart.js

@@ -1,110 +0,0 @@
-/**
- * `echopai chart` + MCP tool `chart`.
- */
-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 DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-export const chartSpec = {
-    name: "chart",
-    description: "Single-security K-line (daily by default; set minute=true for intraday with a single date). For multi-code use `bars_batch` instead.",
-    inputSchema: {
-        code: z
-            .string()
-            .regex(/^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$/)
-            .describe("Single canonical code (e.g. SSE:600519)"),
-        days: z
-            .number()
-            .int()
-            .min(1)
-            .max(365)
-            .default(30)
-            .describe("Daily lookback (ignored when from/to or minute mode are set)"),
-        from: z
-            .string()
-            .regex(DATE_RE)
-            .optional()
-            .describe("YYYY-MM-DD inclusive start (daily mode; overrides days)"),
-        to: z
-            .string()
-            .regex(DATE_RE)
-            .optional()
-            .describe("YYYY-MM-DD inclusive end (daily mode; overrides days)"),
-        minute: z.boolean().optional().describe("Switch to minute-level bars (requires date)"),
-        date: z.string().regex(DATE_RE).optional().describe("Single trade date YYYY-MM-DD (minute mode)"),
-    },
-    handler: async (args, ctx) => {
-        if (args.minute) {
-            if (!args.date) {
-                throw new Error("minute=true requires date (YYYY-MM-DD)");
-            }
-            const op = OPERATIONS["bars.minute"];
-            if (!op)
-                throw new Error("bars.minute op missing");
-            // bars.minute expects a single `date` (YYYY-MM-DD), not from/to —
-            // see stockpulse-rs MinuteBarsQuery + OpenAPI 2026-05-12 correction.
-            return callOp(op, { code: args.code, date: args.date }, ctx);
-        }
-        const op = OPERATIONS["bars.daily"];
-        if (!op)
-            throw new Error("bars.daily op missing");
-        const callArgs = { code: args.code };
-        if (args.from && args.to) {
-            callArgs.from = args.from;
-            callArgs.to = args.to;
-        }
-        else {
-            // bars.daily requires from/to (additionalProperties:false; no `days`).
-            // Derive a from/to window from --days client-side. Includes today;
-            // server skips non-trading days automatically.
-            const days = Math.max(1, Number(args.days ?? 30));
-            const to = new Date();
-            const from = new Date(to.getTime() - (days - 1) * 24 * 3600 * 1000);
-            const fmt = (d) => `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
-            callArgs.from = fmt(from);
-            callArgs.to = fmt(to);
-        }
-        return callOp(op, callArgs, ctx);
-    },
-    backingOps: ["bars.daily", "bars.minute"],
-};
-function clamp(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 buildChartCommand() {
-    const cmd = new Command(chartSpec.name).description(chartSpec.description);
-    cmd.addOption(new Option("--code <canonical_code>", "Single canonical code").makeOptionMandatory(true));
-    cmd.addOption(new Option("--days <n>", "Daily lookback (1-365, default 30)").default("30"));
-    cmd.addOption(new Option("--from <date>", "Inclusive start date YYYY-MM-DD (overrides --days)"));
-    cmd.addOption(new Option("--to <date>", "Inclusive end date YYYY-MM-DD (overrides --days)"));
-    cmd.addOption(new Option("--minute", "Switch to minute-level bars (requires --date)"));
-    cmd.addOption(new Option("--date <date>", "Single trade date YYYY-MM-DD (minute mode)"));
-    cmd.action(async (opts) => {
-        if (opts.minute && !opts.date) {
-            emitVerbError("invalid_args", "--minute requires --date YYYY-MM-DD (single trade date)", "Example: echopai chart --minute --code SSE:600519 --date 2026-05-09", 1);
-        }
-        const args = {
-            code: opts.code,
-            days: clamp(opts.days, 1, 365, 30),
-        };
-        if (opts.from)
-            args.from = opts.from;
-        if (opts.to)
-            args.to = opts.to;
-        if (opts.minute)
-            args.minute = true;
-        if (opts.date)
-            args.date = opts.date;
-        await executeVerb(async (ctx) => chartSpec.handler(args, ctx));
-    });
-    return cmd;
-}