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

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
 ```
@@ -72,7 +73,12 @@ quantbrasil holdings historical-return 182 --from 2025-01-01 --to 2026-01-01
 quantbrasil holdings historical-return 182 --period 1y
 quantbrasil holdings beta 182 --years 3
 quantbrasil holdings var 182 --years 1 --confidence 95
+quantbrasil rankings list
+quantbrasil rankings current --system momentum-90d --top 20
+quantbrasil rankings current --system magic-formula --top 10
+quantbrasil rankings current --user 123 --top 20
 quantbrasil screening universes
+quantbrasil screening indicators
 quantbrasil screening run --system acoes-mais-liquidas --query-file ./screening.json
 quantbrasil screening run --watchlist 93 --query-file ./screening.json --limit 25
 cat ./screening.json | quantbrasil screening run --holding 182 --query-file -
@@ -144,8 +150,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,11 @@ 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 { runRankingsCurrentCommand, runRankingsListCommand } from "../commands/rankings.js";
+import { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand } from "../commands/screening.js";
 import { runSkillsInstallCommand } from "../commands/skills.js";
 import { runStatusCommand } from "../commands/status.js";
+import { runUpdateCommand, type UpdateCommandRunner } from "../commands/update.js";
 import { type TerminalWriter } from "./terminal.js";
 export interface CliProgramOptions {
     io?: CapabilitiesCommandIO;
@@ -15,6 +17,8 @@ export interface CliProgramOptions {
     now?: Date;
     stderr?: TerminalWriter;
     suppressCommanderErrors?: boolean;
+    updateCommandRunner?: UpdateCommandRunner;
+    currentVersion?: string;
 }
 export interface CliRunOptions extends CliProgramOptions {
     stderr?: TerminalWriter;
@@ -26,7 +30,9 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
-export { runScreeningRunCommand, runScreeningUniversesCommand };
+export { runRankingsCurrentCommand, runRankingsListCommand };
+export { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, };
 export { runHoldingBetaCommand, runHoldingCreateCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, };
 export { runSkillsInstallCommand };
+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,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,gBAAgB,EAEhB,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAQvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAgFzE;AAeD,wBAAsB,GAAG,CACvB,IAAI,WAAe,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAoCD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,GAC7B,CAAC;AACF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,GAC1B,CAAC;AACF,OAAO,EAAE,uBAAuB,EAAE,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/cli/index.js

@@ -6,9 +6,11 @@ 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 { registerRankingsCommands, runRankingsCurrentCommand, runRankingsListCommand, } from "../commands/rankings.js";
+import { registerScreeningCommands, runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, } from "../commands/screening.js";
 import { registerSkillsCommands, runSkillsInstallCommand, } from "../commands/skills.js";
 import { registerStatusFlag, runStatusCommand, } from "../commands/status.js";
+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);
@@ -43,6 +45,11 @@ export function createCliProgram(options = {}) {
         fetch: options.fetch,
         now: options.now,
     };
+    const rankingsContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+    };
     const screeningContext = {
         io: options.io,
         env: options.env,
@@ -56,10 +63,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();
@@ -71,8 +86,10 @@ export function createCliProgram(options = {}) {
     registerInitCommand(program, initContext);
     registerMarketCommands(program, marketContext);
     registerPortfoliosCommands(program, portfoliosContext);
+    registerRankingsCommands(program, rankingsContext);
     registerScreeningCommands(program, screeningContext);
     registerSkillsCommands(program, skillsContext);
+    registerUpdateCommand(program, updateContext);
     registerStatusFlag(program, statusContext);
     return program;
 }
@@ -138,6 +155,8 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
-export { runScreeningRunCommand, runScreeningUniversesCommand };
+export { runRankingsCurrentCommand, runRankingsListCommand };
+export { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, };
 export { runHoldingBetaCommand, runHoldingCreateCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, };
 export { runSkillsInstallCommand };
+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/rankings.d.ts

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

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

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

package/dist/commands/rankings.js

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

package/dist/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