@quantbrasil/cli 0.1.0-beta.0

package/dist/commands/assets.js

@@ -0,0 +1,350 @@
+import { assetOverviewSections } from "../vendor/core/capabilities/index.js";
+import { invokeCliCapability } from "../cli/client.js";
+import { createCliValidationError } from "../cli/errors.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerAssetsCommands(program, context = {}) {
+    const assetsCommand = program
+        .command("assets")
+        .description("Read asset analysis operations");
+    assetsCommand
+        .command("overview")
+        .description("Get a section-based overview for one asset")
+        .argument("<ticker>", "Ticker symbol, for example PETR4")
+        .requiredOption("--sections <sections>", `Comma-separated section list. Valid sections: ${assetOverviewSections.join(", ")}`)
+        .option("--json", "Show JSON output")
+        .action(async (ticker, options) => {
+        await runAssetOverviewCommand(ticker, options, context);
+    });
+}
+export async function runAssetOverviewCommand(ticker, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const sections = parseAssetOverviewSections(options.sections);
+    const response = await invokeCliCapability({
+        capability: "assets.overview",
+        input: {
+            ticker,
+            sections,
+        },
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    const data = response.data;
+    stdout.write(`${formatAssetOverviewHuman(data, sections, theme)}\n`);
+}
+export function parseAssetOverviewSections(rawSections) {
+    const sections = rawSections
+        .split(",")
+        .map(section => section.trim())
+        .filter(Boolean);
+    if (sections.length === 0) {
+        throw createCliValidationError(`Missing sections. Use one or more of: ${assetOverviewSections.join(", ")}.`);
+    }
+    const uniqueSections = Array.from(new Set(sections));
+    for (const section of uniqueSections) {
+        if (!assetOverviewSections.includes(section)) {
+            throw createCliValidationError(`Invalid section "${section}". Use only: ${assetOverviewSections.join(", ")}.`);
+        }
+    }
+    return uniqueSections;
+}
+export function formatAssetOverviewHuman(data, sections, theme = createTerminalTheme(process.stdout)) {
+    const lines = [theme.label("Asset overview"), ""];
+    const identity = data.asset?.symbol
+        ? data.asset.name?.trim()
+            ? `${theme.bold(data.asset.symbol)} ${theme.dim(`· ${data.asset.name}`)}`
+            : theme.bold(data.asset.symbol)
+        : theme.bold("Unknown asset");
+    lines.push(identity);
+    if (data.asset?.type) {
+        lines.push(`${theme.label("Type:")} ${data.asset.type}`);
+    }
+    if (data.as_of?.price_date) {
+        lines.push(`${theme.label("Price date:")} ${data.as_of.price_date}`);
+    }
+    if (data.as_of?.last_updated) {
+        lines.push(`${theme.label("Last updated:")} ${data.as_of.last_updated}`);
+    }
+    for (const section of sections) {
+        const sectionLines = formatAssetOverviewSection(data, section, theme);
+        if (sectionLines.length === 0) {
+            continue;
+        }
+        lines.push("");
+        lines.push(theme.label(sectionTitle(section)));
+        lines.push(...sectionLines);
+    }
+    return lines.join("\n");
+}
+function formatAssetOverviewSection(data, section, theme) {
+    switch (section) {
+        case "price":
+            return formatAssetOverviewPrice(data.price, theme);
+        case "performance":
+            return formatAssetOverviewValueItems(data.performance);
+        case "momentum":
+            return formatAssetOverviewMomentumItems(data.momentum);
+        case "rankings":
+            return formatAssetOverviewRankingItems(data.rankings);
+        case "technicals":
+            return formatStructuredBlock(data.technicals);
+        case "risk":
+            return formatStructuredBlock(data.risk);
+        case "fundamentals":
+            return formatStructuredBlock(data.fundamentals);
+        default:
+            return [];
+    }
+}
+function formatAssetOverviewPrice(price, theme) {
+    if (!price) {
+        return ["  No data available."];
+    }
+    const lines = [
+        `  Close: ${formatNumber(price.close)}`,
+        `  Open: ${formatNumber(price.open)}`,
+        `  High: ${formatNumber(price.high)}`,
+        `  Low: ${formatNumber(price.low)}`,
+    ];
+    if (price.volume !== null) {
+        lines.push(`  Volume: ${formatNumber(price.volume)}`);
+    }
+    if (price.prev_close !== null && price.prev_close !== undefined) {
+        lines.push(`  Previous close: ${formatNumber(price.prev_close)}`);
+    }
+    if (price.change_pct !== null && price.change_pct !== undefined) {
+        lines.push(`  Change: ${formatChangePct(price.change_pct, theme)}`);
+    }
+    return lines;
+}
+function formatAssetOverviewValueItems(items) {
+    if (!items || items.length === 0) {
+        return ["  No data available."];
+    }
+    return items.map(item => {
+        const value = item.value === null || item.value === undefined
+            ? "n/a"
+            : formatNumber(item.value);
+        return `  ${resolvePerformanceLabel(item)}: ${value}`;
+    });
+}
+function formatAssetOverviewMomentumItems(items) {
+    if (!items || items.length === 0) {
+        return ["  No data available."];
+    }
+    return items.map(item => {
+        const parts = [`momentum=${formatNullableNumber(item.momentum)}`];
+        if (item.r_squared !== null && item.r_squared !== undefined) {
+            parts.push(`r²=${formatNumber(item.r_squared)}`);
+        }
+        parts.push(`regression=${item.regression_type}`);
+        return `  ${item.label}: ${parts.join(", ")}`;
+    });
+}
+function formatAssetOverviewRankingItems(items) {
+    if (!items || items.length === 0) {
+        return ["  No data available."];
+    }
+    return items.map(item => {
+        if (item.position !== null && item.position !== undefined) {
+            if (item.total !== null && item.total !== undefined) {
+                return `  ${item.label}: ${item.position}/${item.total}`;
+            }
+            return `  ${item.label}: ${item.position}`;
+        }
+        return `  ${item.label}: n/a`;
+    });
+}
+function formatStructuredBlock(value, indent = 2) {
+    if (value === null || value === undefined) {
+        return [`${pad(indent)}No data available.`];
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return [`${pad(indent)}No data available.`];
+        }
+        return value.flatMap(item => formatStructuredArrayItem(item, indent));
+    }
+    if (typeof value !== "object") {
+        return [`${pad(indent)}${formatScalar(value)}`];
+    }
+    const lines = [];
+    for (const [key, nestedValue] of Object.entries(value)) {
+        if (nestedValue === null || nestedValue === undefined) {
+            continue;
+        }
+        if (isScalar(nestedValue)) {
+            lines.push(`${pad(indent)}${humanizeKey(key)}: ${formatScalar(nestedValue)}`);
+            continue;
+        }
+        lines.push(`${pad(indent)}${humanizeKey(key)}:`);
+        lines.push(...formatStructuredBlock(nestedValue, indent + 2));
+    }
+    return lines.length > 0 ? lines : [`${pad(indent)}No data available.`];
+}
+function formatStructuredArrayItem(item, indent) {
+    if (item === null || item === undefined) {
+        return [`${pad(indent)}- n/a`];
+    }
+    if (isScalar(item)) {
+        return [`${pad(indent)}- ${formatScalar(item)}`];
+    }
+    if (Array.isArray(item)) {
+        const lines = [`${pad(indent)}-`];
+        lines.push(...formatStructuredBlock(item, indent + 2));
+        return lines;
+    }
+    const label = resolveObjectLabel(item) ??
+        Object.entries(item)
+            .map(([key, value]) => `${humanizeKey(key)}=${formatScalarValue(value)}`)
+            .join(", ");
+    return [`${pad(indent)}- ${label}`];
+}
+function resolveObjectLabel(value) {
+    if (typeof value.label === "string" && value.label.trim()) {
+        if ("value" in value) {
+            return `${value.label}: ${formatScalarValue(value.value)}`;
+        }
+        if ("position" in value) {
+            const position = formatScalarValue(value.position);
+            const total = formatScalarValue(value.total);
+            return `${value.label}: ${position}${total ? `/${total}` : ""}`;
+        }
+    }
+    return null;
+}
+function formatScalarValue(value) {
+    if (value === null || value === undefined) {
+        return "n/a";
+    }
+    if (isScalar(value)) {
+        return formatScalar(value);
+    }
+    if (Array.isArray(value)) {
+        return value.length === 0 ? "[]" : JSON.stringify(value);
+    }
+    return JSON.stringify(value);
+}
+function formatScalar(value) {
+    if (typeof value === "number") {
+        return formatNumber(value);
+    }
+    if (typeof value === "boolean") {
+        return value ? "yes" : "no";
+    }
+    return value;
+}
+function formatNumber(value) {
+    return new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: 4,
+    }).format(value);
+}
+function formatNullableNumber(value) {
+    if (value === null || value === undefined) {
+        return "n/a";
+    }
+    return formatNumber(value);
+}
+function formatChangePct(value, theme) {
+    const formatted = `${new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: 2,
+        minimumFractionDigits: 2,
+    }).format(value)}%`;
+    if (value > 0) {
+        return theme.success(formatted);
+    }
+    if (value < 0) {
+        return theme.danger(formatted);
+    }
+    return formatted;
+}
+function resolvePerformanceLabel(item) {
+    switch (item.id) {
+        case "D1":
+            return "1D";
+        case "CURRENT_WEEK":
+            return "WTD";
+        case "CURRENT_MONTH":
+            return "MTD";
+        case "CURRENT_YEAR":
+            return "YTD";
+        case "DAYS_30":
+            return "30D";
+        case "DAYS_90":
+            return "90D";
+        case "DAYS_180":
+            return "180D";
+        case "DAYS_365":
+            return "1Y";
+        default:
+            return item.label;
+    }
+}
+function sectionTitle(section) {
+    switch (section) {
+        case "technicals":
+            return "Technicals";
+        case "fundamentals":
+            return "Fundamentals";
+        case "performance":
+            return "Performance";
+        case "momentum":
+            return "Momentum";
+        case "rankings":
+            return "Rankings";
+        case "price":
+            return "Price";
+        case "risk":
+            return "Risk";
+    }
+}
+function humanizeKey(key) {
+    const exactLabels = {
+        p_l: "P/L",
+        p_vp: "P/VP",
+        roe: "ROE",
+        roic: "ROIC",
+        ev_ebit: "EV/EBIT",
+        ev_ebitda: "EV/EBITDA",
+        atr14: "ATR14",
+        rsi2: "RSI2",
+        rsi14: "RSI14",
+        sma20: "SMA20",
+        sma50: "SMA50",
+        sma200: "SMA200",
+        value: "Value",
+        target: "Target",
+        source: "Source",
+        max_lag: "Max lag",
+        upside_pct: "Upside %",
+        mm50_is_up: "MM50 uptrend",
+        distance_to_sma200_pct: "Distance to SMA200 %",
+        distance_to_high_pct: "Distance to high %",
+        max_drawdown_1y_pct: "Max drawdown 1Y %",
+        volatility_30d_ann: "Volatility 30D annualized",
+        range_52w: "52-week range",
+        k: "%K",
+        d: "%D",
+    };
+    if (exactLabels[key]) {
+        return exactLabels[key];
+    }
+    return key
+        .split("_")
+        .map(part => part.length <= 3
+        ? part.toUpperCase()
+        : part[0].toUpperCase() + part.slice(1))
+        .join(" ");
+}
+function pad(size) {
+    return " ".repeat(size);
+}
+function isScalar(value) {
+    return (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean");
+}

package/dist/commands/auth.d.ts

@@ -0,0 +1,17 @@
+import { Command } from "commander";
+import { type TerminalWriter } from "../cli/terminal.js";
+export interface AuthCommandIO {
+    stdout: TerminalWriter;
+}
+export interface AuthCommandContext {
+    io?: AuthCommandIO;
+    env?: NodeJS.ProcessEnv;
+    fetch?: typeof fetch;
+}
+export interface AuthLoginCommandOptions {
+    apiKey: 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>;
+//# sourceMappingURL=auth.d.ts.map

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

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

package/dist/commands/auth.js

@@ -0,0 +1,48 @@
+import { verifyCliApiKey } from "../cli/auth.js";
+import { clearCliStoredAuth, saveCliApiKey } from "../cli/config.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerAuthCommands(program, context = {}) {
+    const authCommand = program
+        .command("auth")
+        .description("Manage local authentication");
+    authCommand
+        .command("login")
+        .description("Store an API key locally")
+        .requiredOption("--api-key <token>", "QuantBrasil API key")
+        .action(async (options) => {
+        await runAuthLoginCommand(options, context);
+    });
+    authCommand
+        .command("logout")
+        .description("Remove the locally stored API key")
+        .action(async () => {
+        await runAuthLogoutCommand(context);
+    });
+}
+export async function runAuthLoginCommand(options, context = {}) {
+    const stdout = getStdout(context);
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const verifiedAuth = await verifyCliApiKey(options.apiKey, {
+        env: context.env,
+        fetch: context.fetch,
+    });
+    const configPath = await saveCliApiKey(options.apiKey, context.env ?? process.env);
+    stdout.write([
+        `${theme.success(theme.bold("API key saved."))} ${theme.info(verifiedAuth.email)}`,
+        `${theme.dim(`Key: ${verifiedAuth.apiKey.name} (${verifiedAuth.apiKey.keyPrefix})`)}`,
+        `${theme.dim(configPath)}`,
+    ].join("\n") + "\n");
+}
+export async function runAuthLogoutCommand(context = {}) {
+    const stdout = getStdout(context);
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const { configPath, removed } = await clearCliStoredAuth(context.env ?? process.env);
+    if (removed) {
+        stdout.write(`${theme.info(theme.bold("Local API key removed."))} ${theme.dim(configPath)}\n`);
+        return;
+    }
+    stdout.write(`${theme.dim(`No local API key was stored at ${configPath}.`)}\n`);
+}
+function getStdout(context) {
+    return context.io?.stdout ?? process.stdout;
+}

package/dist/commands/capabilities.d.ts

@@ -0,0 +1,25 @@
+import type { CapabilityDefinition } from "../vendor/core/capabilities/index.js";
+import { Command } from "commander";
+import { type TerminalWriter } from "../cli/terminal.js";
+export interface CapabilitiesCommandOptions {
+    json?: boolean;
+}
+export interface CapabilitiesCommandIO {
+    stdout: TerminalWriter;
+}
+export interface CapabilityInspectionEntry {
+    id: string;
+    kind: CapabilityDefinition["kind"];
+    description: string;
+    visibility: readonly CapabilityDefinition["visibility"][number][];
+    http: CapabilityDefinition["http"];
+    cli: CapabilityDefinition["cli"];
+    tool: CapabilityDefinition["tool"];
+    outputModes: readonly CapabilityDefinition["outputModes"][number][];
+}
+export declare function registerCapabilitiesCommand(program: Command, io?: CapabilitiesCommandIO): void;
+export declare function runCapabilitiesCommand(options: CapabilitiesCommandOptions, io?: CapabilitiesCommandIO): Promise<void>;
+export declare function getCapabilityInspectionEntries(): CapabilityInspectionEntry[];
+export declare function formatCapabilitiesJson(): string;
+export declare function formatCapabilitiesHuman(theme?: import("../cli/terminal.js").TerminalTheme): string;
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/commands/capabilities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,SAAS,oBAAoB,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAClE,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACnC,GAAG,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,SAAS,oBAAoB,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;CACrE;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,EAChB,EAAE,GAAE,qBAAkD,GACrD,IAAI,CAQN;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,0BAA0B,EACnC,EAAE,GAAE,qBAAkD,GACrD,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,8BAA8B,IAAI,yBAAyB,EAAE,CAW5E;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,uBAAuB,CACrC,KAAK,6CAAsC,GAC1C,MAAM,CA0BR"}

package/dist/commands/capabilities.js

@@ -0,0 +1,61 @@
+import { capabilityRegistry } from "../vendor/core/capabilities/index.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerCapabilitiesCommand(program, io = { stdout: process.stdout }) {
+    program
+        .command("capabilities")
+        .description("List available operations")
+        .option("--json", "Show JSON output")
+        .action(async (options) => {
+        await runCapabilitiesCommand(options, io);
+    });
+}
+export async function runCapabilitiesCommand(options, io = { stdout: process.stdout }) {
+    const theme = createTerminalTheme(io.stdout);
+    const output = options.json
+        ? formatCapabilitiesJson()
+        : formatCapabilitiesHuman(theme);
+    io.stdout.write(`${output}\n`);
+}
+export function getCapabilityInspectionEntries() {
+    return capabilityRegistry.map(capability => ({
+        id: capability.id,
+        kind: capability.kind,
+        description: capability.description,
+        visibility: capability.visibility,
+        http: capability.http,
+        cli: capability.cli,
+        tool: capability.tool,
+        outputModes: capability.outputModes,
+    }));
+}
+export function formatCapabilitiesJson() {
+    return JSON.stringify(getCapabilityInspectionEntries(), null, 2);
+}
+export function formatCapabilitiesHuman(theme = createTerminalTheme(process.stdout)) {
+    const grouped = groupCapabilitiesByCliGroup(capabilityRegistry);
+    const lines = [theme.label("Available operations"), ""];
+    for (const [group, capabilities] of grouped) {
+        lines.push(theme.label(group));
+        for (const capability of capabilities) {
+            lines.push(`  ${theme.bold(capability.cli.command.padEnd(18))} ${capability.cli.summary}`);
+            lines.push(`    ${theme.dim(`id: ${capability.id}`)}`);
+            lines.push(`    ${theme.dim(`route: ${capability.http.method} ${capability.http.path}`)}`);
+            lines.push(`    ${theme.dim(`examples: ${capability.cli.examples.join(" | ")}`)}`);
+        }
+        lines.push("");
+    }
+    lines.push(theme.dim("Use --json to show JSON output."));
+    return lines.join("\n");
+}
+function groupCapabilitiesByCliGroup(capabilities) {
+    const groups = new Map();
+    for (const capability of capabilities) {
+        const bucket = groups.get(capability.cli.group) ?? [];
+        bucket.push(capability);
+        groups.set(capability.cli.group, bucket);
+    }
+    return [...groups.entries()].map(([group, entries]) => [
+        group,
+        [...entries].sort((left, right) => left.cli.command.localeCompare(right.cli.command)),
+    ]);
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,17 @@
+import { Command } from "commander";
+import { type TerminalWriter } from "../cli/terminal.js";
+export interface InitCommandIO {
+    stdout: TerminalWriter;
+}
+export interface InitCommandContext {
+    io?: InitCommandIO;
+    env?: NodeJS.ProcessEnv;
+    fetch?: typeof fetch;
+    prompt?: (promptLabel: string) => Promise<string>;
+}
+export interface InitCommandOptions {
+    apiKey?: string;
+}
+export declare function registerInitCommand(program: Command, context?: InitCommandContext): void;
+export declare function runInitCommand(options: InitCommandOptions, context?: InitCommandContext): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG9E,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;IACrB,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAQN;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAqHf"}

package/dist/commands/init.js

@@ -0,0 +1,89 @@
+import { verifyCliApiKey } from "../cli/auth.js";
+import { resolveCliAuth, resolveCliStatusSnapshot, saveCliApiKey, } from "../cli/config.js";
+import { CliError } from "../cli/errors.js";
+import { promptForSecret } from "../cli/prompt.js";
+import { installBundledSkillEverywhere } from "../cli/skills.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+import { formatSkillsInstallResult } from "./skills.js";
+export function registerInitCommand(program, context = {}) {
+    program
+        .command("init")
+        .description("Set up authentication and install bundled public skills")
+        .option("--api-key <token>", "QuantBrasil API key")
+        .action(async (options) => {
+        await runInitCommand(options, context);
+    });
+}
+export async function runInitCommand(options, context = {}) {
+    const env = context.env ?? process.env;
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, env);
+    const lines = [theme.label("QuantBrasil CLI Setup"), ""];
+    const resolvedAuth = await resolveCliAuth(env);
+    if (options.apiKey) {
+        const verifiedAuth = await verifyCliApiKey(options.apiKey, {
+            env,
+            fetch: context.fetch,
+        });
+        const configPath = await saveCliApiKey(options.apiKey, env);
+        lines.push(`${theme.success("API key verified and saved.")} ${theme.info(verifiedAuth.email)}`, `${theme.dim(`Key: ${verifiedAuth.apiKey.name} (${verifiedAuth.apiKey.keyPrefix})`)}`, `${theme.dim(configPath)}`);
+    }
+    else if (resolvedAuth !== null) {
+        try {
+            await verifyCliApiKey(resolvedAuth.apiKey, {
+                env,
+                fetch: context.fetch,
+            });
+        }
+        catch (error) {
+            if (resolvedAuth.source === "env") {
+                if (error instanceof CliError) {
+                    throw new CliError(error.code, `Existing QUANTBRASIL_API_KEY is not valid for the current backend. ${error.message}`, {
+                        category: error.category,
+                        status: error.status,
+                        path: error.path,
+                        requestId: error.requestId,
+                        cause: error,
+                    });
+                }
+                if (error instanceof Error) {
+                    throw new CliError("auth_failed", `Existing QUANTBRASIL_API_KEY is not valid for the current backend. ${error.message}`, {
+                        category: "auth",
+                        cause: error,
+                    });
+                }
+                throw error;
+            }
+            const replacementApiKey = await (context.prompt ?? promptForSecret)("Stored API key is invalid. Enter a replacement key (qb_live_<id>.<secret>): ");
+            const verifiedAuth = await verifyCliApiKey(replacementApiKey, {
+                env,
+                fetch: context.fetch,
+            });
+            const configPath = await saveCliApiKey(replacementApiKey, env);
+            lines.push(`${theme.success("Stored API key replaced.")} ${theme.info(verifiedAuth.email)}`, `${theme.dim(`Key: ${verifiedAuth.apiKey.name} (${verifiedAuth.apiKey.keyPrefix})`)}`, `${theme.dim(configPath)}`);
+        }
+        if (lines.length === 2) {
+            lines.push(`${theme.info("Authentication already configured and verified.")} ${theme.dim(`Source: ${resolvedAuth.source}`)}`);
+        }
+    }
+    else {
+        const apiKey = await (context.prompt ?? promptForSecret)("QuantBrasil API key (qb_live_<id>.<secret>): ");
+        const verifiedAuth = await verifyCliApiKey(apiKey, {
+            env,
+            fetch: context.fetch,
+        });
+        const configPath = await saveCliApiKey(apiKey, env);
+        lines.push(`${theme.success("API key verified and saved.")} ${theme.info(verifiedAuth.email)}`, `${theme.dim(`Key: ${verifiedAuth.apiKey.name} (${verifiedAuth.apiKey.keyPrefix})`)}`, `${theme.dim(configPath)}`);
+    }
+    const skillInstallResult = await installBundledSkillEverywhere(env);
+    const status = await resolveCliStatusSnapshot(env);
+    lines.push("");
+    lines.push(formatSkillsInstallResult(skillInstallResult, theme));
+    lines.push("");
+    lines.push(theme.label("Ready"));
+    lines.push(`${theme.label("Backend:")} ${status.backendUrl} ${theme.dim(status.backendSource === "override" ? "(QB_BACKEND_URL)" : "(default)")}`);
+    lines.push(`${theme.label("Authentication:")} ${status.isReady ? theme.success("yes") : theme.warning("no")}`);
+    lines.push(`${theme.label("Skills installed:")} ${theme.success(String(skillInstallResult.installed.length))}`);
+    lines.push(theme.dim("Restart your agent client if it was already running so it can discover the new skill."));
+    stdout.write(`${lines.join("\n")}\n`);
+}

package/dist/commands/market.d.ts

@@ -0,0 +1,45 @@
+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 MarketCommandIO {
+    stdout: TerminalWriter;
+}
+export interface MarketAssetsCommandOptions {
+    type?: string;
+    json?: boolean;
+}
+export interface MarketPriceCommandOptions {
+    date?: string;
+    timeframe?: string;
+    json?: boolean;
+}
+export interface MonitoredAssetsResponse {
+    [key: string]: JsonValue;
+    total: number;
+    groups: Record<string, string[]>;
+}
+export interface MarketPriceResponse {
+    [key: string]: JsonValue;
+    ticker: string;
+    name: string | null;
+    type: string | null;
+    timeframe: string;
+    price_date: string;
+    close: number;
+    open: number;
+    high: number;
+    low: number;
+    volume: number | null;
+    prev_close: number | null;
+    change_pct: number | null;
+}
+export interface MarketCommandContext extends CliInvokeContext {
+    io?: MarketCommandIO;
+}
+export declare function registerMarketCommands(program: Command, context?: MarketCommandContext): void;
+export declare function runMarketAssetsCommand(options: MarketAssetsCommandOptions, context?: MarketCommandContext): Promise<void>;
+export declare function runMarketPriceCommand(ticker: string, options: MarketPriceCommandOptions, context?: MarketCommandContext): Promise<void>;
+export declare function formatMarketAssetsHuman(data: MonitoredAssetsResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+export declare function formatMarketPriceHuman(data: MarketPriceResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+//# sourceMappingURL=market.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../../src/commands/market.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,EAAE,CAAC,EAAE,eAAe,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,oBAAyB,GACjC,IAAI,CA2BN;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,0BAA0B,EACnC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAgBf;AA0CD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,uBAAuB,EAC7B,KAAK,6CAAsC,GAC1C,MAAM,CAgBR;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,mBAAmB,EACzB,KAAK,6CAAsC,GAC1C,MAAM,CAoCR"}