@quantbrasil/cli 0.1.0-beta.13 → 0.1.0-beta.15

package/dist/commands/backtests.js

@@ -0,0 +1,525 @@
+import { invokeCliCapability } from "../cli/client.js";
+import { createCliValidationError } from "../cli/errors.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerBacktestsCommands(program, context = {}) {
+    const backtestsCommand = program
+        .command("backtests")
+        .description("Descobre estratégias e executa backtests salvos");
+    backtestsCommand
+        .command("strategies")
+        .description("Lista estratégias de backtest disponíveis")
+        .option("--json", "Exibe saída JSON")
+        .action(async (options) => {
+        await runBacktestsStrategiesCommand(options, context);
+    });
+    backtestsCommand
+        .command("info")
+        .description("Mostra a motivação, defaults e parâmetros de uma estratégia")
+        .argument("<strategy-id>", "ID da estratégia")
+        .option("--json", "Exibe saída JSON")
+        .action(async (strategyId, options) => {
+        await runBacktestsInfoCommand(strategyId, options, context);
+    });
+    backtestsCommand
+        .command("get")
+        .description("Mostra um backtest salvo por ID")
+        .argument("<backtest-id>", "ID do backtest")
+        .option("--json", "Exibe saída JSON")
+        .action(async (backtestId, options) => {
+        await runBacktestsGetCommand(backtestId, options, context);
+    });
+    backtestsCommand
+        .command("run")
+        .description("Executa e salva um backtest para o usuário autenticado")
+        .argument("<strategy-id>", "ID da estratégia")
+        .argument("<ticker>", "Ticker do ativo")
+        .option("--timeframe <timeframe>", "Timeframe do backtest")
+        .option("--from <date>", "Data inicial em AAAA-MM-DD")
+        .option("--to <date>", "Data final em AAAA-MM-DD")
+        .option("--capital <number>", "Capital inicial")
+        .option("--max-risk <number>", "Risco máximo")
+        .option("--contracts <number>", "Número de contratos", "5")
+        .option("--param <key=value>", "Parâmetro da estratégia; pode ser usado várias vezes", collectRepeatedOption, [])
+        .option("--params-json <json>", "Objeto JSON com parâmetros da estratégia")
+        .option("--json", "Exibe saída JSON")
+        .action(async (strategyId, ticker, options) => {
+        await runBacktestsRunCommand(strategyId, ticker, options, context);
+    });
+}
+export async function runBacktestsStrategiesCommand(options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "backtests.strategies",
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatBacktestStrategiesHuman(response.data, theme)}\n`);
+}
+export async function runBacktestsInfoCommand(strategyId, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "backtests.info",
+        input: buildBacktestsInfoInput(strategyId),
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatBacktestStrategyHuman(response.data, theme)}\n`);
+}
+export async function runBacktestsGetCommand(backtestId, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "backtests.get",
+        input: buildBacktestsGetInput(backtestId),
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatBacktestGetHuman(response.data, theme)}\n`);
+}
+export async function runBacktestsRunCommand(strategyId, ticker, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "backtests.run",
+        input: buildBacktestsRunInput(strategyId, ticker, options),
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatBacktestRunHuman(response.data, theme)}\n`);
+}
+export function buildBacktestsInfoInput(strategyId) {
+    return {
+        strategy_id: normalizeStrategyId(strategyId),
+    };
+}
+export function buildBacktestsGetInput(backtestId) {
+    return {
+        backtest_id: parsePositiveIntegerArgument(backtestId, "ID do backtest"),
+    };
+}
+export function buildBacktestsRunInput(strategyId, ticker, options) {
+    const input = {
+        strategy_id: normalizeStrategyId(strategyId),
+        ticker: normalizeTicker(ticker),
+    };
+    if (options.timeframe !== undefined) {
+        input.timeframe_id = options.timeframe.trim().toUpperCase();
+    }
+    if (options.from !== undefined) {
+        input.start_date = options.from.trim();
+    }
+    if (options.to !== undefined) {
+        input.end_date = options.to.trim();
+    }
+    const parameters = parseBacktestParameters(options);
+    if (parameters !== undefined) {
+        input.parameters = parameters;
+    }
+    if (options.capital !== undefined) {
+        input.capital = parseNumberLikeOption(options.capital);
+    }
+    if (options.maxRisk !== undefined) {
+        input.max_risk = parseNumberLikeOption(options.maxRisk);
+    }
+    if (options.contracts !== undefined) {
+        input.num_contracts = parseNumberLikeOption(options.contracts);
+    }
+    return input;
+}
+export function formatBacktestStrategiesHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        theme.label("Estratégias de backtest"),
+        "",
+        `${theme.label("Total:")} ${formatInteger(data.total)}`,
+        `${theme.label("Ajuda:")} quantbrasil backtests info <strategy-id>`,
+    ];
+    appendStrategyGroup(lines, theme, "Compra", data.strategies.filter(strategy => strategy.side === "long"));
+    appendStrategyGroup(lines, theme, "Venda", data.strategies.filter(strategy => strategy.side === "short"));
+    return lines.join("\n");
+}
+export function formatBacktestStrategyHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const strategy = data.strategy;
+    const lines = [
+        theme.label("Estratégia de backtest"),
+        "",
+        `${theme.bold(strategy.label)} ${theme.dim(`(${strategy.id})`)}`,
+        strategy.description,
+        "",
+        `${theme.label("Quando usar:")} ${strategy.selection_guidance}`,
+        `${theme.label("Guia de timeframe:")} ${strategy.timeframe_guidance}`,
+        "",
+        `${theme.label("Família:")} ${strategy.family}`,
+        `${theme.label("Lado:")} ${formatStrategySide(strategy.side)}`,
+        `${theme.label("Timeframes:")} ${formatStrategyTimeframes(strategy)}`,
+    ];
+    const flags = formatStrategyFlags(strategy);
+    if (flags.length > 0) {
+        lines.push(`${theme.label("Observações:")} ${flags.join("; ")}`);
+    }
+    lines.push("");
+    lines.push(theme.label("Parâmetros"));
+    if (strategy.parameters.length === 0) {
+        lines.push("  nenhum parâmetro configurável");
+    }
+    else {
+        for (const parameter of strategy.parameters) {
+            lines.push(`  ${formatBacktestParameter(parameter)}`);
+        }
+    }
+    lines.push("");
+    lines.push(theme.label("Exemplo"));
+    lines.push(`  ${formatStrategyRunUsage(strategy)}`);
+    return lines.join("\n");
+}
+export function formatBacktestRunHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const backtest = data.backtest;
+    const lines = [
+        theme.label("Backtest"),
+        "",
+        `${theme.bold(backtest.ticker)} ${theme.dim(`- ${backtest.strategy_id}`)}`,
+        `${theme.label("ID:")} ${backtest.id ?? "não salvo"}`,
+        `${theme.label("Setup:")} ${backtest.setup_id}`,
+        `${theme.label("Timeframe:")} ${backtest.timeframe_id}`,
+        `${theme.label("Período:")} ${formatDatePtBr(backtest.start_date)} a ${formatDatePtBr(backtest.end_date)}`,
+        `${theme.label("Capital inicial:")} ${formatCurrency(backtest.initial_capital)}`,
+        "",
+        `${theme.label("Retorno total:")} ${formatPercentage(backtest.pct_profit)}`,
+        `${theme.label("Drawdown:")} ${formatPercentage(backtest.drawdown)}`,
+        `${theme.label("EV:")} ${formatPercentage(backtest.ev)}`,
+        `${theme.label("Taxa de acerto:")} ${formatPercentage(backtest.pct_gains)}`,
+        `${theme.label("Operações:")} ${formatInteger(backtest.num_operations)}`,
+        `${theme.label("Profit factor:")} ${formatNullableNumber(backtest.profit_factor)}`,
+    ];
+    if (backtest.score !== null) {
+        lines.push(`${theme.label("Score:")} ${formatNumber(backtest.score)}`);
+    }
+    if (Object.keys(backtest.parameters).length > 0) {
+        lines.push(`${theme.label("Parâmetros:")} ${formatParameterRecord(backtest.parameters)}`);
+    }
+    if (backtest.suspicious) {
+        lines.push("");
+        lines.push(theme.warning("Resultado marcado como suspeito pelo backend."));
+    }
+    if (data.summary_markdown.trim()) {
+        lines.push("");
+        lines.push(data.summary_markdown);
+    }
+    if (backtest.trade_history.length > 0) {
+        lines.push("");
+        lines.push("Use --json para inspecionar o histórico completo de operações.");
+    }
+    return lines.join("\n");
+}
+export function formatBacktestGetHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const backtest = data.backtest;
+    const lines = [
+        theme.label("Backtest"),
+        "",
+        `${theme.bold(backtest.ticker)} ${theme.dim(`- ${backtest.strategy_id}`)}`,
+        `${theme.label("ID:")} ${backtest.id}`,
+        `${theme.label("Origem:")} ${formatBacktestOrigin(backtest.origin)}`,
+        `${theme.label("Setup:")} ${backtest.setup_id}`,
+        `${theme.label("Timeframe:")} ${backtest.timeframe_id}`,
+        `${theme.label("Período:")} ${formatDatePtBr(backtest.start_date)} a ${formatDatePtBr(backtest.end_date)}`,
+        `${theme.label("Capital inicial:")} ${formatCurrency(backtest.initial_capital)}`,
+        "",
+        `${theme.label("Retorno total:")} ${formatPercentage(backtest.pct_profit)}`,
+        `${theme.label("Drawdown:")} ${formatPercentage(backtest.drawdown)}`,
+        `${theme.label("EV:")} ${formatPercentage(backtest.ev)}`,
+        `${theme.label("Taxa de acerto:")} ${formatPercentage(backtest.pct_gains)}`,
+        `${theme.label("Operações:")} ${formatInteger(backtest.num_operations)}`,
+        `${theme.label("Profit factor:")} ${formatNullableNumber(backtest.profit_factor)}`,
+    ];
+    if (backtest.score !== null) {
+        lines.push(`${theme.label("Score:")} ${formatNumber(backtest.score)}`);
+    }
+    if (Object.keys(backtest.parameters).length > 0) {
+        lines.push(`${theme.label("Parâmetros:")} ${formatParameterRecord(backtest.parameters)}`);
+    }
+    if (backtest.suspicious) {
+        lines.push("");
+        lines.push(theme.warning("Resultado marcado como suspeito pelo backend."));
+    }
+    if (backtest.trade_history.length > 0) {
+        lines.push("");
+        lines.push("Use --json para inspecionar o histórico completo de operações.");
+    }
+    return lines.join("\n");
+}
+function collectRepeatedOption(value, previous) {
+    return [...previous, value];
+}
+function parseBacktestParameters(options) {
+    let parameters;
+    if (options.paramsJson !== undefined) {
+        parameters = parseParamsJsonOption(options.paramsJson);
+    }
+    for (const rawParam of options.param ?? []) {
+        if (parameters !== undefined && !isPlainRecord(parameters)) {
+            throw createCliValidationError("--params-json deve ser um objeto JSON para combinar com --param.");
+        }
+        const parameterRecord = parameters === undefined ? {} : parameters;
+        const [rawKey, ...rawValueParts] = rawParam.split("=");
+        const rawValue = rawValueParts.join("=");
+        const key = normalizeParameterKey(rawKey ?? "");
+        if (!key || rawValueParts.length === 0) {
+            throw createCliValidationError("Cada --param deve usar o formato nome=valor.");
+        }
+        parameterRecord[key] = parseParameterValue(rawValue);
+        parameters = parameterRecord;
+    }
+    return parameters;
+}
+function parseParamsJsonOption(value) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw createCliValidationError(`Não foi possível interpretar --params-json: ${message}`);
+    }
+    if (!isPlainRecord(parsed)) {
+        return parsed;
+    }
+    const parameters = {};
+    for (const [rawKey, rawValue] of Object.entries(parsed)) {
+        const key = normalizeParameterKey(rawKey);
+        parameters[key] = rawValue;
+    }
+    return parameters;
+}
+function parseParameterValue(value) {
+    const normalized = value.trim();
+    if (normalized === "true") {
+        return true;
+    }
+    if (normalized === "false") {
+        return false;
+    }
+    if (/^-?(?:\d+|\d+\.\d+|\.\d+)(?:e[+-]?\d+)?$/i.test(normalized)) {
+        const parsed = Number(normalized);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return normalized;
+}
+function parseNumberLikeOption(value) {
+    const normalized = value.trim();
+    if (/^-?(?:\d+|\d+\.\d+|\.\d+)(?:e[+-]?\d+)?$/i.test(normalized)) {
+        const parsed = Number(normalized);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return normalized;
+}
+function normalizeStrategyId(strategyId) {
+    const normalized = strategyId.trim().toLowerCase().replaceAll("-", "_");
+    if (!normalized) {
+        throw createCliValidationError("O ID da estratégia é obrigatório.");
+    }
+    return normalized;
+}
+function normalizeParameterKey(parameterKey) {
+    return parameterKey
+        .trim()
+        .replaceAll("-", "_")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2")
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .toLowerCase();
+}
+function normalizeTicker(ticker) {
+    const normalized = ticker.trim().toUpperCase();
+    if (!normalized) {
+        throw createCliValidationError("O ticker é obrigatório.");
+    }
+    return normalized;
+}
+function parsePositiveIntegerArgument(value, label) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw createCliValidationError(`${label} deve ser um inteiro positivo.`);
+    }
+    return parsed;
+}
+function appendStrategyGroup(lines, theme, title, strategies) {
+    lines.push("");
+    lines.push(`${theme.label(title)} ${theme.dim(`(${formatInteger(strategies.length)})`)}`);
+    if (strategies.length === 0) {
+        lines.push("  nenhuma estratégia");
+        return;
+    }
+    for (const strategy of strategies) {
+        lines.push(`  ${theme.bold(strategy.id)} - ${strategy.label}`);
+        lines.push(`    ${theme.label("Família:")} ${strategy.family}; ${theme.label("timeframes:")} ${formatStrategyTimeframes(strategy)}`);
+        lines.push(`    ${theme.label("Quando usar:")} ${formatShortGuidance(strategy.selection_guidance)}`);
+        lines.push(`    ${theme.label("Parâmetros:")} ${formatInteger(strategy.parameters.length)}; ${theme.label("uso:")} quantbrasil backtests info ${strategy.id}`);
+    }
+}
+function formatBacktestParameter(parameter) {
+    const details = [parameter.type];
+    if (parameter.required) {
+        details.push("obrigatório");
+    }
+    if (parameter.default !== null) {
+        details.push(`padrão ${formatScalar(parameter.default)}`);
+    }
+    if (parameter.options !== null && parameter.options.length > 0) {
+        details.push(`opções ${parameter.options.map(option => option.value).join("|")}`);
+    }
+    const lines = [
+        `${parameter.name}: ${details.join(", ")} - ${parameter.description}`,
+    ];
+    if (parameter.value_hint) {
+        lines.push(`    Valores: ${parameter.value_hint}`);
+    }
+    if (parameter.agent_guidance) {
+        lines.push(`    Guia: ${parameter.agent_guidance}`);
+    }
+    return lines.join("\n");
+}
+function formatStrategyRunUsage(strategy) {
+    const timeframeOption = strategy.requires_timeframe
+        ? ` --timeframe ${strategy.allowed_timeframes.includes("D1") ? "D1" : strategy.allowed_timeframes[0]}`
+        : "";
+    const requiredParameterOptions = strategy.parameters
+        .filter(parameter => parameter.required)
+        .map(parameter => ` --param ${parameter.name}=${formatStrategyExampleParameterValue(parameter)}`)
+        .join("");
+    return `quantbrasil backtests run ${strategy.id} PETR4${timeframeOption} --from 2025-01-01 --to 2026-01-01${requiredParameterOptions}`;
+}
+function formatStrategyExampleParameterValue(parameter) {
+    if (parameter.default !== null) {
+        return String(parameter.default);
+    }
+    if (parameter.options !== null && parameter.options.length > 0) {
+        return parameter.options[0]?.value ?? "valor";
+    }
+    if (parameter.format === "time") {
+        return "10:30";
+    }
+    if (parameter.type === "boolean") {
+        return "true";
+    }
+    if (parameter.type === "integer" || parameter.type === "number") {
+        return "1";
+    }
+    return "valor";
+}
+function formatStrategyFlags(strategy) {
+    const flags = [];
+    if (!strategy.requires_timeframe) {
+        flags.push("timeframe definido internamente pela estratégia");
+    }
+    if (strategy.fixed_risk) {
+        flags.push("usa risco técnico/fixo no setup");
+    }
+    if (strategy.day_trade_only) {
+        flags.push("estratégia intradiária");
+    }
+    if (strategy.blocked_in_crypto) {
+        flags.push("não suporta criptoativos");
+    }
+    return flags;
+}
+function formatStrategySide(side) {
+    return side === "long" ? "compra" : "venda";
+}
+function formatStrategyTimeframes(strategy) {
+    if (!strategy.requires_timeframe) {
+        return "interno";
+    }
+    return strategy.allowed_timeframes.join(", ");
+}
+function formatShortGuidance(value) {
+    const maxLength = 180;
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength - 3).trimEnd()}...`;
+}
+function formatParameterRecord(parameters) {
+    return Object.entries(parameters)
+        .map(([key, value]) => `${key}=${formatJsonScalar(value)}`)
+        .join(", ");
+}
+function formatJsonScalar(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        return formatNumber(value);
+    }
+    if (typeof value === "boolean") {
+        return String(value);
+    }
+    return JSON.stringify(value);
+}
+function formatScalar(value) {
+    return typeof value === "string" ? JSON.stringify(value) : String(value);
+}
+function formatBacktestOrigin(origin) {
+    if (!origin) {
+        return "não informado";
+    }
+    if (origin === "tool") {
+        return "ferramenta";
+    }
+    return origin;
+}
+function formatDatePtBr(value) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})/.exec(value);
+    if (!match) {
+        return value;
+    }
+    return `${match[3]}/${match[2]}/${match[1]}`;
+}
+function formatCurrency(value) {
+    return new Intl.NumberFormat("pt-BR", {
+        style: "currency",
+        currency: "BRL",
+        maximumFractionDigits: 2,
+    }).format(value);
+}
+function formatPercentage(value) {
+    return `${formatNumber(value * 100)}%`;
+}
+function formatNullableNumber(value) {
+    return value === null ? "n/d" : formatNumber(value);
+}
+function formatInteger(value) {
+    return new Intl.NumberFormat("pt-BR", {
+        maximumFractionDigits: 0,
+    }).format(value);
+}
+function formatNumber(value) {
+    return new Intl.NumberFormat("pt-BR", {
+        maximumFractionDigits: 2,
+    }).format(value);
+}
+function isPlainRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}

package/dist/commands/news.d.ts

@@ -0,0 +1,48 @@
+import { Command } from "commander";
+import type { JsonValue } from "../vendor/core/index.js";
+import { type CliInvokeContext } from "../cli/client.js";
+import { type TerminalWriter } from "../cli/terminal.js";
+export interface NewsCommandIO {
+    stdout: TerminalWriter;
+}
+export interface AssetNewsCommandOptions {
+    window?: string;
+    limit?: string;
+    json?: boolean;
+}
+export interface AssetNewsAsset {
+    [key: string]: JsonValue;
+    id: number;
+    ticker: string;
+    name: string | null;
+    type: string | null;
+}
+export interface AssetNewsArticle {
+    [key: string]: JsonValue;
+    id: number;
+    source_slug: string;
+    source_name: string;
+    title: string;
+    summary: string | null;
+    url: string;
+    published_at: string;
+    last_seen_at: string;
+    content_updated_at: string | null;
+    mentioned_tickers: string[];
+}
+export interface AssetNewsResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    asset: AssetNewsAsset;
+    window_days: number;
+    limit: number;
+    total: number;
+    articles: AssetNewsArticle[];
+}
+export interface NewsCommandContext extends CliInvokeContext {
+    io?: NewsCommandIO;
+}
+export declare function registerNewsCommands(program: Command, context?: NewsCommandContext): void;
+export declare function runAssetNewsCommand(ticker: string, options: AssetNewsCommandOptions, context?: NewsCommandContext): Promise<void>;
+export declare function formatAssetNewsHuman(data: AssetNewsResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+//# sourceMappingURL=news.d.ts.map

package/dist/commands/news.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"news.d.ts","sourceRoot":"","sources":["../../src/commands/news.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAK9E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,EAAE,CAAC,EAAE,aAAa,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAeN;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAgBf;AA+BD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,iBAAiB,EACvB,KAAK,6CAAsC,GAC1C,MAAM,CAoCR"}

package/dist/commands/news.js

@@ -0,0 +1,85 @@
+import { invokeCliCapability } from "../cli/client.js";
+import { createCliValidationError } from "../cli/errors.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+const DEFAULT_WINDOW_DAYS = "30";
+const DEFAULT_NEWS_LIMIT = "20";
+export function registerNewsCommands(program, context = {}) {
+    const newsCommand = program
+        .command("news")
+        .description("Lê notícias recentes vinculadas a ativos da QuantBrasil");
+    newsCommand
+        .command("asset")
+        .description("Busca notícias recentes para um ticker")
+        .argument("<ticker>", "Ticker do ativo, por exemplo PETR4")
+        .option("--window <days>", "Janela de busca em dias", DEFAULT_WINDOW_DAYS)
+        .option("--limit <count>", "Número máximo de notícias", DEFAULT_NEWS_LIMIT)
+        .option("--json", "Mostra a resposta em JSON")
+        .action(async (ticker, options) => {
+        await runAssetNewsCommand(ticker, options, context);
+    });
+}
+export async function runAssetNewsCommand(ticker, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "news.asset",
+        input: buildAssetNewsInput(ticker, options),
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatAssetNewsHuman(response.data, theme)}\n`);
+}
+function buildAssetNewsInput(ticker, options) {
+    return {
+        ticker,
+        window_days: parsePositiveIntegerOption(options.window ?? DEFAULT_WINDOW_DAYS, "--window"),
+        limit: parsePositiveIntegerOption(options.limit ?? DEFAULT_NEWS_LIMIT, "--limit"),
+    };
+}
+function parsePositiveIntegerOption(raw, flag) {
+    const normalized = (raw ?? "").trim();
+    const value = Number.parseInt(normalized, 10);
+    if (!Number.isInteger(value) || value <= 0 || String(value) !== normalized) {
+        throw createCliValidationError(`${flag} deve ser um inteiro positivo.`);
+    }
+    return value;
+}
+export function formatAssetNewsHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const identity = data.asset.name && data.asset.name.trim()
+        ? `${theme.bold(data.asset.ticker)} ${theme.dim(`· ${data.asset.name}`)}`
+        : theme.bold(data.asset.ticker);
+    const lines = [
+        theme.label("Notícias do ativo"),
+        "",
+        identity,
+        `${theme.label("Janela:")} ${data.window_days} dias`,
+        `${theme.label("Total:")} ${formatInteger(data.total)}`,
+    ];
+    if (data.articles.length === 0) {
+        lines.push("", "Nenhuma notícia recente encontrada.");
+        return lines.join("\n");
+    }
+    for (const article of data.articles) {
+        lines.push("");
+        lines.push(`${theme.bold(article.title)}`);
+        lines.push(`${theme.label("Fonte:")} ${article.source_name} ${theme.dim(formatDate(article.published_at))}`);
+        lines.push(`${theme.label("Menções:")} ${article.mentioned_tickers.join(", ")}`);
+        if (article.summary) {
+            lines.push(`${theme.label("Resumo:")} ${article.summary}`);
+        }
+        lines.push(`${theme.label("URL:")} ${article.url}`);
+    }
+    return lines.join("\n");
+}
+function formatDate(value) {
+    return value.split("T")[0] ?? value;
+}
+function formatInteger(value) {
+    return new Intl.NumberFormat("pt-BR", {
+        maximumFractionDigits: 0,
+    }).format(value);
+}

package/dist/index.d.ts

@@ -4,9 +4,11 @@ export * from "./cli/errors.js";
 export * from "./cli/index.js";
 export * from "./commands/assets.js";
 export * from "./commands/auth.js";
+export * from "./commands/backtests.js";
 export * from "./commands/capabilities.js";
 export * from "./commands/init.js";
 export * from "./commands/market.js";
+export * from "./commands/news.js";
 export * from "./commands/portfolios.js";
 export * from "./commands/rankings.js";
 export * from "./commands/screening.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}