@quantbrasil/cli 0.1.0-beta.0

package/dist/cli/config.js

@@ -0,0 +1,148 @@
+import { access, chmod, mkdir, readFile, rm, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { createCliConfigError, createCliValidationError } from "./errors.js";
+export const DEFAULT_PUBLIC_BACKEND_URL = "https://api.quantbrasil.com.br";
+export const CLI_CONFIG_FILENAME = "config.json";
+export const CLI_API_KEY_PREFIX_FAMILY = "qb_live_";
+export function resolveCliConfigPath(env = process.env) {
+    const configHome = resolveCliConfigHome(env);
+    return join(configHome, "quantbrasil", CLI_CONFIG_FILENAME);
+}
+export function resolveCliBackendUrl(env = process.env) {
+    const override = env.QB_BACKEND_URL?.trim();
+    return stripTrailingSlash(override || DEFAULT_PUBLIC_BACKEND_URL);
+}
+export function resolveCliBackendSource(env = process.env) {
+    return env.QB_BACKEND_URL?.trim() ? "override" : "default";
+}
+export async function readCliConfig(env = process.env) {
+    const configPath = resolveCliConfigPath(env);
+    try {
+        const raw = await readFile(configPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!isPlainObject(parsed)) {
+            throw createCliConfigError("root must be an object");
+        }
+        const apiKey = parsed.apiKey;
+        if (apiKey === undefined) {
+            return {};
+        }
+        if (typeof apiKey !== "string" || !apiKey.trim()) {
+            throw createCliConfigError("apiKey must be a non-empty string");
+        }
+        return {
+            apiKey: normalizeCliApiKey(apiKey),
+        };
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return {};
+        }
+        throw createCliConfigError(`Invalid config file at ${configPath}. Fix or remove the file.`);
+    }
+}
+export async function saveCliApiKey(apiKey, env = process.env) {
+    const normalizedApiKey = normalizeApiKey(apiKey);
+    const configPath = resolveCliConfigPath(env);
+    await mkdir(dirname(configPath), {
+        recursive: true,
+        mode: 0o700,
+    });
+    await writeFile(configPath, JSON.stringify({ apiKey: normalizedApiKey }, null, 2).concat("\n"), {
+        mode: 0o600,
+    });
+    await chmod(configPath, 0o600);
+    return configPath;
+}
+export async function clearCliStoredAuth(env = process.env) {
+    const configPath = resolveCliConfigPath(env);
+    const removed = await fileExists(configPath);
+    await rm(configPath, { force: true });
+    return {
+        configPath,
+        removed,
+    };
+}
+export async function resolveCliAuth(env = process.env) {
+    const envApiKey = env.QUANTBRASIL_API_KEY?.trim();
+    if (envApiKey) {
+        return {
+            apiKey: normalizeCliApiKey(envApiKey),
+            source: "env",
+        };
+    }
+    const config = await readCliConfig(env);
+    if (config.apiKey) {
+        return {
+            apiKey: config.apiKey,
+            source: "config",
+        };
+    }
+    return null;
+}
+export async function resolveCliStatusSnapshot(env = process.env) {
+    const configPath = resolveCliConfigPath(env);
+    const config = await readCliConfig(env);
+    const resolvedAuth = await resolveCliAuth(env);
+    return {
+        backendUrl: resolveCliBackendUrl(env),
+        backendSource: resolveCliBackendSource(env),
+        configPath,
+        storedApiKey: Boolean(config.apiKey),
+        authSource: resolvedAuth?.source ?? "none",
+        isReady: resolvedAuth !== null,
+    };
+}
+function resolveCliConfigHome(env) {
+    const xdgConfigHome = env.XDG_CONFIG_HOME?.trim();
+    if (xdgConfigHome) {
+        return xdgConfigHome;
+    }
+    const home = env.HOME?.trim() || homedir();
+    if (!home) {
+        throw createCliConfigError("Could not resolve the HOME directory for the CLI.");
+    }
+    return join(home, ".config");
+}
+function normalizeApiKey(apiKey) {
+    const normalizedApiKey = apiKey.trim();
+    if (!normalizedApiKey) {
+        throw createCliValidationError("API key cannot be empty.");
+    }
+    return normalizeCliApiKey(normalizedApiKey);
+}
+export function normalizeCliApiKey(apiKey) {
+    const normalizedApiKey = apiKey.trim();
+    const keyPrefixSeparator = normalizedApiKey.indexOf(".");
+    if (!normalizedApiKey) {
+        throw createCliValidationError("API key cannot be empty.");
+    }
+    if (keyPrefixSeparator <= 0 ||
+        keyPrefixSeparator === normalizedApiKey.length - 1 ||
+        !normalizedApiKey.startsWith(CLI_API_KEY_PREFIX_FAMILY)) {
+        throw createCliValidationError("Invalid API key format. Use qb_live_<id>.<secret>.");
+    }
+    return normalizedApiKey;
+}
+function stripTrailingSlash(value) {
+    return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isMissingFileError(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        typeof error.code === "string" &&
+        error.code === "ENOENT");
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/cli/errors.d.ts

@@ -0,0 +1,40 @@
+export declare const CLI_ERROR_CODES: readonly ["auth_required", "auth_failed", "backend_error", "backend_unavailable", "config_error", "mutation_failed", "network_error", "not_found", "rate_limited", "unexpected_error", "validation_error"];
+export type CliErrorCode = (typeof CLI_ERROR_CODES)[number];
+export type CliErrorCategory = "auth" | "backend" | "config" | "network" | "unexpected" | "validation";
+export interface CliErrorOptions extends ErrorOptions {
+    category: CliErrorCategory;
+    exitCode?: number;
+    status?: number;
+    path?: string;
+    requestId?: string;
+}
+export interface CliErrorPayload {
+    ok: false;
+    error: {
+        code: CliErrorCode;
+        message: string;
+        category: CliErrorCategory;
+        exit_code: number;
+        status?: number;
+        path?: string;
+        request_id?: string;
+    };
+}
+export declare class CliError extends Error {
+    readonly code: CliErrorCode;
+    readonly category: CliErrorCategory;
+    readonly exitCode: number;
+    readonly status?: number;
+    readonly path?: string;
+    readonly requestId?: string;
+    constructor(code: CliErrorCode, message: string, options: CliErrorOptions);
+}
+export declare function createCliValidationError(message: string): CliError;
+export declare function createCliConfigError(message: string): CliError;
+export declare function createCliAuthRequiredError(message: string): CliError;
+export declare function createCliMutationFailedError(message: string): CliError;
+export declare function normalizeCliError(error: unknown): CliError;
+export declare function shouldEmitJsonError(argv: readonly string[]): boolean;
+export declare function formatCliErrorMessage(error: CliError): string;
+export declare function buildCliErrorPayload(error: CliError): CliErrorPayload;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,4MAYlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,SAAS,GACT,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,YAAY,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,YAAY,CAAC;IACnC,SAAgB,QAAQ,EAAE,gBAAgB,CAAC;IAC3C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAU1E;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAIlE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAI9D;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAIpE;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAItE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAqC1D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAEpE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAE7D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,GAAG,eAAe,CAwBrE"}

package/dist/cli/errors.js

@@ -0,0 +1,122 @@
+export const CLI_ERROR_CODES = [
+    "auth_required",
+    "auth_failed",
+    "backend_error",
+    "backend_unavailable",
+    "config_error",
+    "mutation_failed",
+    "network_error",
+    "not_found",
+    "rate_limited",
+    "unexpected_error",
+    "validation_error",
+];
+export class CliError extends Error {
+    code;
+    category;
+    exitCode;
+    status;
+    path;
+    requestId;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "CliError";
+        this.code = code;
+        this.category = options.category;
+        this.exitCode = options.exitCode ?? 1;
+        this.status = options.status;
+        this.path = options.path;
+        this.requestId = options.requestId;
+    }
+}
+export function createCliValidationError(message) {
+    return new CliError("validation_error", message, {
+        category: "validation",
+    });
+}
+export function createCliConfigError(message) {
+    return new CliError("config_error", message, {
+        category: "config",
+    });
+}
+export function createCliAuthRequiredError(message) {
+    return new CliError("auth_required", message, {
+        category: "auth",
+    });
+}
+export function createCliMutationFailedError(message) {
+    return new CliError("mutation_failed", message, {
+        category: "validation",
+    });
+}
+export function normalizeCliError(error) {
+    if (error instanceof CliError) {
+        return error;
+    }
+    if (isCommanderError(error)) {
+        return createCliValidationError(stripCommanderErrorPrefix(error.message));
+    }
+    if (error instanceof Error) {
+        if (error.name === "DeskConfigError") {
+            return createCliConfigError(error.message);
+        }
+        if (error.name === "DeskJsonCompatibilityError") {
+            return new CliError("validation_error", error.message, {
+                category: "validation",
+                cause: error,
+            });
+        }
+        if (isLikelyNetworkError(error)) {
+            return new CliError("network_error", error.message, {
+                category: "network",
+                cause: error,
+            });
+        }
+        return new CliError("unexpected_error", error.message, {
+            category: "unexpected",
+            cause: error,
+        });
+    }
+    return new CliError("unexpected_error", "Unexpected CLI failure.", {
+        category: "unexpected",
+    });
+}
+export function shouldEmitJsonError(argv) {
+    return argv.includes("--json");
+}
+export function formatCliErrorMessage(error) {
+    return `[${error.code}] ${error.message}`;
+}
+export function buildCliErrorPayload(error) {
+    const payload = {
+        ok: false,
+        error: {
+            code: error.code,
+            message: error.message,
+            category: error.category,
+            exit_code: error.exitCode,
+        },
+    };
+    if (error.status !== undefined) {
+        payload.error.status = error.status;
+    }
+    if (error.path !== undefined) {
+        payload.error.path = error.path;
+    }
+    if (error.requestId !== undefined) {
+        payload.error.request_id = error.requestId;
+    }
+    return payload;
+}
+function isCommanderError(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        typeof error.code === "string" &&
+        error.code.startsWith("commander."));
+}
+function stripCommanderErrorPrefix(message) {
+    return message.replace(/^error:\s*/i, "");
+}
+function isLikelyNetworkError(error) {
+    return (error.name === "TypeError" && /fetch|network|failed/i.test(error.message));
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,30 @@
+import { Command } from "commander";
+import { type CapabilitiesCommandIO, runCapabilitiesCommand } from "../commands/capabilities.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 { runSkillsInstallCommand } from "../commands/skills.js";
+import { runStatusCommand } from "../commands/status.js";
+import { type TerminalWriter } from "./terminal.js";
+export interface CliProgramOptions {
+    io?: CapabilitiesCommandIO;
+    env?: NodeJS.ProcessEnv;
+    fetch?: typeof fetch;
+    prompt?: (promptLabel: string) => Promise<string>;
+    stderr?: TerminalWriter;
+    suppressCommanderErrors?: boolean;
+}
+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 { runAssetOverviewCommand } from "../commands/assets.js";
+export { runCapabilitiesCommand, runStatusCommand };
+export { runInitCommand };
+export { runMarketAssetsCommand, runMarketPriceCommand };
+export { runPortfolioAddAssetsCommand, runPortfolioCreateCommand, runPortfolioGetCommand, runPortfolioListCommand, runPortfolioRemoveAssetsCommand, runPortfolioRenameCommand, };
+export { runSkillsInstallCommand };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/index.js

@@ -0,0 +1,112 @@
+import { Command } from "commander";
+import { registerAnalyticsCommands, } from "../commands/analytics.js";
+import { registerAssetsCommands, } from "../commands/assets.js";
+import { registerAuthCommands, } from "../commands/auth.js";
+import { registerCapabilitiesCommand, runCapabilitiesCommand, } from "../commands/capabilities.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 { registerSkillsCommands, runSkillsInstallCommand, } from "../commands/skills.js";
+import { registerStatusFlag, runStatusCommand, } from "../commands/status.js";
+import { buildCliErrorPayload, formatCliErrorMessage, normalizeCliError, shouldEmitJsonError, } from "./errors.js";
+import { styleErrorMessage } from "./terminal.js";
+export function createCliProgram(options = {}) {
+    const program = new Command();
+    const authContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+    };
+    const assetsContext = {
+        io: options.io,
+        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,
+        fetch: options.fetch,
+    };
+    const initContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+        prompt: options.prompt,
+    };
+    const portfoliosContext = {
+        io: options.io,
+        env: options.env,
+        fetch: options.fetch,
+    };
+    const skillsContext = {
+        io: options.io,
+        env: options.env,
+    };
+    const statusContext = {
+        io: options.io,
+        env: options.env,
+    };
+    program
+        .name("quantbrasil")
+        .description("Public QuantBrasil CLI for deterministic operations")
+        .version("0.0.0")
+        .exitOverride()
+        .showHelpAfterError()
+        .showSuggestionAfterError();
+    configureCommanderOutput(program, options);
+    registerCapabilitiesCommand(program, options.io);
+    registerAuthCommands(program, authContext);
+    registerAssetsCommands(program, assetsContext);
+    registerAnalyticsCommands(program, analyticsContext);
+    registerInitCommand(program, initContext);
+    registerMarketCommands(program, marketContext);
+    registerPortfoliosCommands(program, portfoliosContext);
+    registerSkillsCommands(program, skillsContext);
+    registerStatusFlag(program, statusContext);
+    return program;
+}
+export async function run(argv = process.argv, options = {}) {
+    const emitJsonError = shouldEmitJsonError(argv);
+    const program = createCliProgram({
+        ...options,
+        suppressCommanderErrors: emitJsonError,
+    });
+    const stderr = options.stderr ?? process.stderr;
+    const env = options.env ?? process.env;
+    try {
+        await program.parseAsync(argv);
+    }
+    catch (error) {
+        const cliError = normalizeCliError(error);
+        if (emitJsonError) {
+            stderr.write(`${JSON.stringify(buildCliErrorPayload(cliError), null, 2)}\n`);
+        }
+        else {
+            stderr.write(`${styleErrorMessage(formatCliErrorMessage(cliError), stderr, env)}\n`);
+        }
+        process.exitCode = cliError.exitCode;
+    }
+}
+function configureCommanderOutput(program, options) {
+    const stderr = options.stderr ?? process.stderr;
+    program.configureOutput({
+        writeErr: chunk => {
+            if (!options.suppressCommanderErrors) {
+                stderr.write(chunk);
+            }
+        },
+    });
+}
+export { runBetaCommand, runHistoricalReturnCommand, runVarCommand, } from "../commands/analytics.js";
+export { runAuthLoginCommand, runAuthLogoutCommand } 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 { runSkillsInstallCommand };

package/dist/cli/prompt.d.ts

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

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

@@ -0,0 +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"}

package/dist/cli/prompt.js

@@ -0,0 +1,40 @@
+import { stdin as input, stdout as output } from "node:process";
+import { createInterface } from "node:readline/promises";
+import { Writable } from "node:stream";
+import { createCliConfigError } from "./errors.js";
+class MutedWritable extends Writable {
+    target;
+    muted = false;
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+    _write(chunk, encoding, callback) {
+        if (!this.muted) {
+            this.target.write(chunk, encoding);
+        }
+        callback();
+    }
+}
+export async function promptForSecret(promptLabel) {
+    if (!input.isTTY || !output.isTTY) {
+        throw createCliConfigError("Interactive setup requires a TTY. Pass --api-key or set QUANTBRASIL_API_KEY.");
+    }
+    const mutedOutput = new MutedWritable(output);
+    const readline = createInterface({
+        input,
+        output: mutedOutput,
+        terminal: true,
+    });
+    try {
+        const answerPromise = readline.question(promptLabel);
+        mutedOutput.muted = true;
+        const answer = await answerPromise;
+        output.write("\n");
+        return answer.trim();
+    }
+    finally {
+        mutedOutput.muted = false;
+        readline.close();
+    }
+}

package/dist/cli/skills.d.ts

@@ -0,0 +1,26 @@
+export type SupportedSkillClientId = "codex" | "claude" | "agents";
+export interface SkillInstallTarget {
+    id: SupportedSkillClientId;
+    label: string;
+    rootDir: string;
+    skillsDir: string;
+    installDir: string;
+}
+export interface InstalledSkillTarget {
+    id: SupportedSkillClientId;
+    label: string;
+    installDir: string;
+}
+export interface SkippedSkillTarget {
+    id: SupportedSkillClientId;
+    label: string;
+    rootDir: string;
+}
+export interface SkillInstallResult {
+    installed: InstalledSkillTarget[];
+    skipped: SkippedSkillTarget[];
+}
+export declare function installBundledSkillEverywhere(env?: NodeJS.ProcessEnv): Promise<SkillInstallResult>;
+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

@@ -0,0 +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"}

package/dist/cli/skills.js

@@ -0,0 +1,94 @@
+import { access, cp, mkdir, rm } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createCliConfigError } from "./errors.js";
+const BUNDLED_SKILL_NAME = "quantbrasil";
+const AGENT_SKILLS_CONVENTION_ID = "agents";
+const SUPPORTED_SKILL_CLIENTS = [
+    { id: "codex", label: "Codex", rootDirName: ".codex" },
+    { id: "claude", label: "Claude", rootDirName: ".claude" },
+    { id: "agents", label: "Agent Skills", rootDirName: ".agents" },
+];
+export async function installBundledSkillEverywhere(env = process.env) {
+    const bundledSkillPath = resolveBundledSkillSourcePath();
+    await assertBundledSkillExists(bundledSkillPath);
+    const targets = resolveSkillInstallTargets(env);
+    const installed = [];
+    const skipped = [];
+    for (const target of targets) {
+        if (target.id !== AGENT_SKILLS_CONVENTION_ID &&
+            !(await pathExists(target.rootDir))) {
+            skipped.push({
+                id: target.id,
+                label: target.label,
+                rootDir: target.rootDir,
+            });
+            continue;
+        }
+        await mkdir(dirname(target.installDir), {
+            recursive: true,
+            mode: 0o700,
+        });
+        await rm(target.installDir, {
+            recursive: true,
+            force: true,
+        });
+        await cp(bundledSkillPath, target.installDir, {
+            recursive: true,
+        });
+        installed.push({
+            id: target.id,
+            label: target.label,
+            installDir: target.installDir,
+        });
+    }
+    if (installed.length === 0) {
+        const checkedRoots = targets.map(target => target.rootDir).join(", ");
+        throw createCliConfigError(`No supported agent clients detected. Checked: ${checkedRoots}.`);
+    }
+    return {
+        installed,
+        skipped,
+    };
+}
+export function resolveSkillInstallTargets(env = process.env) {
+    const home = resolveCliHomeDirectory(env);
+    return SUPPORTED_SKILL_CLIENTS.map(client => {
+        const rootDir = join(home, client.rootDirName);
+        const skillsDir = join(rootDir, "skills");
+        return {
+            id: client.id,
+            label: client.label,
+            rootDir,
+            skillsDir,
+            installDir: join(skillsDir, BUNDLED_SKILL_NAME),
+        };
+    });
+}
+export function resolveBundledSkillSourcePath() {
+    return fileURLToPath(new URL("../../skills/quantbrasil", import.meta.url));
+}
+async function assertBundledSkillExists(skillPath) {
+    const skillEntryPath = join(skillPath, "SKILL.md");
+    if (await pathExists(skillEntryPath)) {
+        return;
+    }
+    throw createCliConfigError(`Bundled QuantBrasil skill not found at ${skillEntryPath}. Reinstall the CLI package.`);
+}
+function resolveCliHomeDirectory(env) {
+    const home = env.HOME?.trim() || homedir();
+    if (!home) {
+        throw createCliConfigError("Could not resolve the HOME directory for skill install.");
+    }
+    return home;
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/cli/terminal.d.ts

@@ -0,0 +1,18 @@
+export interface TerminalWriter {
+    write(chunk: string): boolean;
+    isTTY?: boolean;
+}
+export interface TerminalTheme {
+    enabled: boolean;
+    accent(text: string): string;
+    bold(text: string): string;
+    dim(text: string): string;
+    success(text: string): string;
+    warning(text: string): string;
+    danger(text: string): string;
+    info(text: string): string;
+    label(text: string): string;
+}
+export declare function createTerminalTheme(writer: TerminalWriter, env?: NodeJS.ProcessEnv): TerminalTheme;
+export declare function styleErrorMessage(message: string, writer: TerminalWriter, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=terminal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/cli/terminal.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAUD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,aAAa,CAef;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAGR"}