@quantbrasil/cli 0.1.0-beta.6 → 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
 ```
@@ -72,6 +73,40 @@ quantbrasil holdings historical-return 182 --from 2025-01-01 --to 2026-01-01
 quantbrasil holdings historical-return 182 --period 1y
 quantbrasil holdings beta 182 --years 3
 quantbrasil holdings var 182 --years 1 --confidence 95
+quantbrasil screening universes
+quantbrasil screening 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
@@ -111,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,8 +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 { 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;
@@ -14,6 +16,8 @@ export interface CliProgramOptions {
     now?: Date;
     stderr?: TerminalWriter;
     suppressCommanderErrors?: boolean;
+    updateCommandRunner?: UpdateCommandRunner;
+    currentVersion?: string;
 }
 export interface CliRunOptions extends CliProgramOptions {
     stderr?: TerminalWriter;
@@ -25,6 +29,8 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
+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,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAQvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CA2DzE;AAeD,wBAAsB,GAAG,CACvB,IAAI,WAAe,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAoCD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,GAC1B,CAAC;AACF,OAAO,EAAE,uBAAuB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,OAAO,EACL,KAAK,qBAAqB,EAE1B,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,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,8 +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, 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);
@@ -42,6 +44,11 @@ export function createCliProgram(options = {}) {
         fetch: options.fetch,
         now: options.now,
     };
+    const screeningContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+    };
     const skillsContext = {
         io: options.io,
         env: options.env,
@@ -50,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();
@@ -65,7 +80,9 @@ export function createCliProgram(options = {}) {
     registerInitCommand(program, initContext);
     registerMarketCommands(program, marketContext);
     registerPortfoliosCommands(program, portfoliosContext);
+    registerScreeningCommands(program, screeningContext);
     registerSkillsCommands(program, skillsContext);
+    registerUpdateCommand(program, updateContext);
     registerStatusFlag(program, statusContext);
     return program;
 }
@@ -131,5 +148,7 @@ export { runAssetOverviewCommand } from "../commands/assets.js";
 export { runCapabilitiesCommand, runStatusCommand };
 export { runInitCommand };
 export { runMarketAssetsCommand, runMarketPriceCommand };
+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

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

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