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

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

@@ -138,6 +138,112 @@ export declare const capabilityRegistry: readonly [{
         readonly title: "Get asset overview";
     };
     readonly outputModes: readonly ["json", "human"];
+}, {
+    readonly id: "screening.universes";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista universos salvos e baseados em portfólios disponíveis para screening de indicadores.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/screening/universes";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "ScreeningUniversesResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "universes";
+        readonly summary: "Lista carteiras do sistema, watchlists e carteiras disponíveis para screening.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil screening universes"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_universes";
+        readonly title: "Listar universos de screening";
+    };
+    readonly outputModes: readonly ["json", "human"];
+}, {
+    readonly id: "screening.run";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Executa o screener de indicadores existente sobre um universo salvo baseado em portfólio.";
+    readonly http: {
+        readonly method: "POST";
+        readonly path: "/api/desk/tools/screening/run";
+        readonly inputMode: "json_body";
+        readonly schemas: {
+            readonly request: "ScreeningRunRequest";
+            readonly response: "ScreeningRunResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "run";
+        readonly summary: "Executa screening de indicadores a partir de um payload ScreenerRequest JSON.";
+        readonly positional: readonly [];
+        readonly options: readonly [{
+            readonly kind: "option";
+            readonly flag: "--system";
+            readonly name: "system_slug";
+            readonly type: "string";
+            readonly required: false;
+            readonly placeholder: "SLUG";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "Slug da carteira do sistema retornado por `screening universes`, por exemplo acoes-mais-liquidas.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--watchlist";
+            readonly name: "watchlist_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "ID da watchlist retornado por `watchlists list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--holding";
+            readonly name: "holding_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "ID da carteira retornado por `holdings list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--query-file";
+            readonly name: "query_file";
+            readonly type: "string";
+            readonly required: true;
+            readonly placeholder: "ARQUIVO|-";
+            readonly description: "Caminho para um arquivo ScreenerRequest JSON completo, ou `-` para ler JSON de stdin.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--limit";
+            readonly name: "limit";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "N";
+            readonly description: "Sobrescreve o limit de topo do ScreenerRequest sem alterar o arquivo da consulta.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--sort";
+            readonly name: "sort";
+            readonly type: "enum";
+            readonly required: false;
+            readonly placeholder: "price|ticker";
+            readonly enumValues: readonly ["price", "ticker"];
+            readonly description: "Sobrescreve o sort de topo do ScreenerRequest sem alterar o arquivo da consulta.";
+        }];
+        readonly examples: readonly ["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 - --sort ticker"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_run";
+        readonly title: "Executar screening de indicadores";
+    };
+    readonly outputModes: readonly ["json", "human"];
 }, {
     readonly id: "watchlists.list";
     readonly kind: "read";
@@ -899,6 +1005,112 @@ export declare function getCapabilityById(id: CapabilityId): {
         readonly title: "Get asset overview";
     };
     readonly outputModes: readonly ["json", "human"];
+} | {
+    readonly id: "screening.universes";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista universos salvos e baseados em portfólios disponíveis para screening de indicadores.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/screening/universes";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "ScreeningUniversesResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "universes";
+        readonly summary: "Lista carteiras do sistema, watchlists e carteiras disponíveis para screening.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil screening universes"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_universes";
+        readonly title: "Listar universos de screening";
+    };
+    readonly outputModes: readonly ["json", "human"];
+} | {
+    readonly id: "screening.run";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Executa o screener de indicadores existente sobre um universo salvo baseado em portfólio.";
+    readonly http: {
+        readonly method: "POST";
+        readonly path: "/api/desk/tools/screening/run";
+        readonly inputMode: "json_body";
+        readonly schemas: {
+            readonly request: "ScreeningRunRequest";
+            readonly response: "ScreeningRunResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "run";
+        readonly summary: "Executa screening de indicadores a partir de um payload ScreenerRequest JSON.";
+        readonly positional: readonly [];
+        readonly options: readonly [{
+            readonly kind: "option";
+            readonly flag: "--system";
+            readonly name: "system_slug";
+            readonly type: "string";
+            readonly required: false;
+            readonly placeholder: "SLUG";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "Slug da carteira do sistema retornado por `screening universes`, por exemplo acoes-mais-liquidas.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--watchlist";
+            readonly name: "watchlist_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "ID da watchlist retornado por `watchlists list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--holding";
+            readonly name: "holding_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "ID da carteira retornado por `holdings list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--query-file";
+            readonly name: "query_file";
+            readonly type: "string";
+            readonly required: true;
+            readonly placeholder: "ARQUIVO|-";
+            readonly description: "Caminho para um arquivo ScreenerRequest JSON completo, ou `-` para ler JSON de stdin.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--limit";
+            readonly name: "limit";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "N";
+            readonly description: "Sobrescreve o limit de topo do ScreenerRequest sem alterar o arquivo da consulta.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--sort";
+            readonly name: "sort";
+            readonly type: "enum";
+            readonly required: false;
+            readonly placeholder: "price|ticker";
+            readonly enumValues: readonly ["price", "ticker"];
+            readonly description: "Sobrescreve o sort de topo do ScreenerRequest sem alterar o arquivo da consulta.";
+        }];
+        readonly examples: readonly ["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 - --sort ticker"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_run";
+        readonly title: "Executar screening de indicadores";
+    };
+    readonly outputModes: readonly ["json", "human"];
 } | {
     readonly id: "watchlists.list";
     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":"AAIA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIrB,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":"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"}

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

@@ -1,9 +1,11 @@
 import { assetCapabilities } from "./assets.js";
 import { marketCapabilities } from "./market.js";
 import { portfolioCapabilities } from "./portfolios.js";
+import { screeningCapabilities } from "./screening.js";
 export const capabilityRegistry = [
     ...marketCapabilities,
     ...assetCapabilities,
+    ...screeningCapabilities,
     ...portfolioCapabilities,
 ];
 export const capabilityRegistryById = Object.fromEntries(capabilityRegistry.map(capability => [capability.id, capability]));

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

@@ -0,0 +1,109 @@
+export declare const screeningSortValues: readonly ["price", "ticker"];
+export declare const screeningCapabilities: readonly [{
+    readonly id: "screening.universes";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista universos salvos e baseados em portfólios disponíveis para screening de indicadores.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/screening/universes";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "ScreeningUniversesResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "universes";
+        readonly summary: "Lista carteiras do sistema, watchlists e carteiras disponíveis para screening.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil screening universes"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_universes";
+        readonly title: "Listar universos de screening";
+    };
+    readonly outputModes: readonly ["json", "human"];
+}, {
+    readonly id: "screening.run";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Executa o screener de indicadores existente sobre um universo salvo baseado em portfólio.";
+    readonly http: {
+        readonly method: "POST";
+        readonly path: "/api/desk/tools/screening/run";
+        readonly inputMode: "json_body";
+        readonly schemas: {
+            readonly request: "ScreeningRunRequest";
+            readonly response: "ScreeningRunResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "run";
+        readonly summary: "Executa screening de indicadores a partir de um payload ScreenerRequest JSON.";
+        readonly positional: readonly [];
+        readonly options: readonly [{
+            readonly kind: "option";
+            readonly flag: "--system";
+            readonly name: "system_slug";
+            readonly type: "string";
+            readonly required: false;
+            readonly placeholder: "SLUG";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "Slug da carteira do sistema retornado por `screening universes`, por exemplo acoes-mais-liquidas.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--watchlist";
+            readonly name: "watchlist_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "ID da watchlist retornado por `watchlists list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--holding";
+            readonly name: "holding_id";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "ID";
+            readonly exclusiveGroup: "screening_universe_selector";
+            readonly description: "ID da carteira retornado por `holdings list`.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--query-file";
+            readonly name: "query_file";
+            readonly type: "string";
+            readonly required: true;
+            readonly placeholder: "ARQUIVO|-";
+            readonly description: "Caminho para um arquivo ScreenerRequest JSON completo, ou `-` para ler JSON de stdin.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--limit";
+            readonly name: "limit";
+            readonly type: "integer";
+            readonly required: false;
+            readonly placeholder: "N";
+            readonly description: "Sobrescreve o limit de topo do ScreenerRequest sem alterar o arquivo da consulta.";
+        }, {
+            readonly kind: "option";
+            readonly flag: "--sort";
+            readonly name: "sort";
+            readonly type: "enum";
+            readonly required: false;
+            readonly placeholder: "price|ticker";
+            readonly enumValues: readonly ["price", "ticker"];
+            readonly description: "Sobrescreve o sort de topo do ScreenerRequest sem alterar o arquivo da consulta.";
+        }];
+        readonly examples: readonly ["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 - --sort ticker"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_run";
+        readonly title: "Executar screening de indicadores";
+    };
+    readonly outputModes: readonly ["json", "human"];
+}];
+//# sourceMappingURL=screening.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screening.d.ts","sourceRoot":"","sources":["../../src/capabilities/screening.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,8BAA+B,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgIkB,CAAC"}

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

@@ -0,0 +1,124 @@
+import { publicRuntimeVisibility, standardOutputModes } from "./shared.js";
+const screeningSelectorExclusiveGroup = "screening_universe_selector";
+export const screeningSortValues = ["price", "ticker"];
+export const screeningCapabilities = [
+    {
+        id: "screening.universes",
+        kind: "read",
+        visibility: publicRuntimeVisibility,
+        description: "Lista universos salvos e baseados em portfólios disponíveis para screening de indicadores.",
+        http: {
+            method: "GET",
+            path: "/api/desk/tools/screening/universes",
+            inputMode: "none",
+            schemas: {
+                request: null,
+                response: "ScreeningUniversesResponse",
+            },
+        },
+        cli: {
+            group: "screening",
+            command: "universes",
+            summary: "Lista carteiras do sistema, watchlists e carteiras disponíveis para screening.",
+            positional: [],
+            options: [],
+            examples: ["quantbrasil screening universes"],
+        },
+        tool: {
+            name: "qb_screening_universes",
+            title: "Listar universos de screening",
+        },
+        outputModes: standardOutputModes,
+    },
+    {
+        id: "screening.run",
+        kind: "read",
+        visibility: publicRuntimeVisibility,
+        description: "Executa o screener de indicadores existente sobre um universo salvo baseado em portfólio.",
+        http: {
+            method: "POST",
+            path: "/api/desk/tools/screening/run",
+            inputMode: "json_body",
+            schemas: {
+                request: "ScreeningRunRequest",
+                response: "ScreeningRunResponse",
+            },
+        },
+        cli: {
+            group: "screening",
+            command: "run",
+            summary: "Executa screening de indicadores a partir de um payload ScreenerRequest JSON.",
+            positional: [],
+            options: [
+                {
+                    kind: "option",
+                    flag: "--system",
+                    name: "system_slug",
+                    type: "string",
+                    required: false,
+                    placeholder: "SLUG",
+                    exclusiveGroup: screeningSelectorExclusiveGroup,
+                    description: "Slug da carteira do sistema retornado por `screening universes`, por exemplo acoes-mais-liquidas.",
+                },
+                {
+                    kind: "option",
+                    flag: "--watchlist",
+                    name: "watchlist_id",
+                    type: "integer",
+                    required: false,
+                    placeholder: "ID",
+                    exclusiveGroup: screeningSelectorExclusiveGroup,
+                    description: "ID da watchlist retornado por `watchlists list`.",
+                },
+                {
+                    kind: "option",
+                    flag: "--holding",
+                    name: "holding_id",
+                    type: "integer",
+                    required: false,
+                    placeholder: "ID",
+                    exclusiveGroup: screeningSelectorExclusiveGroup,
+                    description: "ID da carteira retornado por `holdings list`.",
+                },
+                {
+                    kind: "option",
+                    flag: "--query-file",
+                    name: "query_file",
+                    type: "string",
+                    required: true,
+                    placeholder: "ARQUIVO|-",
+                    description: "Caminho para um arquivo ScreenerRequest JSON completo, ou `-` para ler JSON de stdin.",
+                },
+                {
+                    kind: "option",
+                    flag: "--limit",
+                    name: "limit",
+                    type: "integer",
+                    required: false,
+                    placeholder: "N",
+                    description: "Sobrescreve o limit de topo do ScreenerRequest sem alterar o arquivo da consulta.",
+                },
+                {
+                    kind: "option",
+                    flag: "--sort",
+                    name: "sort",
+                    type: "enum",
+                    required: false,
+                    placeholder: "price|ticker",
+                    enumValues: screeningSortValues,
+                    description: "Sobrescreve o sort de topo do ScreenerRequest sem alterar o arquivo da consulta.",
+                },
+            ],
+            examples: [
+                "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 - --sort ticker",
+            ],
+        },
+        tool: {
+            name: "qb_screening_run",
+            title: "Executar screening de indicadores",
+        },
+        outputModes: standardOutputModes,
+    },
+];

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" | "watchlists" | "holdings";
+export type CapabilityGroup = "market" | "assets" | "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.5",
+  "version": "0.1.0-beta.7",
   "type": "module",
   "description": "Public QuantBrasil CLI for deterministic operations",
   "repository": {

package/skills/quantbrasil/SKILL.md

@@ -1,17 +1,18 @@
 ---
 name: quantbrasil
-description: Go-to QuantBrasil market and investing skill. Use for supported asset lookup, prices, asset analysis, watchlists, holdings, and risk/return metrics through the QuantBrasil CLI.
+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.
 ---
 
 # 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, 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, 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.
-- For QuantBrasil-supported market, asset, 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, or saved compositions, load [`references/portfolios.md`](./references/portfolios.md) before choosing commands.
+- 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.
+- 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.
 - 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.
 - Check readiness first: `quantbrasil --status`
@@ -23,16 +24,18 @@ Use this skill when the user asks for market or investing data/actions that Quan
   - richer asset analysis: `quantbrasil assets overview <ticker> --sections ...`
   - watchlist details and changes: `quantbrasil watchlists ...`
   - holding details and historical return: `quantbrasil holdings ...`
+  - indicator screening over saved universes: `quantbrasil screening ...`
   - holding metrics: `quantbrasil holdings historical-return|beta|var ...`
 - Use `--json` when output will be parsed by agent or script
 - Use generic web or finance search only if the CLI is unavailable, the requested data is outside the QuantBrasil-supported surface, or the user explicitly asks for an external source.
 - Do not inspect the local repo, package source, or `~/.config/quantbrasil/config.json` for normal data queries. Use CLI status/errors instead.
 
-## References
+## Reference Loading
 
-- Portfolio, watchlist, and holding semantics: [`references/portfolios.md`](./references/portfolios.md)
-- CLI surface: [`references/cli.md`](./references/cli.md)
-- Common workflows: [`references/workflows.md`](./references/workflows.md)
-- Cost-aware behavior: [`references/costs.md`](./references/costs.md)
-- Failure handling: [`references/errors.md`](./references/errors.md)
-- Unsupported / not-yet-public operations: [`references/unsupported.md`](./references/unsupported.md)
+- 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/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/costs.md`](./references/costs.md) before chaining heavy reads, choosing between overview/screening/holding metrics, or answering cost-sensitive agent workflow questions.
+- Load [`references/errors.md`](./references/errors.md) when a CLI command fails, auth/config is unclear, or the user asks how to fix a QuantBrasil CLI error.
+- Load [`references/unsupported.md`](./references/unsupported.md) when the user asks for deletion, file export, ad-hoc ticker-list screening, unsupported commands, or a capability that may not be public yet.
+- Use [`references/quality-eval-queries.json`](./references/quality-eval-queries.json) only when evaluating or tuning skill quality and trigger accuracy.

package/skills/quantbrasil/references/cli.md

@@ -77,3 +77,51 @@ quantbrasil holdings var 182 --years 1 --confidence 95
 ```
 
 Use `--json` on any holding metric command when machine parsing needed.
+
+## Screening
+
+```bash
+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
+quantbrasil screening run --holding 182 --query-file ./screening.json --sort ticker
+cat ./screening.json | quantbrasil screening run --system etfs --query-file -
+```
+
+Rules:
+
+- use exactly one selector: `--system`, `--watchlist`, or `--holding`
+- `--system` accepts a slug from `screening universes`
+- `--watchlist` and `--holding` accept numeric ids
+- `--query-file` must contain the full backend `ScreenerRequest` JSON shape
+- `--query-file -` reads the same JSON shape from stdin
+- `--limit` and `--sort` override only top-level fields from the query JSON
+
+Example query 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"
+}
+```

package/skills/quantbrasil/references/costs.md

@@ -13,14 +13,17 @@ Current guidance uses backend qualitative classes only:
 - `market assets` is lowest-cost discovery path
 - `market price` is narrow read path
 - `assets overview` is richer and should use minimal `--sections`
+- `screening universes` is a discovery path for saved screening universes
+- `screening run` is a heavy read and should be targeted to one selected universe
 - holding metrics (`historical-return`, `beta`, `var`) are heaviest current public reads
 
 ## Agent rules
 
 - prefer narrow command that answers question
 - prefer `market price` over `assets overview` for quote-only requests
+- run `screening universes` before `screening run` when the universe selector is not known
 - prefer one holding metric call targeted to actual question
-- do not chain multiple heavy holding metric calls unless user asked for them
+- do not chain multiple heavy holding metric or screening calls unless user asked for them
 - use `--json` only when structured output needed
 
 ## Safe defaults