@quantbrasil/cli 0.1.0-beta.0

package/dist/commands/market.js

@@ -0,0 +1,162 @@
+import { monitoredAssetTypes } 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 registerMarketCommands(program, context = {}) {
+    const marketCommand = program
+        .command("market")
+        .description("Read market data operations");
+    marketCommand
+        .command("assets")
+        .description("List the monitored QuantBrasil asset universe")
+        .option("--type <type>", `Filter by exact asset type (${monitoredAssetTypes.join(", ")})`)
+        .option("--json", "Show JSON output")
+        .action(async (options) => {
+        await runMarketAssetsCommand(options, context);
+    });
+    marketCommand
+        .command("price")
+        .description("Get the latest or historical price for one ticker")
+        .argument("<ticker>", "Ticker symbol, for example PETR4")
+        .option("--date <date>", "Reference date in ISO format (YYYY-MM-DD)")
+        .option("--timeframe <timeframe>", "Timeframe identifier", "D1")
+        .option("--json", "Show JSON output")
+        .action(async (ticker, options) => {
+        await runMarketPriceCommand(ticker, options, context);
+    });
+}
+export async function runMarketAssetsCommand(options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const assetType = normalizeMarketAssetType(options.type);
+    const response = await invokeCliCapability({
+        capability: "market.assets",
+        input: assetType ? { type: assetType } : {},
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatMarketAssetsHuman(response.data, theme)}\n`);
+}
+export async function runMarketPriceCommand(ticker, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "market.price",
+        input: buildMarketPriceInput(ticker, options),
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatMarketPriceHuman(response.data, theme)}\n`);
+}
+function normalizeMarketAssetType(rawType) {
+    if (!rawType) {
+        return undefined;
+    }
+    const normalized = rawType.trim();
+    if (!normalized) {
+        return undefined;
+    }
+    if (!monitoredAssetTypes.includes(normalized)) {
+        throw createCliValidationError(`Invalid asset type. Use one of: ${monitoredAssetTypes.join(", ")}.`);
+    }
+    return normalized;
+}
+function buildMarketPriceInput(ticker, options) {
+    const payload = {
+        ticker,
+        timeframe: options.timeframe ?? "D1",
+    };
+    if (options.date) {
+        payload.date = options.date;
+    }
+    return payload;
+}
+export function formatMarketAssetsHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        theme.label("Available market assets"),
+        "",
+        `${theme.label("Total:")} ${formatInteger(data.total)}`,
+    ];
+    for (const [group, symbols] of Object.entries(data.groups)) {
+        lines.push("");
+        lines.push(`${theme.label(group)} ${theme.dim(`(${formatInteger(symbols.length)})`)}`);
+        lines.push(...wrapSymbols(symbols));
+    }
+    return lines.join("\n");
+}
+export function formatMarketPriceHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const identity = data.name && data.name.trim()
+        ? `${theme.bold(data.ticker)} ${theme.dim(`· ${data.name}`)}`
+        : theme.bold(data.ticker);
+    const lines = [theme.label("Market price"), "", identity];
+    if (data.type) {
+        lines.push(`${theme.label("Type:")} ${data.type}`);
+    }
+    lines.push(`${theme.label("Timeframe:")} ${data.timeframe}`);
+    lines.push(`${theme.label("Price date:")} ${data.price_date}`);
+    lines.push("");
+    lines.push(`${theme.label("Close:")} ${formatNumber(data.close)}`);
+    lines.push(`${theme.label("Open:")} ${formatNumber(data.open)}`);
+    lines.push(`${theme.label("High:")} ${formatNumber(data.high)}`);
+    lines.push(`${theme.label("Low:")} ${formatNumber(data.low)}`);
+    if (data.volume !== null) {
+        lines.push(`${theme.label("Volume:")} ${formatNumber(data.volume)}`);
+    }
+    if (data.prev_close !== null) {
+        lines.push(`${theme.label("Previous close:")} ${formatNumber(data.prev_close)}`);
+    }
+    if (data.change_pct !== null) {
+        lines.push(`${theme.label("Change:")} ${formatChangePct(data.change_pct, theme)}`);
+    }
+    return lines.join("\n");
+}
+function formatNumber(value) {
+    return new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: 4,
+    }).format(value);
+}
+function formatInteger(value) {
+    return new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: 0,
+    }).format(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 wrapSymbols(symbols) {
+    const lines = [];
+    let current = "  ";
+    for (const symbol of symbols) {
+        const next = current.trim() === ""
+            ? `  ${symbol}`
+            : `${current}${current === "  " ? "" : ", "}${symbol}`;
+        if (next.length > 88 && current !== "  ") {
+            lines.push(current);
+            current = `  ${symbol}`;
+            continue;
+        }
+        current = next;
+    }
+    if (current.trim()) {
+        lines.push(current);
+    }
+    return lines;
+}

package/dist/commands/portfolios.d.ts

@@ -0,0 +1,60 @@
+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 PortfoliosCommandIO {
+    stdout: TerminalWriter;
+}
+export interface PortfolioListCommandOptions {
+    json?: boolean;
+}
+export interface PortfolioGetCommandOptions {
+    json?: boolean;
+}
+export interface PortfolioMutationCommandOptions {
+    json?: boolean;
+}
+export interface PortfolioOut {
+    [key: string]: JsonValue;
+    id: number;
+    name: string;
+    symbols: string[];
+    weights: Record<string, number> | null;
+}
+export interface PortfolioListResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    portfolios: PortfolioOut[];
+    total: number;
+}
+export interface PortfolioGetResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    portfolio: PortfolioOut;
+}
+export interface PortfolioCreateResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    summary_markdown: string;
+    portfolio: PortfolioOut;
+}
+export interface PortfolioMutationResponse {
+    [key: string]: JsonValue;
+    ok: boolean;
+    summary_markdown: string;
+    portfolio: PortfolioOut;
+}
+export interface PortfoliosCommandContext extends CliInvokeContext {
+    io?: PortfoliosCommandIO;
+}
+export declare function registerPortfoliosCommands(program: Command, context?: PortfoliosCommandContext): void;
+export declare function runPortfolioListCommand(options: PortfolioListCommandOptions, context?: PortfoliosCommandContext): Promise<void>;
+export declare function runPortfolioGetCommand(portfolioId: number, options: PortfolioGetCommandOptions, context?: PortfoliosCommandContext): Promise<void>;
+export declare function runPortfolioCreateCommand(name: string, options: PortfolioMutationCommandOptions, context?: PortfoliosCommandContext): Promise<void>;
+export declare function runPortfolioRenameCommand(portfolioId: number, name: string, options: PortfolioMutationCommandOptions, context?: PortfoliosCommandContext): Promise<void>;
+export declare function runPortfolioAddAssetsCommand(portfolioId: number, symbols: string[], options: PortfolioMutationCommandOptions, context?: PortfoliosCommandContext): Promise<void>;
+export declare function runPortfolioRemoveAssetsCommand(portfolioId: number, symbols: string[], options: PortfolioMutationCommandOptions, context?: PortfoliosCommandContext): Promise<void>;
+export declare function formatPortfolioListHuman(data: PortfolioListResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+export declare function formatPortfolioGetHuman(data: PortfolioGetResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+export declare function formatPortfolioMutationHuman(data: PortfolioCreateResponse | PortfolioMutationResponse, theme?: import("../cli/terminal.js").TerminalTheme): string;
+//# sourceMappingURL=portfolios.d.ts.map

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

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

package/dist/commands/portfolios.js

@@ -0,0 +1,298 @@
+import { invokeCliCapability } from "../cli/client.js";
+import { createCliMutationFailedError, createCliValidationError, } from "../cli/errors.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerPortfoliosCommands(program, context = {}) {
+    const portfoliosCommand = program
+        .command("portfolios")
+        .description("Manage saved portfolios");
+    portfoliosCommand
+        .command("list")
+        .description("List saved portfolios for authenticated user")
+        .option("--json", "Show JSON output")
+        .action(async (options) => {
+        await runPortfolioListCommand(options, context);
+    });
+    portfoliosCommand
+        .command("get")
+        .description("Get one saved portfolio by id")
+        .argument("<portfolio-id>", "Saved portfolio id", parsePortfolioIdArgument)
+        .option("--json", "Show JSON output")
+        .action(async (portfolioId, options) => {
+        await runPortfolioGetCommand(portfolioId, options, context);
+    });
+    portfoliosCommand
+        .command("create")
+        .description("Create a new portfolio")
+        .argument("<name>", "Portfolio name")
+        .option("--json", "Show JSON output")
+        .action(async (name, options) => {
+        await runPortfolioCreateCommand(name, options, context);
+    });
+    portfoliosCommand
+        .command("rename")
+        .description("Rename an existing portfolio")
+        .argument("<portfolio-id>", "Saved portfolio id", parsePortfolioIdArgument)
+        .argument("<name>", "New portfolio name")
+        .option("--json", "Show JSON output")
+        .action(async (portfolioId, name, options) => {
+        await runPortfolioRenameCommand(portfolioId, name, options, context);
+    });
+    portfoliosCommand
+        .command("add-assets")
+        .description("Add one or more monitored tickers to a portfolio")
+        .argument("<portfolio-id>", "Saved portfolio id", parsePortfolioIdArgument)
+        .argument("<ticker...>", "One or more tickers to add")
+        .option("--json", "Show JSON output")
+        .action(async (portfolioId, symbols, options) => {
+        await runPortfolioAddAssetsCommand(portfolioId, symbols, options, context);
+    });
+    portfoliosCommand
+        .command("remove-assets")
+        .description("Remove one or more monitored tickers from a portfolio")
+        .argument("<portfolio-id>", "Saved portfolio id", parsePortfolioIdArgument)
+        .argument("<ticker...>", "One or more tickers to remove")
+        .option("--json", "Show JSON output")
+        .action(async (portfolioId, symbols, options) => {
+        await runPortfolioRemoveAssetsCommand(portfolioId, symbols, options, context);
+    });
+}
+export async function runPortfolioListCommand(options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "portfolios.list",
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatPortfolioListHuman(response.data, theme)}\n`);
+}
+export async function runPortfolioGetCommand(portfolioId, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "portfolios.get",
+        input: {
+            portfolio_id: portfolioId,
+        },
+        env: context.env,
+        fetch: context.fetch,
+    });
+    if (options.json) {
+        stdout.write(`${JSON.stringify(response.data, null, 2)}\n`);
+        return;
+    }
+    stdout.write(`${formatPortfolioGetHuman(response.data, theme)}\n`);
+}
+export async function runPortfolioCreateCommand(name, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "portfolios.create",
+        input: {
+            name: parsePortfolioNameArgument(name),
+        },
+        env: context.env,
+        fetch: context.fetch,
+    });
+    writeMutationResponse(response.data, options.json, stdout, theme);
+}
+export async function runPortfolioRenameCommand(portfolioId, name, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "portfolios.rename",
+        input: {
+            portfolio_id: portfolioId,
+            name: parsePortfolioNameArgument(name),
+        },
+        env: context.env,
+        fetch: context.fetch,
+    });
+    writeMutationResponse(response.data, options.json, stdout, theme);
+}
+export async function runPortfolioAddAssetsCommand(portfolioId, symbols, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "portfolios.add-assets",
+        input: {
+            portfolio_id: portfolioId,
+            symbols: parseSymbolArguments(symbols),
+        },
+        env: context.env,
+        fetch: context.fetch,
+    });
+    writeMutationResponse(response.data, options.json, stdout, theme);
+}
+export async function runPortfolioRemoveAssetsCommand(portfolioId, symbols, options, context = {}) {
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const response = await invokeCliCapability({
+        capability: "portfolios.remove-assets",
+        input: {
+            portfolio_id: portfolioId,
+            symbols: parseSymbolArguments(symbols),
+        },
+        env: context.env,
+        fetch: context.fetch,
+    });
+    writeMutationResponse(response.data, options.json, stdout, theme);
+}
+export function formatPortfolioListHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        theme.label("Portfolios"),
+        "",
+        `${theme.label("Total:")} ${formatInteger(data.total)}`,
+    ];
+    if (data.portfolios.length === 0) {
+        lines.push("");
+        lines.push("No saved portfolios.");
+        return lines.join("\n");
+    }
+    for (const portfolio of data.portfolios) {
+        lines.push("");
+        lines.push(`${theme.bold(String(portfolio.id))} ${theme.dim("·")} ${portfolio.name}`);
+        lines.push(`  ${theme.label("Symbols:")} ${formatSymbolSummary(portfolio.symbols)}`);
+        if (portfolio.weights) {
+            lines.push(`  ${theme.label("Weights:")} ${formatWeightsInline(portfolio)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatPortfolioGetHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const { portfolio } = data;
+    const lines = [
+        theme.label("Portfolio"),
+        "",
+        `${theme.bold(String(portfolio.id))} ${theme.dim("·")} ${portfolio.name}`,
+        `${theme.label("Assets:")} ${formatInteger(portfolio.symbols.length)}`,
+    ];
+    if (portfolio.symbols.length === 0) {
+        lines.push("");
+        lines.push("No assets in this portfolio.");
+        return lines.join("\n");
+    }
+    lines.push("");
+    lines.push(theme.label("Holdings"));
+    if (portfolio.weights) {
+        for (const symbol of portfolio.symbols) {
+            const weight = portfolio.weights[symbol];
+            const suffix = weight === undefined ? "n/a" : `${formatNumber(weight)}%`;
+            lines.push(`  - ${symbol}: ${suffix}`);
+        }
+    }
+    else {
+        for (const symbol of portfolio.symbols) {
+            lines.push(`  - ${symbol}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatPortfolioMutationHuman(data, theme = createTerminalTheme(process.stdout)) {
+    const lines = [
+        data.ok
+            ? theme.success(theme.bold("Portfolio"))
+            : theme.danger(theme.bold("Portfolio mutation failed")),
+        "",
+        data.summary_markdown,
+        "",
+        `${theme.bold(String(data.portfolio.id))} ${theme.dim("·")} ${data.portfolio.name || "Portfolio"}`,
+        `${theme.label("Assets:")} ${formatInteger(data.portfolio.symbols.length)}`,
+    ];
+    if (data.portfolio.symbols.length > 0) {
+        lines.push("");
+        lines.push(theme.label("Holdings"));
+        for (const symbol of data.portfolio.symbols) {
+            lines.push(`  - ${symbol}`);
+        }
+    }
+    return lines.join("\n");
+}
+function parsePortfolioIdArgument(value) {
+    const normalized = value.trim();
+    if (!/^\d+$/.test(normalized)) {
+        throw createCliValidationError("Portfolio id must be a positive integer.");
+    }
+    const portfolioId = Number(normalized);
+    if (!Number.isSafeInteger(portfolioId) || portfolioId <= 0) {
+        throw createCliValidationError("Portfolio id must be a positive integer.");
+    }
+    return portfolioId;
+}
+function parsePortfolioNameArgument(value) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw createCliValidationError("Portfolio name cannot be empty.");
+    }
+    if (normalized.length > 100) {
+        throw createCliValidationError("Portfolio name cannot exceed 100 characters.");
+    }
+    return normalized;
+}
+function parseSymbolArguments(values) {
+    const symbols = values.map(symbol => symbol.trim().toUpperCase());
+    if (symbols.length === 0 || symbols.some(symbol => symbol.length === 0)) {
+        throw createCliValidationError("At least one ticker is required.");
+    }
+    return dedupeSymbols(symbols);
+}
+function dedupeSymbols(symbols) {
+    const seen = new Set();
+    const deduped = [];
+    for (const symbol of symbols) {
+        if (seen.has(symbol)) {
+            continue;
+        }
+        seen.add(symbol);
+        deduped.push(symbol);
+    }
+    return deduped;
+}
+function writeMutationResponse(data, json, stdout, theme) {
+    if (!data.ok) {
+        if (!json) {
+            stdout.write(`${formatPortfolioMutationHuman(data, theme)}\n`);
+        }
+        throw createCliMutationFailedError(data.summary_markdown);
+    }
+    if (json) {
+        stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+    }
+    else {
+        stdout.write(`${formatPortfolioMutationHuman(data, theme)}\n`);
+    }
+}
+function formatSymbolSummary(symbols) {
+    if (symbols.length === 0) {
+        return "none";
+    }
+    return `${symbols.join(", ")} ${createCountSuffix(symbols.length)}`;
+}
+function formatWeightsInline(portfolio) {
+    if (!portfolio.weights) {
+        return "not set";
+    }
+    return portfolio.symbols
+        .map(symbol => {
+        const weight = portfolio.weights?.[symbol];
+        return `${symbol}=${weight === undefined ? "n/a" : `${formatNumber(weight)}%`}`;
+    })
+        .join(", ");
+}
+function createCountSuffix(count) {
+    return count === 1 ? "(1 asset)" : `(${count} assets)`;
+}
+function formatInteger(value) {
+    return new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: 0,
+    }).format(value);
+}
+function formatNumber(value) {
+    return new Intl.NumberFormat("en-US", {
+        maximumFractionDigits: 4,
+    }).format(value);
+}

package/dist/commands/skills.d.ts

@@ -0,0 +1,17 @@
+import { Command } from "commander";
+import { type SkillInstallResult } from "../cli/skills.js";
+import { type TerminalWriter } from "../cli/terminal.js";
+export interface SkillsCommandIO {
+    stdout: TerminalWriter;
+}
+export interface SkillsCommandContext {
+    io?: SkillsCommandIO;
+    env?: NodeJS.ProcessEnv;
+}
+export interface SkillsInstallCommandOptions {
+    all?: boolean;
+}
+export declare function registerSkillsCommands(program: Command, context?: SkillsCommandContext): void;
+export declare function runSkillsInstallCommand(options: SkillsInstallCommandOptions, context?: SkillsCommandContext): Promise<void>;
+export declare function formatSkillsInstallResult(result: SkillInstallResult, theme?: import("../cli/terminal.js").TerminalTheme): string;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,eAAe,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAcN;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,2BAA2B,EACpC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,6CAAsC,GAC1C,MAAM,CAoBR"}

package/dist/commands/skills.js

@@ -0,0 +1,38 @@
+import { installBundledSkillEverywhere, } from "../cli/skills.js";
+import { createCliValidationError } from "../cli/errors.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerSkillsCommands(program, context = {}) {
+    const skillsCommand = program
+        .command("skills")
+        .description("Manage bundled public skills");
+    skillsCommand
+        .command("install")
+        .description("Install bundled QuantBrasil skills into detected agent clients")
+        .option("--all", "Install all bundled public QuantBrasil skills")
+        .action(async (options) => {
+        await runSkillsInstallCommand(options, context);
+    });
+}
+export async function runSkillsInstallCommand(options, context = {}) {
+    if (!options.all) {
+        throw createCliValidationError("Use --all to install the bundled QuantBrasil skill into detected agent clients.");
+    }
+    const stdout = context.io?.stdout ?? process.stdout;
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const result = await installBundledSkillEverywhere(context.env ?? process.env);
+    stdout.write(`${formatSkillsInstallResult(result, theme)}\n`);
+}
+export function formatSkillsInstallResult(result, theme = createTerminalTheme(process.stdout)) {
+    const lines = [theme.label("Installed QuantBrasil skill"), ""];
+    for (const target of result.installed) {
+        lines.push(`${theme.success(target.label)} ${theme.dim(`→ ${target.installDir}`)}`);
+    }
+    if (result.skipped.length > 0) {
+        lines.push("");
+        lines.push(theme.label("Skipped"));
+        for (const target of result.skipped) {
+            lines.push(`${theme.dim(`${target.label} not detected at ${target.rootDir}`)}`);
+        }
+    }
+    return lines.join("\n");
+}

package/dist/commands/status.d.ts

@@ -0,0 +1,15 @@
+import { Command } from "commander";
+import { type TerminalWriter } from "../cli/terminal.js";
+export interface StatusCommandIO {
+    stdout: TerminalWriter;
+}
+export interface StatusCommandContext {
+    io?: StatusCommandIO;
+    env?: NodeJS.ProcessEnv;
+}
+export interface StatusFlagOptions {
+    status?: boolean;
+}
+export declare function registerStatusFlag(program: Command, context?: StatusCommandContext): void;
+export declare function runStatusCommand(context?: StatusCommandContext): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,eAAe,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAUN;AAED,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/commands/status.js

@@ -0,0 +1,52 @@
+import { resolveCliStatusSnapshot } from "../cli/config.js";
+import { createTerminalTheme } from "../cli/terminal.js";
+export function registerStatusFlag(program, context = {}) {
+    program.option("--status", "Show CLI status");
+    program.action(async (options) => {
+        if (!options.status) {
+            program.outputHelp();
+            return;
+        }
+        await runStatusCommand(context);
+    });
+}
+export async function runStatusCommand(context = {}) {
+    const stdout = getStdout(context);
+    const theme = createTerminalTheme(stdout, context.env ?? process.env);
+    const snapshot = await resolveCliStatusSnapshot(context.env ?? process.env);
+    const lines = [
+        theme.label("QuantBrasil CLI Status"),
+        "",
+        `${theme.label("CLI:")} ${formatCliState(snapshot.isReady, theme)}`,
+        `${theme.label("Backend:")} ${snapshot.backendUrl} ${theme.dim(formatBackendSource(snapshot.backendSource))}`,
+        `${theme.label("Authentication:")} ${formatAuthSource(snapshot.authSource, theme)}`,
+        `${theme.label("Local config:")} ${theme.dim(snapshot.configPath)}`,
+        `${theme.label("Local file present:")} ${snapshot.storedApiKey ? theme.success("yes") : theme.dim("no")}`,
+        `${theme.label("Ready for authenticated commands:")} ${snapshot.isReady ? theme.success("yes") : theme.warning("no")}`,
+    ];
+    if (!snapshot.isReady) {
+        lines.push(theme.dim("Use quantbrasil auth login --api-key <key> or set QUANTBRASIL_API_KEY."));
+    }
+    stdout.write(`${lines.join("\n")}\n`);
+}
+function formatAuthSource(source, theme) {
+    switch (source) {
+        case "env":
+            return theme.info("configured via QUANTBRASIL_API_KEY");
+        case "config":
+            return theme.info("configured via local file");
+        case "none":
+            return theme.warning("not configured");
+    }
+}
+function formatBackendSource(source) {
+    return source === "override" ? "(QB_BACKEND_URL)" : "(default)";
+}
+function formatCliState(isReady, theme) {
+    return isReady
+        ? theme.success(theme.bold("ready"))
+        : theme.warning("authentication required");
+}
+function getStdout(context) {
+    return context.io?.stdout ?? process.stdout;
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./cli/auth.js";
+export * from "./cli/client.js";
+export * from "./cli/errors.js";
+export * from "./cli/index.js";
+export * from "./commands/analytics.js";
+export * from "./commands/assets.js";
+export * from "./commands/auth.js";
+export * from "./commands/capabilities.js";
+export * from "./commands/init.js";
+export * from "./commands/market.js";
+export * from "./commands/portfolios.js";
+export * from "./commands/skills.js";
+export * from "./commands/status.js";
+//# sourceMappingURL=index.d.ts.map