@quantbrasil/cli 0.1.0-beta.1 → 0.1.0-beta.11

package/README.md

@@ -29,7 +29,9 @@ that file only exists inside this package.
 ```bash
 # from monorepo/packages/cli
 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
 ```
@@ -48,6 +50,7 @@ compatible local or staging backend.
 ```bash
 quantbrasil market assets
 quantbrasil market assets --type B3
+quantbrasil market assets --search BTC
 quantbrasil market assets --json
 quantbrasil market price PETR4
 quantbrasil market price PETR4 --date 2026-04-10
@@ -55,16 +58,60 @@ quantbrasil market price PETR4 --json
 quantbrasil assets overview PETR4 --sections price,performance
 quantbrasil assets overview PETR4 --sections price,technicals
 quantbrasil assets overview PETR4 --sections price,fundamentals --json
-quantbrasil portfolios list
-quantbrasil portfolios get 93
-quantbrasil portfolios get 93 --json
-quantbrasil portfolios create "Dividendos"
-quantbrasil portfolios rename 93 "Longo Prazo"
-quantbrasil portfolios add-assets 93 PETR4 VALE3
-quantbrasil portfolios remove-assets 93 PETR4
-quantbrasil analytics historical-return --portfolio 93 --from 2025-01-01 --to 2026-01-01
-quantbrasil analytics beta --portfolio 93 --years 3
-quantbrasil analytics var --portfolio 93 --years 1 --confidence 95
+quantbrasil watchlists list
+quantbrasil watchlists get 93
+quantbrasil watchlists create "Dividendos"
+quantbrasil watchlists add-assets 93 PETR4 VALE3
+quantbrasil holdings list
+quantbrasil holdings get 182
+quantbrasil holdings create "Longo Prazo"
+quantbrasil holdings create "Longo Prazo" --target PETR4:50 --target VALE3:50
+quantbrasil holdings create "Carteira Real" --mode position
+quantbrasil holdings set-targets 182 PETR4:50 VALE3:50
+quantbrasil holdings set-positions 182 PRIO3:1600 BTC-USD:0.25 QQQ:10
+quantbrasil holdings historical-return 182 --from 2025-01-01 --to 2026-01-01
+quantbrasil holdings historical-return 182 --period 1y
+quantbrasil holdings beta 182 --years 3
+quantbrasil holdings var 182 --years 1 --confidence 95
+quantbrasil rankings list
+quantbrasil rankings current --system momentum-90d --top 20
+quantbrasil rankings current --system magic-formula --top 10
+quantbrasil rankings current --system low-risk --top 30
+quantbrasil rankings current --id 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 -
+```
+
+Example `screening.json`:
+
+```json
+{
+  "query": {
+    "comparison": {
+      "left": {
+        "indicator": {
+          "name": "RSI",
+          "timeframe": "D1",
+          "offset": 0,
+          "params": {
+            "period": 14
+          }
+        }
+      },
+      "operator": "lt",
+      "right": {
+        "constant": {
+          "value": 30
+        }
+      }
+    }
+  },
+  "limit": 50,
+  "sort": "ticker"
+}
 ```
 
 ## Local config
@@ -104,8 +151,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
@@ -183,7 +236,7 @@ For commands that expose `--json`, failures are written to stderr as JSON:
     "category": "auth",
     "exit_code": 1,
     "status": 401,
-    "path": "/api/desk/tools/portfolio/list",
+    "path": "/api/desk/tools/watchlist/list",
     "request_id": "req_..."
   }
 }

package/dist/cli/client.js

@@ -80,6 +80,7 @@ function resolveErrorDetail(payload) {
     }
     const detail = payload.detail;
     const message = payload.message;
+    const error = payload.error;
     if (typeof detail === "string" && detail.trim()) {
         return detail;
     }
@@ -94,6 +95,9 @@ function resolveErrorDetail(payload) {
     if (typeof message === "string" && message.trim()) {
         return message;
     }
+    if (typeof error === "string" && error.trim()) {
+        return error;
+    }
     return null;
 }
 function formatValidationDetail(value) {

package/dist/cli/index.d.ts

@@ -1,30 +1,40 @@
 import { Command } from "commander";
 import { type CapabilitiesCommandIO, runCapabilitiesCommand } from "../commands/capabilities.js";
+import { runCointegrationPairCommand } from "../commands/cointegration.js";
 import { runMarketAssetsCommand, runMarketPriceCommand } from "../commands/market.js";
 import { runInitCommand } from "../commands/init.js";
-import { runPortfolioAddAssetsCommand, runPortfolioCreateCommand, runPortfolioGetCommand, runPortfolioListCommand, runPortfolioRemoveAssetsCommand, runPortfolioRenameCommand } from "../commands/portfolios.js";
+import { runHoldingCreateCommand, runHoldingBetaCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand } from "../commands/portfolios.js";
+import { runRankingsCurrentCommand, runRankingsListCommand } from "../commands/rankings.js";
+import { runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand } from "../commands/screening.js";
 import { runSkillsInstallCommand } from "../commands/skills.js";
 import { runStatusCommand } from "../commands/status.js";
+import { runUpdateCommand, type UpdateCommandRunner } from "../commands/update.js";
 import { type TerminalWriter } from "./terminal.js";
 export interface CliProgramOptions {
     io?: CapabilitiesCommandIO;
     env?: NodeJS.ProcessEnv;
     fetch?: typeof fetch;
     prompt?: (promptLabel: string) => Promise<string>;
+    now?: Date;
     stderr?: TerminalWriter;
     suppressCommanderErrors?: boolean;
+    updateCommandRunner?: UpdateCommandRunner;
+    currentVersion?: string;
 }
 export interface CliRunOptions extends CliProgramOptions {
     stderr?: TerminalWriter;
 }
 export declare function createCliProgram(options?: CliProgramOptions): Command;
 export declare function run(argv?: string[], options?: CliRunOptions): Promise<void>;
-export { runBetaCommand, runHistoricalReturnCommand, runVarCommand, } from "../commands/analytics.js";
-export { runAuthLoginCommand, runAuthLogoutCommand } from "../commands/auth.js";
+export { runAuthLoginCommand, runAuthLogoutCommand, runAuthWhoamiCommand, } from "../commands/auth.js";
 export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
-export { runPortfolioAddAssetsCommand, runPortfolioCreateCommand, runPortfolioGetCommand, runPortfolioListCommand, runPortfolioRemoveAssetsCommand, runPortfolioRenameCommand, };
+export { runRankingsCurrentCommand, runRankingsListCommand };
+export { runCointegrationPairCommand };
+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":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,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,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvE,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,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,CA+DzE;AAED,wBAAsB,GAAG,CACvB,IAAI,WAAe,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAiBD,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChF,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,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":"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"}

package/dist/cli/index.js

@@ -1,15 +1,22 @@
+import { createRequire } from "node:module";
 import { Command } from "commander";
-import { registerAnalyticsCommands, } from "../commands/analytics.js";
 import { registerAssetsCommands, } from "../commands/assets.js";
-import { registerAuthCommands, } from "../commands/auth.js";
+import { registerAuthCommands, runAuthWhoamiCommand, } from "../commands/auth.js";
 import { registerCapabilitiesCommand, runCapabilitiesCommand, } from "../commands/capabilities.js";
+import { registerCointegrationCommands, runCointegrationPairCommand, } from "../commands/cointegration.js";
 import { registerMarketCommands, runMarketAssetsCommand, runMarketPriceCommand, } from "../commands/market.js";
 import { registerInitCommand, runInitCommand, } from "../commands/init.js";
-import { registerPortfoliosCommands, runPortfolioAddAssetsCommand, runPortfolioCreateCommand, runPortfolioGetCommand, runPortfolioListCommand, runPortfolioRemoveAssetsCommand, runPortfolioRenameCommand, } from "../commands/portfolios.js";
+import { registerPortfoliosCommands, runHoldingCreateCommand, runHoldingBetaCommand, runHoldingGetCommand, runHoldingHistoricalReturnCommand, runHoldingListCommand, runHoldingRenameCommand, runHoldingSetPositionsCommand, runHoldingSetTargetsCommand, runHoldingVarCommand, runWatchlistAddAssetsCommand, runWatchlistCreateCommand, runWatchlistGetCommand, runWatchlistListCommand, runWatchlistRemoveAssetsCommand, runWatchlistRenameCommand, } from "../commands/portfolios.js";
+import { registerRankingsCommands, runRankingsCurrentCommand, runRankingsListCommand, } from "../commands/rankings.js";
+import { registerScreeningCommands, runScreeningIndicatorsCommand, runScreeningRunCommand, runScreeningUniversesCommand, } from "../commands/screening.js";
 import { registerSkillsCommands, runSkillsInstallCommand, } from "../commands/skills.js";
 import { registerStatusFlag, runStatusCommand, } from "../commands/status.js";
+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);
+const cliPackageJson = requirePackage("../../package.json");
+const CLI_VERSION = cliPackageJson.version ?? "0.0.0";
 export function createCliProgram(options = {}) {
     const program = new Command();
     const authContext = {
@@ -22,11 +29,6 @@ export function createCliProgram(options = {}) {
         env: options.env,
         fetch: options.fetch,
     };
-    const analyticsContext = {
-        io: options.io,
-        env: options.env,
-        fetch: options.fetch,
-    };
     const marketContext = {
         io: options.io,
         env: options.env,
@@ -42,6 +44,22 @@ export function createCliProgram(options = {}) {
         io: options.io,
         env: options.env,
         fetch: options.fetch,
+        now: options.now,
+    };
+    const rankingsContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+    };
+    const cointegrationContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+    };
+    const screeningContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
     };
     const skillsContext = {
         io: options.io,
@@ -51,25 +69,46 @@ 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")
-        .version("0.0.0")
+        .description("CLI pública do QuantBrasil para operações determinísticas")
+        .version(CLI_VERSION)
+        .helpOption("-h, --help", "Exibe ajuda do comando")
         .exitOverride()
         .showHelpAfterError()
         .showSuggestionAfterError();
     configureCommanderOutput(program, options);
     registerCapabilitiesCommand(program, options.io);
     registerAuthCommands(program, authContext);
+    registerWhoamiCommand(program, authContext);
     registerAssetsCommands(program, assetsContext);
-    registerAnalyticsCommands(program, analyticsContext);
     registerInitCommand(program, initContext);
     registerMarketCommands(program, marketContext);
     registerPortfoliosCommands(program, portfoliosContext);
+    registerRankingsCommands(program, rankingsContext);
+    registerCointegrationCommands(program, cointegrationContext);
+    registerScreeningCommands(program, screeningContext);
     registerSkillsCommands(program, skillsContext);
+    registerUpdateCommand(program, updateContext);
     registerStatusFlag(program, statusContext);
     return program;
 }
+function registerWhoamiCommand(program, context) {
+    program
+        .command("whoami")
+        .description("Show the authenticated QuantBrasil user")
+        .option("--json", "Show JSON output")
+        .action(async (options) => {
+        await runAuthWhoamiCommand(options, context);
+    });
+}
 export async function run(argv = process.argv, options = {}) {
     const emitJsonError = shouldEmitJsonError(argv);
     const program = createCliProgram({
@@ -82,6 +121,9 @@ export async function run(argv = process.argv, options = {}) {
         await program.parseAsync(argv);
     }
     catch (error) {
+        if (isCommanderDisplayExit(error)) {
+            return;
+        }
         const cliError = normalizeCliError(error);
         if (emitJsonError) {
             stderr.write(`${JSON.stringify(buildCliErrorPayload(cliError), null, 2)}\n`);
@@ -93,8 +135,12 @@ export async function run(argv = process.argv, options = {}) {
     }
 }
 function configureCommanderOutput(program, options) {
+    const stdout = options.io?.stdout ?? process.stdout;
     const stderr = options.stderr ?? process.stderr;
     program.configureOutput({
+        writeOut: chunk => {
+            stdout.write(chunk);
+        },
         writeErr: chunk => {
             if (!options.suppressCommanderErrors) {
                 stderr.write(chunk);
@@ -102,11 +148,23 @@ function configureCommanderOutput(program, options) {
         },
     });
 }
-export { runBetaCommand, runHistoricalReturnCommand, runVarCommand, } from "../commands/analytics.js";
-export { runAuthLoginCommand, runAuthLogoutCommand } from "../commands/auth.js";
+function isCommanderDisplayExit(error) {
+    if (!(error instanceof Error) ||
+        !("code" in error) ||
+        typeof error.code !== "string") {
+        return false;
+    }
+    return (error.code === "commander.helpDisplayed" ||
+        error.code === "commander.version");
+}
+export { runAuthLoginCommand, runAuthLogoutCommand, runAuthWhoamiCommand, } from "../commands/auth.js";
 export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
-export { runPortfolioAddAssetsCommand, runPortfolioCreateCommand, runPortfolioGetCommand, runPortfolioListCommand, runPortfolioRemoveAssetsCommand, runPortfolioRenameCommand, };
+export { runRankingsCurrentCommand, runRankingsListCommand };
+export { runCointegrationPairCommand };
+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/auth.d.ts

@@ -11,7 +11,25 @@ export interface AuthCommandContext {
 export interface AuthLoginCommandOptions {
     apiKey: string;
 }
+export interface AuthWhoamiCommandOptions {
+    json?: boolean;
+}
+export interface AuthWhoamiOutput {
+    ok: true;
+    user_id: number;
+    email: string;
+    name: string;
+    is_premium: boolean;
+    auth_source: "env" | "config";
+    api_key: {
+        id: number;
+        name: string;
+        key_prefix: string;
+        scopes: string[];
+    };
+}
 export declare function registerAuthCommands(program: Command, context?: AuthCommandContext): void;
 export declare function runAuthLoginCommand(options: AuthLoginCommandOptions, context?: AuthCommandContext): Promise<void>;
 export declare function runAuthLogoutCommand(context?: AuthCommandContext): Promise<void>;
+export declare function runAuthWhoamiCommand(options?: AuthWhoamiCommandOptions, context?: AuthCommandContext): Promise<void>;
 //# sourceMappingURL=auth.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,aAAa,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAmBN;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAiBf"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,aAAa,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC9B,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CA2BN;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,wBAA6B,EACtC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/commands/auth.js

@@ -1,4 +1,5 @@
 import { verifyCliApiKey } from "../cli/auth.js";
+import { resolveRequiredCliAuth } from "../cli/client.js";
 import { clearCliStoredAuth, saveCliApiKey } from "../cli/config.js";
 import { createTerminalTheme } from "../cli/terminal.js";
 export function registerAuthCommands(program, context = {}) {
@@ -18,6 +19,13 @@ export function registerAuthCommands(program, context = {}) {
         .action(async () => {
         await runAuthLogoutCommand(context);
     });
+    authCommand
+        .command("whoami")
+        .description("Show the authenticated QuantBrasil user")
+        .option("--json", "Show JSON output")
+        .action(async (options) => {
+        await runAuthWhoamiCommand(options, context);
+    });
 }
 export async function runAuthLoginCommand(options, context = {}) {
     const stdout = getStdout(context);
@@ -43,6 +51,47 @@ export async function runAuthLogoutCommand(context = {}) {
     }
     stdout.write(`${theme.dim(`No local API key was stored at ${configPath}.`)}\n`);
 }
+export async function runAuthWhoamiCommand(options = {}, context = {}) {
+    const stdout = getStdout(context);
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const auth = await resolveRequiredCliAuth(context.env ?? process.env);
+    const verifiedAuth = await verifyCliApiKey(auth.apiKey, {
+        env: context.env,
+        fetch: context.fetch,
+    });
+    const output = {
+        ok: true,
+        user_id: verifiedAuth.userId,
+        email: verifiedAuth.email,
+        name: verifiedAuth.name,
+        is_premium: verifiedAuth.isPremium,
+        auth_source: auth.source,
+        api_key: {
+            id: verifiedAuth.apiKey.id,
+            name: verifiedAuth.apiKey.name,
+            key_prefix: verifiedAuth.apiKey.keyPrefix,
+            scopes: verifiedAuth.apiKey.scopes,
+        },
+    };
+    if (options.json) {
+        stdout.write(`${JSON.stringify(output, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatAuthWhoamiHuman(output, theme)}\n`);
+}
+function formatAuthWhoamiHuman(data, theme) {
+    const source = data.auth_source === "env" ? "QUANTBRASIL_API_KEY" : "local config";
+    return [
+        theme.label("QuantBrasil user"),
+        "",
+        `${theme.label("Email:")} ${theme.bold(data.email)}`,
+        `${theme.label("Name:")} ${data.name}`,
+        `${theme.label("User ID:")} ${data.user_id}`,
+        `${theme.label("Premium:")} ${data.is_premium ? "yes" : "no"}`,
+        `${theme.label("API key:")} ${data.api_key.name} ${theme.dim(`(${data.api_key.key_prefix})`)}`,
+        `${theme.label("Auth source:")} ${source}`,
+    ].join("\n");
+}
 function getStdout(context) {
     return context.io?.stdout ?? process.stdout;
 }

package/dist/commands/cointegration.d.ts

@@ -0,0 +1,52 @@
+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 CointegrationCommandIO {
+    stdout: TerminalWriter;
+}
+export interface CointegrationPairCommandOptions {
+    window?: string;
+    json?: boolean;
+}
+export interface CointegrationZScorePoint {
+    [key: string]: JsonValue;
+    date: string;
+    zscore: number | null;
+}
+export interface CointegrationBetaPoint {
+    [key: string]: JsonValue;
+    date: string;
+    slope: number | null;
+}
+export interface CointegrationPairResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    summary_markdown: string;
+    base_asset: string;
+    comparison_asset: string;
+    window: number;
+    beta: number | null;
+    beta_std: number | null;
+    beta_mean: number | null;
+    beta_volatility: number | null;
+    adf: number | null;
+    p_value: number | null;
+    confidence: number | null;
+    halflife: number | null;
+    critical_values: Record<string, number>;
+    zscore_series: CointegrationZScorePoint[];
+    beta_series: CointegrationBetaPoint[];
+}
+export interface CointegrationCommandContext extends CliInvokeContext {
+    io?: CointegrationCommandIO;
+}
+type JsonRecord = {
+    [key: string]: JsonValue;
+};
+export declare function registerCointegrationCommands(program: Command, context?: CointegrationCommandContext): void;
+export declare function runCointegrationPairCommand(baseAsset: string, comparisonAsset: string, options: CointegrationPairCommandOptions, context?: CointegrationCommandContext): Promise<void>;
+export declare function buildCointegrationPairInput(baseAsset: string, comparisonAsset: string, options: CointegrationPairCommandOptions): JsonRecord;
+export declare function formatCointegrationPairHuman(data: CointegrationPairResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+export {};
+//# sourceMappingURL=cointegration.d.ts.map