@quantbrasil/cli 0.1.0-beta.8 → 0.1.0-beta.9

package/README.md

@@ -73,6 +73,10 @@ quantbrasil holdings historical-return 182 --from 2025-01-01 --to 2026-01-01
 quantbrasil holdings historical-return 182 --period 1y
 quantbrasil holdings beta 182 --years 3
 quantbrasil holdings var 182 --years 1 --confidence 95
+quantbrasil rankings list
+quantbrasil rankings current --system momentum-90d --top 20
+quantbrasil rankings current --system magic-formula --top 10
+quantbrasil rankings current --user 123 --top 20
 quantbrasil screening universes
 quantbrasil screening indicators
 quantbrasil screening run --system acoes-mais-liquidas --query-file ./screening.json

package/dist/cli/index.d.ts

@@ -3,6 +3,7 @@ import { type CapabilitiesCommandIO, runCapabilitiesCommand } from "../commands/
 import { runMarketAssetsCommand, runMarketPriceCommand } from "../commands/market.js";
 import { runInitCommand } from "../commands/init.js";
 import { runHoldingCreateCommand, runHoldingBetaCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand } from "../commands/portfolios.js";
+import { runRankingsCurrentCommand, runRankingsListCommand } from "../commands/rankings.js";
 import { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand } from "../commands/screening.js";
 import { runSkillsInstallCommand } from "../commands/skills.js";
 import { runStatusCommand } from "../commands/status.js";
@@ -29,6 +30,7 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
+export { runRankingsCurrentCommand, runRankingsListCommand };
 export { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, };
 export { runHoldingBetaCommand, runHoldingCreateCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, };
 export { runSkillsInstallCommand };

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,OAAO,EACL,KAAK,qBAAqB,EAE1B,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,gBAAgB,EAEhB,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAQvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CA0EzE;AAeD,wBAAsB,GAAG,CACvB,IAAI,WAAe,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAoCD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;AACzD,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,GAC7B,CAAC;AACF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,GAC1B,CAAC;AACF,OAAO,EAAE,uBAAuB,EAAE,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,OAAO,EACL,KAAK,qBAAqB,EAE1B,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,gBAAgB,EAEhB,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAQvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAgFzE;AAeD,wBAAsB,GAAG,CACvB,IAAI,WAAe,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAoCD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,GAC7B,CAAC;AACF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,GAC1B,CAAC;AACF,OAAO,EAAE,uBAAuB,EAAE,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/cli/index.js

@@ -6,6 +6,7 @@ import { registerCapabilitiesCommand, runCapabilitiesCommand, } from "../command
 import { registerMarketCommands, runMarketAssetsCommand, runMarketPriceCommand, } from "../commands/market.js";
 import { registerInitCommand, runInitCommand, } from "../commands/init.js";
 import { registerPortfoliosCommands, runHoldingCreateCommand, runHoldingBetaCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, } from "../commands/portfolios.js";
+import { registerRankingsCommands, runRankingsCurrentCommand, runRankingsListCommand, } from "../commands/rankings.js";
 import { registerScreeningCommands, runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, } from "../commands/screening.js";
 import { registerSkillsCommands, runSkillsInstallCommand, } from "../commands/skills.js";
 import { registerStatusFlag, runStatusCommand, } from "../commands/status.js";
@@ -44,6 +45,11 @@ export function createCliProgram(options = {}) {
         fetch: options.fetch,
         now: options.now,
     };
+    const rankingsContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+    };
     const screeningContext = {
         io: options.io,
         env: options.env,
@@ -80,6 +86,7 @@ export function createCliProgram(options = {}) {
     registerInitCommand(program, initContext);
     registerMarketCommands(program, marketContext);
     registerPortfoliosCommands(program, portfoliosContext);
+    registerRankingsCommands(program, rankingsContext);
     registerScreeningCommands(program, screeningContext);
     registerSkillsCommands(program, skillsContext);
     registerUpdateCommand(program, updateContext);
@@ -148,6 +155,7 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
+export { runRankingsCurrentCommand, runRankingsListCommand };
 export { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, };
 export { runHoldingBetaCommand, runHoldingCreateCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, };
 export { runSkillsInstallCommand };

package/dist/commands/rankings.d.ts

@@ -0,0 +1,82 @@
+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 RankingsCommandIO {
+    stdout: TerminalWriter;
+}
+export interface RankingsListCommandOptions {
+    json?: boolean;
+}
+export interface RankingsCurrentCommandOptions {
+    system?: string;
+    user?: string;
+    top?: string;
+    json?: boolean;
+}
+export interface RankingMetricOut {
+    [key: string]: JsonValue;
+    key: string;
+    label: string;
+    direction: "asc" | "desc";
+    unit: string | null;
+}
+export interface RankingDefinitionOut {
+    [key: string]: JsonValue;
+    id: string;
+    name: string;
+    kind: "SYSTEM" | "USER";
+    description: string | null;
+    order_metric: RankingMetricOut;
+    metrics: RankingMetricOut[];
+    latest_as_of: string | null;
+    total_assets: number | null;
+}
+export interface RankingsListResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    system: RankingDefinitionOut[];
+    user: RankingDefinitionOut[];
+    total: number;
+}
+export interface RankingMetricValueOut {
+    [key: string]: JsonValue;
+    key: string;
+    label: string;
+    value: string | number | boolean | null;
+    unit: string | null;
+    direction: "asc" | "desc";
+}
+export interface RankingCurrentRowOut {
+    [key: string]: JsonValue;
+    rank: number;
+    ticker: string;
+    name: string | null;
+    order_metric: RankingMetricValueOut;
+    score: number | null;
+    metrics: Record<string, string | number | boolean | null>;
+}
+export interface RankingCurrentResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    summary_markdown: string;
+    ranking: RankingDefinitionOut;
+    as_of: string | null;
+    top_n: number;
+    count: number;
+    rows: RankingCurrentRowOut[];
+}
+export interface RankingsCommandContext extends CliInvokeContext {
+    io?: RankingsCommandIO;
+}
+type JsonRecord = {
+    [key: string]: JsonValue;
+};
+export declare function registerRankingsCommands(program: Command, context?: RankingsCommandContext): void;
+export declare function runRankingsListCommand(options: RankingsListCommandOptions, context?: RankingsCommandContext): Promise<void>;
+export declare function runRankingsCurrentCommand(options: RankingsCurrentCommandOptions, context?: RankingsCommandContext): Promise<void>;
+export declare function buildRankingsCurrentInput(options: RankingsCurrentCommandOptions): JsonRecord;
+export declare function formatRankingsListHuman(data: RankingsListResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+export declare function formatRankingCurrentHuman(data: RankingCurrentResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+export {};
+//# sourceMappingURL=rankings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rankings.d.ts","sourceRoot":"","sources":["../../src/commands/rankings.ts"],"names":[],"mappings":"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"}

package/dist/commands/rankings.js

@@ -0,0 +1,202 @@
+import { invokeCliCapability } from "../cli/client.js";
+import { createCliValidationError } from "../cli/errors.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerRankingsCommands(program, context = {}) {
+    const rankingsCommand = program
+        .command("rankings")
+        .description("Consulta rankings do sistema e rankings do usuário");
+    rankingsCommand
+        .command("list")
+        .description("Lista rankings disponíveis")
+        .option("--json", "Exibe saída JSON")
+        .action(async (options) => {
+        await runRankingsListCommand(options, context);
+    });
+    rankingsCommand
+        .command("current")
+        .description("Consulta o topo atual de um ranking")
+        .option("--system <id>", "ID do ranking do sistema")
+        .option("--user <id>", "ID do ranking do usuário")
+        .option("--top <n>", "Número de ativos do topo do ranking", "20")
+        .option("--json", "Exibe saída JSON")
+        .action(async (options) => {
+        await runRankingsCurrentCommand(options, context);
+    });
+}
+export async function runRankingsListCommand(options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "rankings.list",
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatRankingsListHuman(response.data, theme)}\n`);
+}
+export async function runRankingsCurrentCommand(options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "rankings.current",
+        input: buildRankingsCurrentInput(options),
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatRankingCurrentHuman(response.data, theme)}\n`);
+}
+export function buildRankingsCurrentInput(options) {
+    const hasSystem = options.system !== undefined;
+    const hasUser = options.user !== undefined;
+    if (Number(hasSystem) + Number(hasUser) !== 1) {
+        throw createCliValidationError("Use exatamente um seletor: --system ou --user.");
+    }
+    const input = {
+        top_n: parseTopOption(options.top),
+    };
+    if (hasSystem) {
+        input.system_id = normalizeRequiredString(options.system, "--system");
+    }
+    if (hasUser) {
+        input.user_ranking_id = parsePositiveInteger(options.user, "--user");
+    }
+    return input;
+}
+export function formatRankingsListHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        theme.label("Rankings"),
+        "",
+        `${theme.label("Total:")} ${formatInteger(data.total)}`,
+    ];
+    lines.push("");
+    lines.push(...formatRankingGroup("Sistema", data.system, theme));
+    lines.push("");
+    lines.push(...formatRankingGroup("Meus rankings", data.user, theme));
+    return lines.join("\n");
+}
+export function formatRankingCurrentHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        theme.label("Ranking atual"),
+        "",
+        `${theme.bold(data.ranking.name)} ${theme.dim(`(${formatRankingKind(data.ranking.kind)})`)}`,
+        `${theme.label("ID:")} ${data.ranking.id}`,
+        `${theme.label("Métrica:")} ${formatMetricDefinition(data.ranking.order_metric)}`,
+        `${theme.label("Top:")} ${formatInteger(data.top_n)}`,
+        `${theme.label("Ativos retornados:")} ${formatInteger(data.count)}`,
+    ];
+    if (data.as_of) {
+        lines.push(`${theme.label("Data:")} ${data.as_of}`);
+    }
+    if (data.rows.length === 0) {
+        lines.push("");
+        lines.push(theme.dim("Nenhum ativo retornado."));
+        return lines.join("\n");
+    }
+    lines.push("");
+    lines.push(...formatRankingRows(data.rows, data.ranking.order_metric.label));
+    return lines.join("\n");
+}
+function formatRankingGroup(title, rankings, theme) {
+    const lines = [
+        `${theme.label(title)} ${theme.dim(`(${formatInteger(rankings.length)})`)}`,
+    ];
+    if (rankings.length === 0) {
+        lines.push(`  ${theme.dim("Nenhum ranking disponível.")}`);
+        return lines;
+    }
+    for (const ranking of rankings) {
+        lines.push(`  ${theme.bold(ranking.id)} - ${ranking.name}`);
+        lines.push(`    ${theme.label("Métrica:")} ${formatMetricDefinition(ranking.order_metric)}`);
+        if (ranking.latest_as_of) {
+            lines.push(`    ${theme.label("Atualizado em:")} ${ranking.latest_as_of}`);
+        }
+        if (ranking.total_assets !== null) {
+            lines.push(`    ${theme.label("Ativos:")} ${formatInteger(ranking.total_assets)}`);
+        }
+        lines.push(`    ${theme.label("Uso:")} ${formatRankingUsage(ranking)}`);
+    }
+    return lines;
+}
+function formatRankingRows(rows, metricLabel) {
+    const metricHeader = truncate(metricLabel, 26);
+    const header = `${"#".padEnd(4)}${"Ativo".padEnd(12)}${metricHeader}`;
+    const divider = "-".repeat(header.length);
+    const lines = [header, divider];
+    for (const row of rows) {
+        lines.push(`${formatInteger(row.rank).padEnd(4)}${row.ticker.padEnd(12)}${formatMetricValue(row.order_metric)}`);
+    }
+    return lines;
+}
+function formatRankingUsage(ranking) {
+    if (ranking.kind === "USER") {
+        const id = ranking.id.startsWith("user:")
+            ? ranking.id.slice("user:".length)
+            : ranking.id;
+        return `quantbrasil rankings current --user ${id} --top 20`;
+    }
+    return `quantbrasil rankings current --system ${ranking.id} --top 20`;
+}
+function formatRankingKind(kind) {
+    return kind === "SYSTEM" ? "sistema" : "usuário";
+}
+function formatMetricDefinition(metric) {
+    return `${metric.label} (${metric.direction})`;
+}
+function formatMetricValue(metric) {
+    if (metric.value === null) {
+        return "-";
+    }
+    if (typeof metric.value === "number") {
+        if (metric.unit === "ratio") {
+            return `${formatNumber(metric.value * 100)}%`;
+        }
+        return formatNumber(metric.value);
+    }
+    return String(metric.value);
+}
+function parseTopOption(rawTop) {
+    if (rawTop === undefined) {
+        return 20;
+    }
+    return parsePositiveInteger(rawTop, "--top");
+}
+function parsePositiveInteger(rawValue, label) {
+    const normalized = normalizeRequiredString(rawValue, label);
+    const parsed = Number.parseInt(normalized, 10);
+    if (!Number.isInteger(parsed) ||
+        parsed <= 0 ||
+        String(parsed) !== normalized) {
+        throw createCliValidationError(`${label} deve ser um inteiro positivo.`);
+    }
+    return parsed;
+}
+function normalizeRequiredString(rawValue, label) {
+    const normalized = rawValue?.trim();
+    if (!normalized) {
+        throw createCliValidationError(`${label} não pode ser vazio.`);
+    }
+    return normalized;
+}
+function formatInteger(value) {
+    return new Intl.NumberFormat("pt-BR", {
+        maximumFractionDigits: 0,
+    }).format(value);
+}
+function formatNumber(value) {
+    return new Intl.NumberFormat("pt-BR", {
+        maximumFractionDigits: 4,
+    }).format(value);
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength - 3)}...`;
+}

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from "./commands/capabilities.js";
 export * from "./commands/init.js";
 export * from "./commands/market.js";
 export * from "./commands/portfolios.js";
+export * from "./commands/rankings.js";
 export * from "./commands/screening.js";
 export * from "./commands/skills.js";
 export * from "./commands/status.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,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,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"}

package/dist/index.js

@@ -8,6 +8,7 @@ export * from "./commands/capabilities.js";
 export * from "./commands/init.js";
 export * from "./commands/market.js";
 export * from "./commands/portfolios.js";
+export * from "./commands/rankings.js";
 export * from "./commands/screening.js";
 export * from "./commands/skills.js";
 export * from "./commands/status.js";

package/dist/vendor/core/capabilities/index.d.ts

@@ -2,6 +2,7 @@ export * from "./types.js";
 export * from "./shared.js";
 export * from "./market.js";
 export * from "./assets.js";
+export * from "./rankings.js";
 export * from "./screening.js";
 export * from "./portfolios.js";
 export * from "./registry.js";

package/dist/vendor/core/capabilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

package/dist/vendor/core/capabilities/index.js

@@ -2,6 +2,7 @@ export * from "./types.js";
 export * from "./shared.js";
 export * from "./market.js";
 export * from "./assets.js";
+export * from "./rankings.js";
 export * from "./screening.js";
 export * from "./portfolios.js";
 export * from "./registry.js";

package/dist/vendor/core/capabilities/rankings.d.ts

@@ -0,0 +1,83 @@
+export declare const rankingsCapabilities: readonly [{
+    readonly id: "rankings.list";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista rankings do sistema e rankings do usuário disponíveis para consulta atual.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/rankings/list";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "RankingsListResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "rankings";
+        readonly command: "list";
+        readonly summary: "Lista rankings do sistema e rankings do usuário.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil rankings list"];
+    };
+    readonly tool: {
+        readonly name: "qb_rankings_list";
+        readonly title: "Listar rankings";
+    };
+    readonly outputModes: readonly ["json", "human"];
+}, {
+    readonly id: "rankings.current";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Retorna os ativos atuais no topo de um ranking do sistema ou ranking do usuário.";
+    readonly http: {
+        readonly method: "POST";
+        readonly path: "/api/desk/tools/rankings/current";
+        readonly inputMode: "json_body";
+        readonly schemas: {
+            readonly request: "RankingCurrentRequest";
+            readonly response: "RankingCurrentResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "rankings";
+        readonly command: "current";
+        readonly summary: "Consulta o topo atual de um ranking.";
+        readonly positional: readonly [];
+        readonly options: readonly [{
+            readonly kind: "option";
+            readonly flag: "--system";
+            readonly name: "system_id";
+            readonly type: "string";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "ranking_selector";
+            readonly description: "ID de ranking do sistema retornado por `rankings list`, por exemplo momentum-90d.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--user";
+            readonly name: "user_ranking_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "ranking_selector";
+            readonly description: "ID numérico de ranking do usuário retornado por `rankings list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--top";
+            readonly name: "top_n";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "N";
+            readonly defaultValue: 20;
+            readonly description: "Número de ativos do topo do ranking a retornar.";
+        }];
+        readonly examples: readonly ["quantbrasil rankings current --system momentum-90d --top 20", "quantbrasil rankings current --system magic-formula --top 10", "quantbrasil rankings current --user 123 --top 20"];
+    };
+    readonly tool: {
+        readonly name: "qb_rankings_current";
+        readonly title: "Consultar ranking atual";
+    };
+    readonly outputModes: readonly ["json", "human"];
+}];
+//# sourceMappingURL=rankings.d.ts.map

package/dist/vendor/core/capabilities/rankings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankings.d.ts","sourceRoot":"","sources":["../../src/capabilities/rankings.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgGmB,CAAC"}

package/dist/vendor/core/capabilities/rankings.js

@@ -0,0 +1,95 @@
+import { publicRuntimeVisibility, standardOutputModes } from "./shared.js";
+const rankingSelectorExclusiveGroup = "ranking_selector";
+export const rankingsCapabilities = [
+    {
+        id: "rankings.list",
+        kind: "read",
+        visibility: publicRuntimeVisibility,
+        description: "Lista rankings do sistema e rankings do usuário disponíveis para consulta atual.",
+        http: {
+            method: "GET",
+            path: "/api/desk/tools/rankings/list",
+            inputMode: "none",
+            schemas: {
+                request: null,
+                response: "RankingsListResponse",
+            },
+        },
+        cli: {
+            group: "rankings",
+            command: "list",
+            summary: "Lista rankings do sistema e rankings do usuário.",
+            positional: [],
+            options: [],
+            examples: ["quantbrasil rankings list"],
+        },
+        tool: {
+            name: "qb_rankings_list",
+            title: "Listar rankings",
+        },
+        outputModes: standardOutputModes,
+    },
+    {
+        id: "rankings.current",
+        kind: "read",
+        visibility: publicRuntimeVisibility,
+        description: "Retorna os ativos atuais no topo de um ranking do sistema ou ranking do usuário.",
+        http: {
+            method: "POST",
+            path: "/api/desk/tools/rankings/current",
+            inputMode: "json_body",
+            schemas: {
+                request: "RankingCurrentRequest",
+                response: "RankingCurrentResponse",
+            },
+        },
+        cli: {
+            group: "rankings",
+            command: "current",
+            summary: "Consulta o topo atual de um ranking.",
+            positional: [],
+            options: [
+                {
+                    kind: "option",
+                    flag: "--system",
+                    name: "system_id",
+                    type: "string",
+                    required: false,
+                    placeholder: "ID",
+                    exclusiveGroup: rankingSelectorExclusiveGroup,
+                    description: "ID de ranking do sistema retornado por `rankings list`, por exemplo momentum-90d.",
+                },
+                {
+                    kind: "option",
+                    flag: "--user",
+                    name: "user_ranking_id",
+                    type: "integer",
+                    required: false,
+                    placeholder: "ID",
+                    exclusiveGroup: rankingSelectorExclusiveGroup,
+                    description: "ID numérico de ranking do usuário retornado por `rankings list`.",
+                },
+                {
+                    kind: "option",
+                    flag: "--top",
+                    name: "top_n",
+                    type: "integer",
+                    required: false,
+                    placeholder: "N",
+                    defaultValue: 20,
+                    description: "Número de ativos do topo do ranking a retornar.",
+                },
+            ],
+            examples: [
+                "quantbrasil rankings current --system momentum-90d --top 20",
+                "quantbrasil rankings current --system magic-formula --top 10",
+                "quantbrasil rankings current --user 123 --top 20",
+            ],
+        },
+        tool: {
+            name: "qb_rankings_current",
+            title: "Consultar ranking atual",
+        },
+        outputModes: standardOutputModes,
+    },
+];

package/dist/vendor/core/capabilities/registry.d.ts

@@ -138,6 +138,87 @@ export declare const capabilityRegistry: readonly [{
         readonly title: "Get asset overview";
     };
     readonly outputModes: readonly ["json", "human"];
+}, {
+    readonly id: "rankings.list";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista rankings do sistema e rankings do usuário disponíveis para consulta atual.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/rankings/list";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "RankingsListResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "rankings";
+        readonly command: "list";
+        readonly summary: "Lista rankings do sistema e rankings do usuário.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil rankings list"];
+    };
+    readonly tool: {
+        readonly name: "qb_rankings_list";
+        readonly title: "Listar rankings";
+    };
+    readonly outputModes: readonly ["json", "human"];
+}, {
+    readonly id: "rankings.current";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Retorna os ativos atuais no topo de um ranking do sistema ou ranking do usuário.";
+    readonly http: {
+        readonly method: "POST";
+        readonly path: "/api/desk/tools/rankings/current";
+        readonly inputMode: "json_body";
+        readonly schemas: {
+            readonly request: "RankingCurrentRequest";
+            readonly response: "RankingCurrentResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "rankings";
+        readonly command: "current";
+        readonly summary: "Consulta o topo atual de um ranking.";
+        readonly positional: readonly [];
+        readonly options: readonly [{
+            readonly kind: "option";
+            readonly flag: "--system";
+            readonly name: "system_id";
+            readonly type: "string";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "ranking_selector";
+            readonly description: "ID de ranking do sistema retornado por `rankings list`, por exemplo momentum-90d.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--user";
+            readonly name: "user_ranking_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "ranking_selector";
+            readonly description: "ID numérico de ranking do usuário retornado por `rankings list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--top";
+            readonly name: "top_n";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "N";
+            readonly defaultValue: 20;
+            readonly description: "Número de ativos do topo do ranking a retornar.";
+        }];
+        readonly examples: readonly ["quantbrasil rankings current --system momentum-90d --top 20", "quantbrasil rankings current --system magic-formula --top 10", "quantbrasil rankings current --user 123 --top 20"];
+    };
+    readonly tool: {
+        readonly name: "qb_rankings_current";
+        readonly title: "Consultar ranking atual";
+    };
+    readonly outputModes: readonly ["json", "human"];
 }, {
     readonly id: "screening.universes";
     readonly kind: "read";
@@ -1032,6 +1113,87 @@ export declare function getCapabilityById(id: CapabilityId): {
         readonly title: "Get asset overview";
     };
     readonly outputModes: readonly ["json", "human"];
+} | {
+    readonly id: "rankings.list";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista rankings do sistema e rankings do usuário disponíveis para consulta atual.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/rankings/list";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "RankingsListResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "rankings";
+        readonly command: "list";
+        readonly summary: "Lista rankings do sistema e rankings do usuário.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil rankings list"];
+    };
+    readonly tool: {
+        readonly name: "qb_rankings_list";
+        readonly title: "Listar rankings";
+    };
+    readonly outputModes: readonly ["json", "human"];
+} | {
+    readonly id: "rankings.current";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Retorna os ativos atuais no topo de um ranking do sistema ou ranking do usuário.";
+    readonly http: {
+        readonly method: "POST";
+        readonly path: "/api/desk/tools/rankings/current";
+        readonly inputMode: "json_body";
+        readonly schemas: {
+            readonly request: "RankingCurrentRequest";
+            readonly response: "RankingCurrentResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "rankings";
+        readonly command: "current";
+        readonly summary: "Consulta o topo atual de um ranking.";
+        readonly positional: readonly [];
+        readonly options: readonly [{
+            readonly kind: "option";
+            readonly flag: "--system";
+            readonly name: "system_id";
+            readonly type: "string";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "ranking_selector";
+            readonly description: "ID de ranking do sistema retornado por `rankings list`, por exemplo momentum-90d.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--user";
+            readonly name: "user_ranking_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "ranking_selector";
+            readonly description: "ID numérico de ranking do usuário retornado por `rankings list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--top";
+            readonly name: "top_n";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "N";
+            readonly defaultValue: 20;
+            readonly description: "Número de ativos do topo do ranking a retornar.";
+        }];
+        readonly examples: readonly ["quantbrasil rankings current --system momentum-90d --top 20", "quantbrasil rankings current --system magic-formula --top 10", "quantbrasil rankings current --user 123 --top 20"];
+    };
+    readonly tool: {
+        readonly name: "qb_rankings_current";
+        readonly title: "Consultar ranking atual";
+    };
+    readonly outputModes: readonly ["json", "human"];
 } | {
     readonly id: "screening.universes";
     readonly kind: "read";

package/dist/vendor/core/capabilities/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/capabilities/registry.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKrB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAErE,eAAO,MAAM,sBAAsB,EAE9B,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/capabilities/registry.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMrB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAErE,eAAO,MAAM,sBAAsB,EAE9B,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjD"}

package/dist/vendor/core/capabilities/registry.js

@@ -1,10 +1,12 @@
 import { assetCapabilities } from "./assets.js";
 import { marketCapabilities } from "./market.js";
 import { portfolioCapabilities } from "./portfolios.js";
+import { rankingsCapabilities } from "./rankings.js";
 import { screeningCapabilities } from "./screening.js";
 export const capabilityRegistry = [
     ...marketCapabilities,
     ...assetCapabilities,
+    ...rankingsCapabilities,
     ...screeningCapabilities,
     ...portfolioCapabilities,
 ];

package/dist/vendor/core/capabilities/types.d.ts

@@ -1,6 +1,6 @@
 export type CapabilityVisibility = "cli" | "opencode";
 export type CapabilityKind = "read" | "mutation";
-export type CapabilityGroup = "market" | "assets" | "screening" | "watchlists" | "holdings";
+export type CapabilityGroup = "market" | "assets" | "rankings" | "screening" | "watchlists" | "holdings";
 export type CapabilityHttpMethod = "GET" | "POST";
 export type CapabilityInputMode = "none" | "query" | "json_body";
 export type CapabilityOutputMode = "json" | "human";

package/dist/vendor/core/capabilities/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/capabilities/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/capabilities/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantbrasil/cli",
-  "version": "0.1.0-beta.8",
+  "version": "0.1.0-beta.9",
   "type": "module",
   "description": "Public QuantBrasil CLI for deterministic operations",
   "repository": {

package/skills/quantbrasil/SKILL.md

@@ -1,18 +1,19 @@
 ---
 name: quantbrasil
-description: Use this skill when a user asks for QuantBrasil-supported market or investing data/actions through the QuantBrasil CLI, including asset lookup, prices, asset analysis, watchlists, holdings, screening, historical return, beta, and VaR, even if they do not explicitly mention QuantBrasil.
+description: Use this skill when a user asks for QuantBrasil-supported market or investing data/actions through the QuantBrasil CLI, including asset lookup, prices, asset analysis, rankings, watchlists, holdings, screening, historical return, beta, and VaR, even if they do not explicitly mention QuantBrasil.
 ---
 
 # QuantBrasil CLI
 
-Use this skill when the user asks for market or investing data/actions that QuantBrasil supports, including asset lookup, prices, asset analysis, watchlists, holdings, screening, and holding metrics.
+Use this skill when the user asks for market or investing data/actions that QuantBrasil supports, including asset lookup, prices, asset analysis, rankings, watchlists, holdings, screening, and holding metrics.
 
 ## Routing
 
 - Use this skill even when the user does not say "QuantBrasil" if the request fits the supported market or investing surface.
-- Most end-user QuantBrasil requests are expected in pt-BR; Portuguese prompts about ativos, carteiras, cotações, screening, retorno, beta, VaR, watchlists, or Ibovespa should trigger this skill when they map to the supported CLI surface.
-- For QuantBrasil-supported market, asset, screening, watchlist, holding, or holding metric data, use the CLI before generic web or finance search.
+- Most end-user QuantBrasil requests are expected in pt-BR; Portuguese prompts about ativos, rankings, Magic Formula, momentum, ranking fatorial, carteiras, cotações, screening, retorno, beta, VaR, watchlists, or Ibovespa should trigger this skill when they map to the supported CLI surface.
+- For QuantBrasil-supported market, asset, ranking, screening, watchlist, holding, or holding metric data, use the CLI before generic web or finance search.
 - When the request mentions portfolios, carteiras, watchlists, holdings, target weights, positions, historical return, beta, VaR, screening universes, or saved compositions, load [`references/portfolios.md`](./references/portfolios.md) before choosing commands.
+- When the request asks for Magic Formula, momentum rankings, top ranked assets, ranking fatorial, rankings do usuário, or ordered asset lists, load [`references/rankings.md`](./references/rankings.md) before choosing commands.
 - When the request mentions IFR/RSI filters, sobrevendido, sobrecomprado, indicator screening, technical screening rules, or screening indicators, load [`references/screening.md`](./references/screening.md) before building the request JSON.
 - Use `quantbrasil` when available on PATH.
 - If `quantbrasil` is not found, report that the CLI binary is not on PATH and ask the user to install it or fix PATH.
@@ -23,6 +24,7 @@ Use this skill when the user asks for market or investing data/actions that Quan
   - asset discovery: `quantbrasil market assets`
   - price lookup: `quantbrasil market price <ticker>`
   - richer asset analysis: `quantbrasil assets overview <ticker> --sections ...`
+  - ranked asset lists: `quantbrasil rankings list|current ...`
   - watchlist details and changes: `quantbrasil watchlists ...`
   - holding details and historical return: `quantbrasil holdings ...`
   - indicator screening over saved universes: `quantbrasil screening universes|indicators|run ...`
@@ -35,6 +37,7 @@ Use this skill when the user asks for market or investing data/actions that Quan
 
 - Load [`references/workflows.md`](./references/workflows.md) when the user describes an investing task but does not name an exact command, or when a task spans discovery plus a follow-up action.
 - Load [`references/cli.md`](./references/cli.md) when you need exact command syntax, flags, examples, or supported `--sections` values.
+- Load [`references/rankings.md`](./references/rankings.md) when the user asks for Magic Formula, momentum rankings, top ranked assets, ranking fatorial, rankings do usuário, or current ordered lists.
 - Load [`references/portfolios.md`](./references/portfolios.md) when the request mentions portfolios, carteiras, watchlists, holdings, target weights, positions, historical return, beta, VaR, screening universes, or saved compositions.
 - Load [`references/screening.md`](./references/screening.md) when the user asks for IFR/RSI filters, sobrevendido/sobrecomprado assets, indicator screening, technical filter JSON, screening indicators, or examples of `ScreenerRequest`.
 - Load [`references/costs.md`](./references/costs.md) before chaining heavy reads, choosing between overview/screening/holding metrics, or answering cost-sensitive agent workflow questions.

package/skills/quantbrasil/references/cli.md

@@ -46,6 +46,27 @@ Valid `--sections`:
 - `fundamentals`
 - `rankings`
 
+## Rankings
+
+```bash
+quantbrasil rankings list
+quantbrasil rankings list --json
+quantbrasil rankings current --system momentum-90d --top 20
+quantbrasil rankings current --system magic-formula --top 10
+quantbrasil rankings current --user 123 --top 20
+quantbrasil rankings current --system momentum-90d --top 20 --json
+```
+
+Rules:
+
+- use `rankings list` to discover rankings before using ids
+- system rankings use stable ids such as `magic-formula`, `momentum-90d`, `dividend-yield`, and `momentum-double`
+- user rankings use the numeric id returned by `rankings list`
+- use exactly one selector: `--system` or `--user`
+- `--top` controls how many ranked assets are returned
+- `current` returns the ordered rows and the metric used to order the ranking
+- use `--json` when the result will be parsed by an agent or script
+
 ## Watchlists and holdings
 
 Watchlists:

package/skills/quantbrasil/references/rankings.md

@@ -0,0 +1,60 @@
+# Rankings
+
+Use rankings for order-first questions: Magic Formula, momentum leaders,
+dividend-yield leaders, Momentum Double, or saved user rankings. A ranking
+returns an ordered asset list plus the metric used to order it.
+
+## Discovery
+
+Always discover ids before running a ranking unless the user already gave an
+exact id.
+
+```bash
+quantbrasil rankings list
+```
+
+The list is grouped into:
+
+- system rankings: platform-provided rankings with stable ids
+- user rankings: saved rankings owned by the authenticated user
+
+## Current ranking
+
+System ranking:
+
+```bash
+quantbrasil rankings current --system momentum-90d --top 20
+quantbrasil rankings current --system magic-formula --top 10
+```
+
+User ranking:
+
+```bash
+quantbrasil rankings current --user 123 --top 20
+```
+
+Rules:
+
+- use exactly one selector: `--system` or `--user`
+- `--top` is the number of ranked assets to return
+- use `--json` when another step needs to parse tickers, rank, score, or metric values
+- do not use `factor:<id>` in command syntax; ranking fatorial is a saved user ranking and uses `--user <id>`
+
+## Ranking vs screening
+
+Use rankings when the user starts from an ordered list:
+
+- "top 20 do momentum"
+- "top 10 Magic Formula"
+- "meu ranking de qualidade"
+- "ativos com maior dividend yield"
+
+Use screening when the user starts from a condition:
+
+- "IFR14 abaixo de 30"
+- "ativos sobrevendidos"
+- "preço acima da média móvel"
+
+If the user wants both ranking and a condition, keep the steps explicit. First
+get the ranking with `--json`, then apply the follow-up workflow only if the CLI
+surface supports that next step. Do not invent ranking-specific screening flags.

package/skills/quantbrasil/references/workflows.md

@@ -5,6 +5,7 @@
 - asset price, quote, or daily move → `market price`
 - supported assets, tickers, or market universe → `market assets`
 - asset performance, technicals, risk, fundamentals, or ranking → `assets overview`
+- current ordered asset lists such as Magic Formula, momentum, or user rankings → `rankings list`, then `rankings current`
 - watchlist details or changes → `watchlists ...`
 - holding details or changes → `holdings ...`
 - holding return, beta, risk, VaR, or comparison → `holdings historical-return|beta|var`
@@ -62,6 +63,28 @@ Guidance:
 
 Avoid asking for every section unless user clearly wants full report.
 
+## Get current ranked assets
+
+Use this when the user asks for an ordered list such as top Magic Formula,
+momentum leaders, dividend-yield leaders, Momentum Double, or a saved user
+ranking.
+
+```bash
+quantbrasil rankings list
+quantbrasil rankings current --system momentum-90d --top 20
+quantbrasil rankings current --system magic-formula --top 10
+quantbrasil rankings current --user 123 --top 20
+```
+
+Rules:
+
+- rankings answer order-first questions
+- system rankings use `--system <id>` from `rankings list`
+- user rankings use `--user <id>` from `rankings list`
+- do not call user rankings "factor:" in command syntax; ranking fatorial is a saved user ranking
+- use `--json` if another step needs to parse tickers, ranks, or ordering metrics
+- do not route ranking-first questions through screening unless the user asks for indicator conditions
+
 ## Analyze saved holding
 
 1. Discover holding id.