@quantbrasil/cli 0.1.0-beta.6 → 0.1.0-beta.7

package/README.md

@@ -72,6 +72,39 @@ 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 screening universes
+quantbrasil screening run --system acoes-mais-liquidas --query-file ./screening.json
+quantbrasil screening run --watchlist 93 --query-file ./screening.json --limit 25
+cat ./screening.json | quantbrasil screening run --holding 182 --query-file -
+```
+
+Example `screening.json`:
+
+```json
+{
+  "query": {
+    "comparison": {
+      "left": {
+        "indicator": {
+          "name": "RSI",
+          "timeframe": "D1",
+          "offset": 0,
+          "params": {
+            "period": 14
+          }
+        }
+      },
+      "operator": "lt",
+      "right": {
+        "constant": {
+          "value": 30
+        }
+      }
+    }
+  },
+  "limit": 50,
+  "sort": "ticker"
+}
 ```
 
 ## Local config

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 { runScreeningRunCommand, runScreeningUniversesCommand } from "../commands/screening.js";
 import { runSkillsInstallCommand } from "../commands/skills.js";
 import { runStatusCommand } from "../commands/status.js";
 import { type TerminalWriter } from "./terminal.js";
@@ -25,6 +26,7 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
+export { runScreeningRunCommand, runScreeningUniversesCommand };
 export { runHoldingBetaCommand, runHoldingCreateCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, };
 export { runSkillsInstallCommand };
 //# sourceMappingURL=index.d.ts.map

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,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,gBAAgB,EACjB,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;CACnC;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CA2DzE;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,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"}
+{"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,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,gBAAgB,EACjB,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;CACnC;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAiEzE;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,sBAAsB,EAAE,4BAA4B,EAAE,CAAC;AAChE,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"}

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 { registerScreeningCommands, runScreeningRunCommand, runScreeningUniversesCommand, } from "../commands/screening.js";
 import { registerSkillsCommands, runSkillsInstallCommand, } from "../commands/skills.js";
 import { registerStatusFlag, runStatusCommand, } from "../commands/status.js";
 import { buildCliErrorPayload, formatCliErrorMessage, normalizeCliError, shouldEmitJsonError, } from "./errors.js";
@@ -42,6 +43,11 @@ export function createCliProgram(options = {}) {
         fetch: options.fetch,
         now: options.now,
     };
+    const screeningContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+    };
     const skillsContext = {
         io: options.io,
         env: options.env,
@@ -65,6 +71,7 @@ export function createCliProgram(options = {}) {
     registerInitCommand(program, initContext);
     registerMarketCommands(program, marketContext);
     registerPortfoliosCommands(program, portfoliosContext);
+    registerScreeningCommands(program, screeningContext);
     registerSkillsCommands(program, skillsContext);
     registerStatusFlag(program, statusContext);
     return program;
@@ -131,5 +138,6 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
+export { runScreeningRunCommand, runScreeningUniversesCommand };
 export { runHoldingBetaCommand, runHoldingCreateCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, };
 export { runSkillsInstallCommand };

package/dist/commands/screening.d.ts

@@ -0,0 +1,76 @@
+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 ScreeningCommandIO {
+    stdout: TerminalWriter;
+}
+export interface ScreeningUniversesCommandOptions {
+    json?: boolean;
+}
+export interface ScreeningRunCommandOptions {
+    system?: string;
+    watchlist?: string;
+    holding?: string;
+    queryFile?: string;
+    limit?: string;
+    sort?: string;
+    json?: boolean;
+}
+export interface ScreeningUniverseOut {
+    [key: string]: JsonValue;
+    id: number;
+    name: string;
+    kind: "SYSTEM" | "WATCHLIST" | "HOLDING";
+    slug: string | null;
+    symbol_count: number;
+}
+export interface ScreeningUniversesResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    system: ScreeningUniverseOut[];
+    watchlists: ScreeningUniverseOut[];
+    holdings: ScreeningUniverseOut[];
+    total: number;
+}
+export interface IndicatorResult {
+    [key: string]: JsonValue;
+    value: number;
+    display_name: string;
+    unit: string | null;
+    context: {
+        [key: string]: JsonValue;
+    } | null;
+}
+export interface ScreenerResultItem {
+    [key: string]: JsonValue;
+    ticker: string;
+    price: number;
+    indicators: Record<string, IndicatorResult>;
+}
+export interface ScreenerResponse {
+    [key: string]: JsonValue;
+    count: number;
+    results: ScreenerResultItem[];
+}
+export interface ScreeningRunResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    summary_markdown: string;
+    universe: ScreeningUniverseOut;
+    result: ScreenerResponse;
+}
+export interface ScreeningCommandContext extends CliInvokeContext {
+    io?: ScreeningCommandIO;
+}
+type JsonRecord = {
+    [key: string]: JsonValue;
+};
+export declare function registerScreeningCommands(program: Command, context?: ScreeningCommandContext): void;
+export declare function runScreeningUniversesCommand(options: ScreeningUniversesCommandOptions, context?: ScreeningCommandContext): Promise<void>;
+export declare function runScreeningRunCommand(options: ScreeningRunCommandOptions, context?: ScreeningCommandContext): Promise<void>;
+export declare function buildScreeningRunInput(options: ScreeningRunCommandOptions): Promise<JsonRecord>;
+export declare function formatScreeningUniversesHuman(data: ScreeningUniversesResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+export declare function formatScreeningRunHuman(data: ScreeningRunResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+export {};
+//# sourceMappingURL=screening.d.ts.map

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

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

package/dist/commands/screening.js

@@ -0,0 +1,298 @@
+import { readFile } from "node:fs/promises";
+import { screeningSortValues } from "../vendor/core/capabilities/index.js";
+import { invokeCliCapability } from "../cli/client.js";
+import { createCliValidationError } from "../cli/errors.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerScreeningCommands(program, context = {}) {
+    const screeningCommand = program
+        .command("screening")
+        .description("Executa screening de indicadores em universos salvos");
+    screeningCommand
+        .command("universes")
+        .description("Lista universos salvos disponíveis para screening de indicadores")
+        .option("--json", "Exibe saída JSON")
+        .action(async (options) => {
+        await runScreeningUniversesCommand(options, context);
+    });
+    screeningCommand
+        .command("run")
+        .description("Executa screening de indicadores a partir de um ScreenerRequest JSON")
+        .option("--system <slug>", "Slug da carteira do sistema")
+        .option("--watchlist <id>", "ID da watchlist")
+        .option("--holding <id>", "ID da carteira")
+        .requiredOption("--query-file <path>", "Caminho para um ScreenerRequest JSON completo, ou - para stdin")
+        .option("--limit <limit>", "Sobrescreve o limit de topo do ScreenerRequest")
+        .option("--sort <sort>", "Sobrescreve o sort de topo do ScreenerRequest")
+        .option("--json", "Exibe saída JSON")
+        .action(async (options) => {
+        await runScreeningRunCommand(options, context);
+    });
+}
+export async function runScreeningUniversesCommand(options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "screening.universes",
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatScreeningUniversesHuman(response.data, theme)}\n`);
+}
+export async function runScreeningRunCommand(options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const input = await buildScreeningRunInput(options);
+    const response = await invokeCliCapability({
+        capability: "screening.run",
+        input,
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatScreeningRunHuman(response.data, theme)}\n`);
+}
+export async function buildScreeningRunInput(options) {
+    const selector = parseScreeningSelector(options);
+    const queryFile = normalizeRequiredPath(options.queryFile);
+    const request = await readScreenerRequest(queryFile);
+    if (options.limit !== undefined) {
+        request.limit = parseLimitOption(options.limit);
+    }
+    if (options.sort !== undefined) {
+        request.sort = parseSortOption(options.sort);
+    }
+    return {
+        ...selector,
+        request,
+    };
+}
+export function formatScreeningUniversesHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        theme.label("Universos de screening"),
+        "",
+        `${theme.label("Total:")} ${formatInteger(data.total)}`,
+    ];
+    appendUniverseGroup(lines, theme, "Carteiras do sistema", data.system);
+    appendUniverseGroup(lines, theme, "Watchlists", data.watchlists);
+    appendUniverseGroup(lines, theme, "Carteiras", data.holdings);
+    return lines.join("\n");
+}
+export function formatScreeningRunHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        theme.label("Screening de indicadores"),
+        "",
+        `${theme.bold(data.universe.name)} ${theme.dim(`- ${formatUniverseKind(data.universe.kind)}`)}`,
+        `${theme.label("Seletor:")} ${formatUniverseSelector(data.universe)}`,
+        `${theme.label("Ativos encontrados:")} ${formatInteger(data.result.count)}`,
+    ];
+    if (data.summary_markdown.trim()) {
+        lines.push("");
+        lines.push(data.summary_markdown);
+    }
+    if (data.result.results.length === 0) {
+        lines.push("");
+        lines.push("Nenhum ativo encontrado.");
+        return lines.join("\n");
+    }
+    const indicatorKeys = collectIndicatorKeys(data.result.results);
+    const visibleIndicatorKeys = indicatorKeys.slice(0, 4);
+    lines.push("");
+    lines.push(formatResultTable(data.result.results, visibleIndicatorKeys, theme));
+    if (indicatorKeys.length > visibleIndicatorKeys.length) {
+        lines.push("");
+        lines.push("Use --json para inspecionar todas as colunas de indicadores.");
+    }
+    return lines.join("\n");
+}
+function parseScreeningSelector(options) {
+    const selectorCount = [
+        options.system,
+        options.watchlist,
+        options.holding,
+    ].filter(value => value !== undefined).length;
+    if (selectorCount !== 1) {
+        throw createCliValidationError("Use exatamente um seletor: --system, --watchlist ou --holding.");
+    }
+    if (options.system !== undefined) {
+        const systemSlug = options.system.trim().toLowerCase();
+        if (!systemSlug) {
+            throw createCliValidationError("O slug da carteira do sistema é obrigatório.");
+        }
+        return { system_slug: systemSlug };
+    }
+    if (options.watchlist !== undefined) {
+        return {
+            watchlist_id: parsePositiveInteger(options.watchlist, "ID da watchlist"),
+        };
+    }
+    return {
+        holding_id: parsePositiveInteger(String(options.holding), "ID da carteira"),
+    };
+}
+function normalizeRequiredPath(value) {
+    const normalized = value?.trim();
+    if (!normalized) {
+        throw createCliValidationError("Use --query-file com um caminho JSON ou -.");
+    }
+    return normalized;
+}
+async function readScreenerRequest(path) {
+    let text;
+    try {
+        text = path === "-" ? await readStdinText() : await readFile(path, "utf8");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw createCliValidationError(`Não foi possível ler o JSON da consulta: ${message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw createCliValidationError(`Não foi possível interpretar o JSON da consulta: ${message}`);
+    }
+    if (!isJsonRecord(parsed)) {
+        throw createCliValidationError("O JSON da consulta deve ser um objeto.");
+    }
+    return parsed;
+}
+async function readStdinText() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(typeof chunk === "string" ? chunk : chunk.toString("utf8"));
+    }
+    return chunks.join("");
+}
+function parseLimitOption(value) {
+    const parsed = parsePositiveInteger(value, "limite");
+    if (parsed > 500) {
+        throw createCliValidationError("O limite deve ser um inteiro entre 1 e 500.");
+    }
+    return parsed;
+}
+function parsePositiveInteger(value, fieldName) {
+    const normalized = value.trim();
+    if (!/^\d+$/.test(normalized)) {
+        throw createCliValidationError(`O valor de ${fieldName} deve ser um inteiro positivo.`);
+    }
+    const parsed = Number(normalized);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+        throw createCliValidationError(`O valor de ${fieldName} deve ser um inteiro positivo.`);
+    }
+    return parsed;
+}
+function parseSortOption(value) {
+    const normalized = value.trim().toLowerCase();
+    if (!screeningSortValues.includes(normalized)) {
+        throw createCliValidationError("A ordenação deve ser uma destas opções: price, ticker.");
+    }
+    return normalized;
+}
+function appendUniverseGroup(lines, theme, title, universes) {
+    lines.push("");
+    lines.push(`${theme.label(title)} ${theme.dim(`(${formatInteger(universes.length)})`)}`);
+    if (universes.length === 0) {
+        lines.push("  nenhum item");
+        return;
+    }
+    for (const universe of universes) {
+        lines.push(`  ${theme.bold(formatUniverseSelector(universe))} ${theme.dim("-")} ${universe.name}`);
+        lines.push(`    ${theme.label("Ativos:")} ${formatInteger(universe.symbol_count)}`);
+    }
+}
+function formatUniverseSelector(universe) {
+    if (universe.kind === "SYSTEM") {
+        return `--system ${universe.slug ?? universe.id}`;
+    }
+    if (universe.kind === "WATCHLIST") {
+        return `--watchlist ${universe.id}`;
+    }
+    return `--holding ${universe.id}`;
+}
+function formatUniverseKind(kind) {
+    if (kind === "SYSTEM") {
+        return "Carteira do sistema";
+    }
+    if (kind === "WATCHLIST") {
+        return "Watchlist";
+    }
+    return "Carteira";
+}
+function collectIndicatorKeys(results) {
+    const keys = [];
+    const seen = new Set();
+    for (const result of results) {
+        for (const key of Object.keys(result.indicators)) {
+            if (seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            keys.push(key);
+        }
+    }
+    return keys;
+}
+function formatResultTable(results, indicatorKeys, theme) {
+    const headers = [
+        "Ativo",
+        "Preço",
+        ...indicatorKeys.map(key => truncate(results[0]?.indicators[key]?.display_name ?? key, 18)),
+    ];
+    const rows = results.map(result => [
+        result.ticker,
+        formatNumber(result.price),
+        ...indicatorKeys.map(key => formatIndicatorValue(result.indicators[key])),
+    ]);
+    const widths = headers.map((header, index) => Math.max(header.length, ...rows.map(row => row[index]?.length ?? 0)));
+    const lines = [
+        headers
+            .map((header, index) => header.padEnd(widths[index] ?? 0))
+            .join("  "),
+        widths.map(width => "-".repeat(width)).join("  "),
+    ];
+    for (const row of rows) {
+        lines.push(row.map((value, index) => value.padEnd(widths[index] ?? 0)).join("  "));
+    }
+    return lines
+        .map((line, index) => (index === 0 ? theme.label(line) : line))
+        .join("\n");
+}
+function formatIndicatorValue(indicator) {
+    if (!indicator) {
+        return "n/d";
+    }
+    const formatted = formatNumber(indicator.value);
+    if (!indicator.unit) {
+        return formatted;
+    }
+    return indicator.unit === "%"
+        ? `${formatted}%`
+        : `${formatted} ${indicator.unit}`;
+}
+function formatInteger(value) {
+    return new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: 0,
+    }).format(value);
+}
+function formatNumber(value) {
+    return new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: 4,
+    }).format(value);
+}
+function truncate(value, maxLength) {
+    return value.length <= maxLength
+        ? value
+        : `${value.slice(0, Math.max(0, maxLength - 3))}...`;
+}
+function isJsonRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

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/screening.js";
 export * from "./commands/skills.js";
 export * from "./commands/status.js";
 //# sourceMappingURL=index.d.ts.map

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,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,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -8,5 +8,6 @@ export * from "./commands/capabilities.js";
 export * from "./commands/init.js";
 export * from "./commands/market.js";
 export * from "./commands/portfolios.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 "./screening.js";
 export * from "./portfolios.js";
 export * from "./registry.js";
 //# sourceMappingURL=index.d.ts.map

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,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,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

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

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