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

package/README.md

@@ -31,6 +31,7 @@ that file only exists inside this package.
 node ./bin/quantbrasil.js auth login --api-key qb_live_<id>.<secret>
 node ./bin/quantbrasil.js whoami
 node ./bin/quantbrasil.js skills install --all
+node ./bin/quantbrasil.js update
 node ./bin/quantbrasil.js --status
 node ./bin/quantbrasil.js auth logout
 ```
@@ -73,6 +74,7 @@ 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 indicators
 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 -
@@ -144,8 +146,14 @@ quantbrasil init
 quantbrasil --status
 quantbrasil auth login --api-key qb_live_<id>.<secret>
 quantbrasil skills install --all
+quantbrasil update
 ```
 
+`quantbrasil update` checks the current global package against
+`@quantbrasil/cli@beta`, checks whether the bundled skill is missing or stale,
+shows the planned actions, and asks for confirmation before updating. Use
+`quantbrasil update --yes` only in noninteractive automation.
+
 ## Publishing
 
 Publish from `monorepo/packages/cli`. The package build vendors the private

package/dist/cli/index.d.ts

@@ -3,9 +3,10 @@ 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 { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand } from "../commands/screening.js";
 import { runSkillsInstallCommand } from "../commands/skills.js";
 import { runStatusCommand } from "../commands/status.js";
+import { runUpdateCommand, type UpdateCommandRunner } from "../commands/update.js";
 import { type TerminalWriter } from "./terminal.js";
 export interface CliProgramOptions {
     io?: CapabilitiesCommandIO;
@@ -15,6 +16,8 @@ export interface CliProgramOptions {
     now?: Date;
     stderr?: TerminalWriter;
     suppressCommanderErrors?: boolean;
+    updateCommandRunner?: UpdateCommandRunner;
+    currentVersion?: string;
 }
 export interface CliRunOptions extends CliProgramOptions {
     stderr?: TerminalWriter;
@@ -26,7 +29,8 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
-export { runScreeningRunCommand, runScreeningUniversesCommand };
+export { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, };
 export { runHoldingBetaCommand, runHoldingCreateCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, };
 export { runSkillsInstallCommand };
+export { runUpdateCommand };
 //# 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,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"}
+{"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"}

package/dist/cli/index.js

@@ -6,9 +6,10 @@ 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 { registerScreeningCommands, runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, } from "../commands/screening.js";
 import { registerSkillsCommands, runSkillsInstallCommand, } from "../commands/skills.js";
 import { registerStatusFlag, runStatusCommand, } from "../commands/status.js";
+import { registerUpdateCommand, runUpdateCommand, } from "../commands/update.js";
 import { buildCliErrorPayload, formatCliErrorMessage, normalizeCliError, shouldEmitJsonError, } from "./errors.js";
 import { styleErrorMessage } from "./terminal.js";
 const requirePackage = createRequire(import.meta.url);
@@ -56,10 +57,18 @@ export function createCliProgram(options = {}) {
         io: options.io,
         env: options.env,
     };
+    const updateContext = {
+        io: options.io,
+        env: options.env,
+        prompt: options.prompt,
+        commandRunner: options.updateCommandRunner,
+        currentVersion: options.currentVersion ?? CLI_VERSION,
+    };
     program
         .name("quantbrasil")
-        .description("Public QuantBrasil CLI for deterministic operations")
+        .description("CLI pública do QuantBrasil para operações determinísticas")
         .version(CLI_VERSION)
+        .helpOption("-h, --help", "Exibe ajuda do comando")
         .exitOverride()
         .showHelpAfterError()
         .showSuggestionAfterError();
@@ -73,6 +82,7 @@ export function createCliProgram(options = {}) {
     registerPortfoliosCommands(program, portfoliosContext);
     registerScreeningCommands(program, screeningContext);
     registerSkillsCommands(program, skillsContext);
+    registerUpdateCommand(program, updateContext);
     registerStatusFlag(program, statusContext);
     return program;
 }
@@ -138,6 +148,7 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
-export { runScreeningRunCommand, runScreeningUniversesCommand };
+export { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, };
 export { runHoldingBetaCommand, runHoldingCreateCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, };
 export { runSkillsInstallCommand };
+export { runUpdateCommand };

package/dist/cli/prompt.d.ts

@@ -1,2 +1,3 @@
 export declare function promptForSecret(promptLabel: string): Promise<string>;
+export declare function promptForConfirmation(promptLabel: string): Promise<boolean>;
 //# sourceMappingURL=prompt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/cli/prompt.ts"],"names":[],"mappings":"AAyBA,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB1E"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/cli/prompt.ts"],"names":[],"mappings":"AAyBA,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB1E;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/dist/cli/prompt.js

@@ -38,3 +38,20 @@ export async function promptForSecret(promptLabel) {
         readline.close();
     }
 }
+export async function promptForConfirmation(promptLabel) {
+    if (!input.isTTY || !output.isTTY) {
+        throw createCliConfigError("Confirmação interativa requer um TTY. Use --yes para aplicar a atualização.");
+    }
+    const readline = createInterface({
+        input,
+        output,
+        terminal: true,
+    });
+    try {
+        const answer = await readline.question(promptLabel);
+        return ["s", "sim", "y", "yes"].includes(answer.trim().toLowerCase());
+    }
+    finally {
+        readline.close();
+    }
+}

package/dist/cli/skills.d.ts

@@ -20,7 +20,16 @@ export interface SkillInstallResult {
     installed: InstalledSkillTarget[];
     skipped: SkippedSkillTarget[];
 }
+export type SkillInstallStatus = "current" | "missing" | "stale" | "skipped";
+export interface SkillInstallTargetStatus extends SkillInstallTarget {
+    status: SkillInstallStatus;
+}
+export interface SkillInstallState {
+    targets: SkillInstallTargetStatus[];
+    needsInstall: boolean;
+}
 export declare function installBundledSkillEverywhere(env?: NodeJS.ProcessEnv): Promise<SkillInstallResult>;
+export declare function getBundledSkillInstallState(env?: NodeJS.ProcessEnv): Promise<SkillInstallState>;
 export declare function resolveSkillInstallTargets(env?: NodeJS.ProcessEnv): SkillInstallTarget[];
 export declare function resolveBundledSkillSourcePath(): string;
 //# sourceMappingURL=skills.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAcD,wBAAsB,6BAA6B,CACjD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAmD7B;AAED,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,kBAAkB,EAAE,CAetB;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC;CACvB;AAcD,wBAAsB,6BAA6B,CACjD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAmD7B;AAED,wBAAsB,2BAA2B,CAC/C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,iBAAiB,CAAC,CA0C5B;AAED,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,kBAAkB,EAAE,CAetB;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD"}

package/dist/cli/skills.js

@@ -1,4 +1,5 @@
-import { access, cp, mkdir, rm } from "node:fs/promises";
+import { createHash } from "node:crypto";
+import { access, cp, mkdir, readdir, readFile, rm } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -45,13 +46,46 @@ export async function installBundledSkillEverywhere(env = process.env) {
     }
     if (installed.length === 0) {
         const checkedRoots = targets.map(target => target.rootDir).join(", ");
-        throw createCliConfigError(`No supported agent clients detected. Checked: ${checkedRoots}.`);
+        throw createCliConfigError(`Nenhum cliente de agente compatível detectado. Verificados: ${checkedRoots}.`);
     }
     return {
         installed,
         skipped,
     };
 }
+export async function getBundledSkillInstallState(env = process.env) {
+    const bundledSkillPath = resolveBundledSkillSourcePath();
+    await assertBundledSkillExists(bundledSkillPath);
+    const bundledHash = await hashDirectory(bundledSkillPath);
+    const targets = [];
+    for (const target of resolveSkillInstallTargets(env)) {
+        if (target.id !== AGENT_SKILLS_CONVENTION_ID &&
+            !(await pathExists(target.rootDir))) {
+            targets.push({
+                ...target,
+                status: "skipped",
+            });
+            continue;
+        }
+        if (!(await pathExists(join(target.installDir, "SKILL.md")))) {
+            targets.push({
+                ...target,
+                status: "missing",
+            });
+            continue;
+        }
+        targets.push({
+            ...target,
+            status: (await hashDirectory(target.installDir)) === bundledHash
+                ? "current"
+                : "stale",
+        });
+    }
+    return {
+        targets,
+        needsInstall: targets.some(target => target.status === "missing" || target.status === "stale"),
+    };
+}
 export function resolveSkillInstallTargets(env = process.env) {
     const home = resolveCliHomeDirectory(env);
     return SUPPORTED_SKILL_CLIENTS.map(client => {
@@ -74,12 +108,42 @@ async function assertBundledSkillExists(skillPath) {
     if (await pathExists(skillEntryPath)) {
         return;
     }
-    throw createCliConfigError(`Bundled QuantBrasil skill not found at ${skillEntryPath}. Reinstall the CLI package.`);
+    throw createCliConfigError(`Skill QuantBrasil empacotada não encontrada em ${skillEntryPath}. Reinstale o pacote da CLI.`);
+}
+async function hashDirectory(directory) {
+    const hash = createHash("sha256");
+    const files = await collectDirectoryFiles(directory);
+    for (const file of files) {
+        hash.update(file.relativePath);
+        hash.update("\0");
+        hash.update(await readFile(file.fullPath));
+        hash.update("\0");
+    }
+    return hash.digest("hex");
+}
+async function collectDirectoryFiles(current, relativePrefix = "") {
+    const entries = await readdir(current, { withFileTypes: true });
+    const sortedEntries = entries.sort((left, right) => left.name.localeCompare(right.name));
+    const files = [];
+    for (const entry of sortedEntries) {
+        const fullPath = join(current, entry.name);
+        const relativePath = relativePrefix
+            ? `${relativePrefix}/${entry.name}`
+            : entry.name;
+        if (entry.isDirectory()) {
+            files.push(...(await collectDirectoryFiles(fullPath, relativePath)));
+            continue;
+        }
+        if (entry.isFile()) {
+            files.push({ fullPath, relativePath });
+        }
+    }
+    return files;
 }
 function resolveCliHomeDirectory(env) {
     const home = env.HOME?.trim() || homedir();
     if (!home) {
-        throw createCliConfigError("Could not resolve the HOME directory for skill install.");
+        throw createCliConfigError("Não foi possível resolver o diretório HOME para instalar a skill.");
     }
     return home;
 }

package/dist/commands/screening.d.ts

@@ -8,6 +8,9 @@ export interface ScreeningCommandIO {
 export interface ScreeningUniversesCommandOptions {
     json?: boolean;
 }
+export interface ScreeningIndicatorsCommandOptions {
+    json?: boolean;
+}
 export interface ScreeningRunCommandOptions {
     system?: string;
     watchlist?: string;
@@ -33,6 +36,45 @@ export interface ScreeningUniversesResponse {
     holdings: ScreeningUniverseOut[];
     total: number;
 }
+export type ScreeningIndicatorScalar = string | number | boolean;
+export interface ScreeningIndicatorParamOut {
+    [key: string]: JsonValue;
+    name: string;
+    type: "integer" | "number" | "enum" | "string" | "boolean";
+    required: boolean;
+    default: ScreeningIndicatorScalar | null;
+    description: string;
+    enum_values: string[] | null;
+    examples: ScreeningIndicatorScalar[];
+}
+export interface ScreeningIndicatorRef {
+    [key: string]: JsonValue;
+    name: string;
+    timeframe: string;
+    offset: number;
+    params: Record<string, JsonValue>;
+}
+export interface ScreeningIndicatorExampleOut {
+    [key: string]: JsonValue;
+    label: string;
+    description: string;
+    indicator: ScreeningIndicatorRef;
+}
+export interface ScreeningIndicatorOut {
+    [key: string]: JsonValue;
+    name: string;
+    display_name: string;
+    description: string;
+    timeframes: string[];
+    params: ScreeningIndicatorParamOut[];
+    examples: ScreeningIndicatorExampleOut[];
+}
+export interface ScreeningIndicatorsResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    indicators: ScreeningIndicatorOut[];
+    operators: string[];
+}
 export interface IndicatorResult {
     [key: string]: JsonValue;
     value: number;
@@ -68,9 +110,11 @@ type JsonRecord = {
 };
 export declare function registerScreeningCommands(program: Command, context?: ScreeningCommandContext): void;
 export declare function runScreeningUniversesCommand(options: ScreeningUniversesCommandOptions, context?: ScreeningCommandContext): Promise<void>;
+export declare function runScreeningIndicatorsCommand(options: ScreeningIndicatorsCommandOptions, 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 formatScreeningIndicatorsHuman(data: ScreeningIndicatorsResponse, 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

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

package/dist/commands/screening.js

@@ -14,6 +14,13 @@ export function registerScreeningCommands(program, context = {}) {
         .action(async (options) => {
         await runScreeningUniversesCommand(options, context);
     });
+    screeningCommand
+        .command("indicators")
+        .description("Lista indicadores disponíveis para screening")
+        .option("--json", "Exibe saída JSON")
+        .action(async (options) => {
+        await runScreeningIndicatorsCommand(options, context);
+    });
     screeningCommand
         .command("run")
         .description("Executa screening de indicadores a partir de um ScreenerRequest JSON")
@@ -42,6 +49,20 @@ export async function runScreeningUniversesCommand(options, context = {}) {
     }
     stdout.write(`${formatScreeningUniversesHuman(response.data, theme)}\n`);
 }
+export async function runScreeningIndicatorsCommand(options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "screening.indicators",
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatScreeningIndicatorsHuman(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);
@@ -84,6 +105,32 @@ export function formatScreeningUniversesHuman(data, theme = createTerminalTheme(
     appendUniverseGroup(lines, theme, "Carteiras", data.holdings);
     return lines.join("\n");
 }
+export function formatScreeningIndicatorsHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        theme.label("Indicadores de screening"),
+        "",
+        `${theme.label("Total:")} ${formatInteger(data.indicators.length)}`,
+        `${theme.label("Operadores:")} ${data.operators.join(", ")}`,
+    ];
+    for (const indicator of data.indicators) {
+        lines.push("");
+        lines.push(`${theme.bold(indicator.name)} ${theme.dim("-")} ${indicator.display_name}`);
+        lines.push(`  ${indicator.description}`);
+        lines.push(`  ${theme.label("Timeframes:")} ${indicator.timeframes.join(", ")}`);
+        if (indicator.params.length > 0) {
+            lines.push(`  ${theme.label("Parâmetros:")}`);
+            for (const param of indicator.params) {
+                lines.push(`    ${formatIndicatorParam(param)}`);
+            }
+        }
+        if (indicator.examples.length > 0) {
+            lines.push(`  ${theme.label("Exemplos:")} ${indicator.examples
+                .map(example => example.label)
+                .join(", ")}`);
+        }
+    }
+    return lines.join("\n");
+}
 export function formatScreeningRunHuman(data, theme = createTerminalTheme(process.stdout)) {
     const lines = [
         theme.label("Screening de indicadores"),
@@ -227,6 +274,22 @@ function formatUniverseKind(kind) {
     }
     return "Carteira";
 }
+function formatIndicatorParam(param) {
+    const details = [param.type];
+    if (param.required) {
+        details.push("obrigatório");
+    }
+    if (param.default !== null) {
+        details.push(`padrão ${formatScalar(param.default)}`);
+    }
+    if (param.enum_values !== null && param.enum_values.length > 0) {
+        details.push(`opções ${param.enum_values.join("|")}`);
+    }
+    return `${param.name}: ${details.join(", ")} - ${param.description}`;
+}
+function formatScalar(value) {
+    return typeof value === "string" ? JSON.stringify(value) : String(value);
+}
 function collectIndicatorKeys(results) {
     const keys = [];
     const seen = new Set();

package/dist/commands/skills.js

@@ -4,18 +4,18 @@ import { createTerminalTheme } from "../cli/terminal.js";
 export function registerSkillsCommands(program, context = {}) {
     const skillsCommand = program
         .command("skills")
-        .description("Manage bundled public skills");
+        .description("Gerencia skills públicas empacotadas");
     skillsCommand
         .command("install")
-        .description("Install bundled QuantBrasil skills into detected agent clients")
-        .option("--all", "Install all bundled public QuantBrasil skills")
+        .description("Instala a skill pública do QuantBrasil nos clientes de agente detectados")
+        .option("--all", "Instala todas as skills públicas empacotadas")
         .action(async (options) => {
         await runSkillsInstallCommand(options, context);
     });
 }
 export async function runSkillsInstallCommand(options, context = {}) {
     if (!options.all) {
-        throw createCliValidationError("Use --all to install the bundled QuantBrasil skill into detected agent clients.");
+        throw createCliValidationError("Use --all para instalar a skill QuantBrasil nos clientes de agente detectados.");
     }
     const stdout = context.io?.stdout ?? process.stdout;
     const theme = createTerminalTheme(stdout, context.env ?? process.env);
@@ -23,15 +23,15 @@ export async function runSkillsInstallCommand(options, context = {}) {
     stdout.write(`${formatSkillsInstallResult(result, theme)}\n`);
 }
 export function formatSkillsInstallResult(result, theme = createTerminalTheme(process.stdout)) {
-    const lines = [theme.label("Installed QuantBrasil skill"), ""];
+    const lines = [theme.label("Skill QuantBrasil instalada"), ""];
     for (const target of result.installed) {
         lines.push(`${theme.success(target.label)} ${theme.dim(`→ ${target.installDir}`)}`);
     }
     if (result.skipped.length > 0) {
         lines.push("");
-        lines.push(theme.label("Skipped"));
+        lines.push(theme.label("Ignorados"));
         for (const target of result.skipped) {
-            lines.push(`${theme.dim(`${target.label} not detected at ${target.rootDir}`)}`);
+            lines.push(`${theme.dim(`${target.label} não detectado em ${target.rootDir}`)}`);
         }
     }
     return lines.join("\n");

package/dist/commands/update.d.ts

@@ -0,0 +1,23 @@
+import { Command } from "commander";
+import { type TerminalWriter } from "../cli/terminal.js";
+export interface UpdateCommandIO {
+    stdout: TerminalWriter;
+}
+export interface UpdateCommandOptions {
+    yes?: boolean;
+}
+export interface UpdateCommandResult {
+    stdout: string;
+    stderr: string;
+}
+export type UpdateCommandRunner = (command: string, args: readonly string[], env: NodeJS.ProcessEnv) => Promise<UpdateCommandResult>;
+export interface UpdateCommandContext {
+    io?: UpdateCommandIO;
+    env?: NodeJS.ProcessEnv;
+    prompt?: (promptLabel: string) => Promise<string>;
+    commandRunner?: UpdateCommandRunner;
+    currentVersion?: string;
+}
+export declare function registerUpdateCommand(program: Command, context?: UpdateCommandContext): void;
+export declare function runUpdateCommand(options: UpdateCommandOptions, context?: UpdateCommandContext): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG9E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,eAAe,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAQN;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/commands/update.js

@@ -0,0 +1,209 @@
+import { spawn } from "node:child_process";
+import { createCliConfigError } from "../cli/errors.js";
+import { promptForConfirmation } from "../cli/prompt.js";
+import { getBundledSkillInstallState, installBundledSkillEverywhere, } from "../cli/skills.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+import { formatSkillsInstallResult } from "./skills.js";
+const CLI_PACKAGE_SPEC = "@quantbrasil/cli@beta";
+export function registerUpdateCommand(program, context = {}) {
+    program
+        .command("update")
+        .description("Atualiza o pacote global e a skill pública do QuantBrasil")
+        .option("--yes", "Atualiza sem confirmação interativa")
+        .action(async (options) => {
+        await runUpdateCommand(options, context);
+    });
+}
+export async function runUpdateCommand(options, context = {}) {
+    const env = context.env ?? process.env;
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, env);
+    const runner = context.commandRunner ?? runExternalCommand;
+    const currentVersion = context.currentVersion ?? "0.0.0";
+    const latestVersion = await getLatestBetaVersion(runner, env);
+    const cliNeedsUpdate = compareVersions(currentVersion, latestVersion) < 0;
+    const skillState = await getBundledSkillInstallState(env);
+    const skillNeedsUpdate = skillState.needsInstall;
+    if (!cliNeedsUpdate && !skillNeedsUpdate) {
+        stdout.write(`${theme.success("QuantBrasil CLI já está atualizado.")}\n`);
+        return;
+    }
+    stdout.write(`${formatUpdatePlan({
+        currentVersion,
+        latestVersion,
+        cliNeedsUpdate,
+        skillState,
+    }, theme)}\n`);
+    if (!(await shouldContinue(options, context))) {
+        stdout.write(`${theme.warning("Atualização cancelada.")}\n`);
+        return;
+    }
+    if (cliNeedsUpdate) {
+        await runner("npm", ["install", "-g", CLI_PACKAGE_SPEC], env);
+        await runner("quantbrasil", ["skills", "install", "--all"], env);
+        stdout.write(`${theme.success("Atualização concluída.")}\n`);
+        return;
+    }
+    const skillInstallResult = await installBundledSkillEverywhere(env);
+    stdout.write(`${formatSkillsInstallResult(skillInstallResult, theme)}\n`);
+    stdout.write(`${theme.success("Atualização concluída.")}\n`);
+}
+function formatUpdatePlan(data, theme) {
+    const lines = [
+        theme.label("Atualização do QuantBrasil CLI"),
+        "",
+        `${theme.label("Versão instalada:")} ${data.currentVersion}`,
+        `${theme.label("Versão beta publicada:")} ${data.latestVersion}`,
+    ];
+    const skillTargets = data.skillState.targets.filter(target => target.status === "missing" || target.status === "stale");
+    if (skillTargets.length > 0) {
+        lines.push(`${theme.label("Skills:")} ${skillTargets.length} alvo(s) precisam ser atualizados`);
+        for (const target of skillTargets) {
+            lines.push(`  ${target.label}: ${formatSkillStatus(target.status)} ${theme.dim(`(${target.installDir})`)}`);
+        }
+    }
+    else {
+        lines.push(`${theme.label("Skills:")} já estão atualizadas`);
+    }
+    lines.push("");
+    lines.push(theme.label("Ações"));
+    if (data.cliNeedsUpdate) {
+        lines.push(`  npm install -g ${CLI_PACKAGE_SPEC}`);
+        lines.push("  quantbrasil skills install --all");
+    }
+    else if (skillTargets.length > 0) {
+        lines.push("  quantbrasil skills install --all");
+    }
+    return lines.join("\n");
+}
+async function shouldContinue(options, context) {
+    if (options.yes) {
+        return true;
+    }
+    if (context.prompt) {
+        return parseConfirmationAnswer(await context.prompt("Atualizar agora? [s/N] "));
+    }
+    return promptForConfirmation("Atualizar agora? [s/N] ");
+}
+function formatSkillStatus(status) {
+    if (status === "missing") {
+        return "não instalada";
+    }
+    if (status === "stale") {
+        return "desatualizada";
+    }
+    return status;
+}
+function parseConfirmationAnswer(answer) {
+    return ["s", "sim", "y", "yes"].includes(answer.trim().toLowerCase());
+}
+async function getLatestBetaVersion(runner, env) {
+    const result = await runner("npm", ["view", CLI_PACKAGE_SPEC, "version"], env);
+    const version = result.stdout.trim();
+    if (!version) {
+        throw createCliConfigError(`Não foi possível resolver a versão publicada de ${CLI_PACKAGE_SPEC}.`);
+    }
+    return version;
+}
+function compareVersions(left, right) {
+    const parsedLeft = parseVersion(left);
+    const parsedRight = parseVersion(right);
+    for (let index = 0; index < 3; index += 1) {
+        const diff = (parsedLeft.main[index] ?? 0) - (parsedRight.main[index] ?? 0);
+        if (diff !== 0) {
+            return diff;
+        }
+    }
+    if (parsedLeft.prerelease.length === 0 &&
+        parsedRight.prerelease.length === 0) {
+        return 0;
+    }
+    if (parsedLeft.prerelease.length === 0) {
+        return 1;
+    }
+    if (parsedRight.prerelease.length === 0) {
+        return -1;
+    }
+    const length = Math.max(parsedLeft.prerelease.length, parsedRight.prerelease.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftPart = parsedLeft.prerelease[index];
+        const rightPart = parsedRight.prerelease[index];
+        if (leftPart === undefined) {
+            return -1;
+        }
+        if (rightPart === undefined) {
+            return 1;
+        }
+        const diff = comparePrereleasePart(leftPart, rightPart);
+        if (diff !== 0) {
+            return diff;
+        }
+    }
+    return 0;
+}
+function parseVersion(version) {
+    const [mainVersion = "0.0.0", prerelease = ""] = version
+        .trim()
+        .replace(/^v/, "")
+        .split("-");
+    const mainParts = mainVersion.split(".").map(part => Number(part));
+    const main = [
+        normalizeVersionPart(mainParts[0]),
+        normalizeVersionPart(mainParts[1]),
+        normalizeVersionPart(mainParts[2]),
+    ];
+    return {
+        main,
+        prerelease: prerelease ? prerelease.split(".") : [],
+    };
+}
+function normalizeVersionPart(part) {
+    return Number.isFinite(part) ? Number(part) : 0;
+}
+function comparePrereleasePart(left, right) {
+    const leftNumber = Number(left);
+    const rightNumber = Number(right);
+    const leftIsNumeric = /^\d+$/.test(left);
+    const rightIsNumeric = /^\d+$/.test(right);
+    if (leftIsNumeric && rightIsNumeric) {
+        return leftNumber - rightNumber;
+    }
+    if (leftIsNumeric) {
+        return -1;
+    }
+    if (rightIsNumeric) {
+        return 1;
+    }
+    return left.localeCompare(right);
+}
+function runExternalCommand(command, args, env) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", chunk => {
+            stdout += chunk;
+        });
+        child.stderr.on("data", chunk => {
+            stderr += chunk;
+        });
+        child.on("error", error => {
+            reject(createCliConfigError(`Não foi possível executar ${command}: ${error.message}`));
+        });
+        child.on("close", code => {
+            if (code === 0) {
+                resolve({ stdout, stderr });
+                return;
+            }
+            reject(createCliConfigError([
+                `${command} ${args.join(" ")} falhou com exit ${code}.`,
+                stderr.trim() || stdout.trim(),
+            ]
+                .filter(Boolean)
+                .join("\n")));
+        });
+    });
+}

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export * from "./commands/portfolios.js";
 export * from "./commands/screening.js";
 export * from "./commands/skills.js";
 export * from "./commands/status.js";
+export * from "./commands/update.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,yBAAyB,CAAC;AACxC,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;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -11,3 +11,4 @@ export * from "./commands/portfolios.js";
 export * from "./commands/screening.js";
 export * from "./commands/skills.js";
 export * from "./commands/status.js";
+export * from "./commands/update.js";

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

@@ -165,6 +165,33 @@ export declare const capabilityRegistry: readonly [{
         readonly title: "Listar universos de screening";
     };
     readonly outputModes: readonly ["json", "human"];
+}, {
+    readonly id: "screening.indicators";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista indicadores, parâmetros e operadores disponíveis para screening.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/screening/indicators";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "ScreeningIndicatorsResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "indicators";
+        readonly summary: "Lista indicadores, parâmetros e exemplos disponíveis para screening.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil screening indicators", "quantbrasil screening indicators --json"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_indicators";
+        readonly title: "Listar indicadores de screening";
+    };
+    readonly outputModes: readonly ["json", "human"];
 }, {
     readonly id: "screening.run";
     readonly kind: "read";
@@ -1032,6 +1059,33 @@ export declare function getCapabilityById(id: CapabilityId): {
         readonly title: "Listar universos de screening";
     };
     readonly outputModes: readonly ["json", "human"];
+} | {
+    readonly id: "screening.indicators";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista indicadores, parâmetros e operadores disponíveis para screening.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/screening/indicators";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "ScreeningIndicatorsResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "indicators";
+        readonly summary: "Lista indicadores, parâmetros e exemplos disponíveis para screening.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil screening indicators", "quantbrasil screening indicators --json"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_indicators";
+        readonly title: "Listar indicadores de screening";
+    };
+    readonly outputModes: readonly ["json", "human"];
 } | {
     readonly id: "screening.run";
     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":"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/screening.d.ts

@@ -26,6 +26,33 @@ export declare const screeningCapabilities: readonly [{
         readonly title: "Listar universos de screening";
     };
     readonly outputModes: readonly ["json", "human"];
+}, {
+    readonly id: "screening.indicators";
+    readonly kind: "read";
+    readonly visibility: readonly ["cli", "opencode"];
+    readonly description: "Lista indicadores, parâmetros e operadores disponíveis para screening.";
+    readonly http: {
+        readonly method: "GET";
+        readonly path: "/api/desk/tools/screening/indicators";
+        readonly inputMode: "none";
+        readonly schemas: {
+            readonly request: null;
+            readonly response: "ScreeningIndicatorsResponse";
+        };
+    };
+    readonly cli: {
+        readonly group: "screening";
+        readonly command: "indicators";
+        readonly summary: "Lista indicadores, parâmetros e exemplos disponíveis para screening.";
+        readonly positional: readonly [];
+        readonly options: readonly [];
+        readonly examples: readonly ["quantbrasil screening indicators", "quantbrasil screening indicators --json"];
+    };
+    readonly tool: {
+        readonly name: "qb_screening_indicators";
+        readonly title: "Listar indicadores de screening";
+    };
+    readonly outputModes: readonly ["json", "human"];
 }, {
     readonly id: "screening.run";
     readonly kind: "read";

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiKkB,CAAC"}

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

@@ -30,6 +30,37 @@ export const screeningCapabilities = [
         },
         outputModes: standardOutputModes,
     },
+    {
+        id: "screening.indicators",
+        kind: "read",
+        visibility: publicRuntimeVisibility,
+        description: "Lista indicadores, parâmetros e operadores disponíveis para screening.",
+        http: {
+            method: "GET",
+            path: "/api/desk/tools/screening/indicators",
+            inputMode: "none",
+            schemas: {
+                request: null,
+                response: "ScreeningIndicatorsResponse",
+            },
+        },
+        cli: {
+            group: "screening",
+            command: "indicators",
+            summary: "Lista indicadores, parâmetros e exemplos disponíveis para screening.",
+            positional: [],
+            options: [],
+            examples: [
+                "quantbrasil screening indicators",
+                "quantbrasil screening indicators --json",
+            ],
+        },
+        tool: {
+            name: "qb_screening_indicators",
+            title: "Listar indicadores de screening",
+        },
+        outputModes: standardOutputModes,
+    },
     {
         id: "screening.run",
         kind: "read",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantbrasil/cli",
-  "version": "0.1.0-beta.7",
+  "version": "0.1.0-beta.8",
   "type": "module",
   "description": "Public QuantBrasil CLI for deterministic operations",
   "repository": {
@@ -41,8 +41,8 @@
     "typescript": "^5.3.3",
     "vitest": "^3.2.4",
     "@repo/core": "0.0.0",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "scripts": {
     "build": "pnpm --filter @repo/core build && pnpm run clean && tsc && node scripts/vendor-core.mjs",

package/skills/quantbrasil/SKILL.md

@@ -13,6 +13,7 @@ Use this skill when the user asks for market or investing data/actions that Quan
 - 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.
+- 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.
 - Check readiness first: `quantbrasil --status`
@@ -24,7 +25,7 @@ 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 ...`
+  - indicator screening over saved universes: `quantbrasil screening universes|indicators|run ...`
   - 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.
@@ -35,6 +36,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/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.
 - 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.

package/skills/quantbrasil/references/cli.md

@@ -82,6 +82,7 @@ Use `--json` on any holding metric command when machine parsing needed.
 
 ```bash
 quantbrasil screening universes
+quantbrasil screening indicators
 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
@@ -96,6 +97,10 @@ Rules:
 - `--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
+- use `screening indicators` to discover supported indicator names, params, examples, timeframes, and operators
+
+Load [`screening.md`](./screening.md) for detailed screening examples, including
+IFR14, IFR2, and logical `AND` JSON payloads.
 
 Example query JSON:
 

package/skills/quantbrasil/references/costs.md

@@ -14,6 +14,7 @@ Current guidance uses backend qualitative classes only:
 - `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 indicators` is a discovery path for supported screening JSON
 - `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
 
@@ -22,6 +23,7 @@ Current guidance uses backend qualitative classes only:
 - 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
+- run `screening indicators` before `screening run` when the indicator JSON is not known
 - prefer one holding metric call targeted to actual question
 - do not chain multiple heavy holding metric or screening calls unless user asked for them
 - use `--json` only when structured output needed

package/skills/quantbrasil/references/quality-eval-queries.json

@@ -44,6 +44,11 @@
     "should_trigger": true,
     "expected_behavior": "Use screening universes and present system portfolios, watchlists, and holdings."
   },
+  {
+    "query": "Quais indicadores posso usar no screening?",
+    "should_trigger": true,
+    "expected_behavior": "Use screening indicators and present supported indicator names, params, examples, timeframes, and operators."
+  },
   {
     "query": "Rode um screening de IFR na carteira do sistema Ações Mais Líquidas.",
     "should_trigger": true,

package/skills/quantbrasil/references/screening.md

@@ -0,0 +1,212 @@
+# Screening
+
+Use screening for indicator filters over saved QuantBrasil universes.
+
+## Discovery
+
+```bash
+quantbrasil screening universes
+quantbrasil screening indicators
+```
+
+Use `screening universes` to pick the asset set. The CLI supports only saved,
+portfolio-backed universes:
+
+- system portfolios via `--system <slug>`
+- watchlists via `--watchlist <id>`
+- holdings via `--holding <id>`
+
+Do not invent ad-hoc ticker-list screening. If the user gives loose tickers,
+explain that this CLI slice only screens saved universes.
+
+Use `screening indicators` before building JSON when the indicator name,
+parameters, timeframes, or comparison operators are unclear.
+
+## Common Portuguese mappings
+
+- `IFR`, `IFR14`, `IFR(14)` -> `RSI` with `params.period = 14`
+- `IFR2`, `IFR(2)` -> `RSI` with `params.period = 2`
+- `sobrevendido` usually means low RSI, commonly `< 30` or a threshold supplied by the user
+- `sobrecomprado` usually means high RSI, commonly `> 70` or a threshold supplied by the user
+- `Ações Mais Líquidas` -> system universe slug `acoes-mais-liquidas` when present in `screening universes`
+
+## Operators
+
+- `lt` means less than
+- `lte` means less than or equal to
+- `gt` means greater than
+- `gte` means greater than or equal to
+- `eq` means equal to
+- `neq` means not equal to
+
+## IFR14 abaixo de 25
+
+```json
+{
+  "query": {
+    "comparison": {
+      "left": {
+        "indicator": {
+          "name": "RSI",
+          "timeframe": "D1",
+          "offset": 0,
+          "params": {
+            "period": 14
+          }
+        }
+      },
+      "operator": "lt",
+      "right": {
+        "constant": {
+          "value": 25
+        }
+      }
+    }
+  },
+  "limit": 500,
+  "sort": "ticker"
+}
+```
+
+Run it:
+
+```bash
+quantbrasil screening run --system acoes-mais-liquidas --query-file ./screening-ifr14-lt-25.json
+```
+
+For agent/script parsing:
+
+```bash
+quantbrasil screening run --system acoes-mais-liquidas --query-file ./screening-ifr14-lt-25.json --json
+```
+
+## IFR14 acima de 70
+
+```json
+{
+  "query": {
+    "comparison": {
+      "left": {
+        "indicator": {
+          "name": "RSI",
+          "timeframe": "D1",
+          "offset": 0,
+          "params": {
+            "period": 14
+          }
+        }
+      },
+      "operator": "gt",
+      "right": {
+        "constant": {
+          "value": 70
+        }
+      }
+    }
+  },
+  "limit": 500,
+  "sort": "ticker"
+}
+```
+
+## IFR2 abaixo de 10
+
+```json
+{
+  "query": {
+    "comparison": {
+      "left": {
+        "indicator": {
+          "name": "RSI",
+          "timeframe": "D1",
+          "offset": 0,
+          "params": {
+            "period": 2
+          }
+        }
+      },
+      "operator": "lt",
+      "right": {
+        "constant": {
+          "value": 10
+        }
+      }
+    }
+  },
+  "limit": 500,
+  "sort": "ticker"
+}
+```
+
+## Exemplo com AND lógico
+
+Este exemplo filtra ativos com fechamento acima da média móvel de 20 períodos e
+IFR14 abaixo de 30.
+
+```json
+{
+  "query": {
+    "logical": {
+      "op": "AND",
+      "expressions": [
+        {
+          "comparison": {
+            "left": {
+              "indicator": {
+                "name": "OHLC",
+                "timeframe": "D1",
+                "offset": 0,
+                "params": {
+                  "price_type": "close"
+                }
+              }
+            },
+            "operator": "gt",
+            "right": {
+              "indicator": {
+                "name": "RollingWindow",
+                "timeframe": "D1",
+                "offset": 0,
+                "params": {
+                  "window": 20,
+                  "method": "mean"
+                }
+              }
+            }
+          }
+        },
+        {
+          "comparison": {
+            "left": {
+              "indicator": {
+                "name": "RSI",
+                "timeframe": "D1",
+                "offset": 0,
+                "params": {
+                  "period": 14
+                }
+              }
+            },
+            "operator": "lt",
+            "right": {
+              "constant": {
+                "value": 30
+              }
+            }
+          }
+        }
+      ]
+    }
+  },
+  "limit": 100,
+  "sort": "ticker"
+}
+```
+
+## Stdin
+
+Use stdin when creating the JSON dynamically:
+
+```bash
+cat ./screening-ifr14-lt-25.json | quantbrasil screening run --system acoes-mais-liquidas --query-file -
+```

package/skills/quantbrasil/references/workflows.md

@@ -8,7 +8,7 @@
 - watchlist details or changes → `watchlists ...`
 - holding details or changes → `holdings ...`
 - holding return, beta, risk, VaR, or comparison → `holdings historical-return|beta|var`
-- indicator screening over saved asset sets → `screening universes`, then `screening run`
+- indicator screening over saved asset sets → `screening universes`, `screening indicators` when needed, then `screening run`
 
 ## Find supported ticker, then get price
 
@@ -79,11 +79,13 @@ quantbrasil holdings var 93 --years 1 --confidence 95
 ## Run indicator screening
 
 1. Discover available universes.
-2. Pick exactly one system portfolio, watchlist, or holding.
-3. Run screening with a full `ScreenerRequest` JSON file.
+2. Discover available indicators when the filter JSON is not already known.
+3. Pick exactly one system portfolio, watchlist, or holding.
+4. Run screening with a full `ScreenerRequest` JSON file.
 
 ```bash
 quantbrasil screening universes
+quantbrasil screening indicators
 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
@@ -94,6 +96,7 @@ Rules:
 - screening universes are portfolio-backed only: system portfolios, watchlists, or holdings
 - a holding used as a screening universe contributes only its asset set
 - do not invent ad-hoc ticker-list screening commands
+- load `references/screening.md` for IFR/RSI examples and full JSON payloads
 - use `--json` when the result will be parsed by an agent or script
 
 ## Analyze a theoretical composition