@mintlify/cli 4.0.1083 → 4.0.1085

package/bin/analytics/index.js

@@ -0,0 +1,524 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { addLog, ErrorLog, SpinnerLog, removeLastLog } from '@mintlify/previewing';
+import chalk from 'chalk';
+import { Text } from 'ink';
+import { getConfigValue } from '../config.js';
+import { terminate } from '../helpers.js';
+import { getBucketThreads, getBuckets, getConversations, getFeedback, getFeedbackByPage, getKpi, getSearches, } from './client.js';
+import { num, truncate } from './format.js';
+import { formatBarChart, formatOutput, resolveFormat } from './output.js';
+const withSubdomain = (yargs) => yargs.option('subdomain', {
+    type: 'string',
+    default: getConfigValue('subdomain'),
+    description: 'Documentation subdomain (default: mint config set subdomain)',
+});
+function defaultFrom() {
+    const configured = getConfigValue('dateFrom');
+    if (configured)
+        return configured;
+    const d = new Date();
+    d.setDate(d.getDate() - 7);
+    return d.toISOString().slice(0, 10);
+}
+function defaultTo() {
+    var _a;
+    return (_a = getConfigValue('dateTo')) !== null && _a !== void 0 ? _a : new Date().toISOString().slice(0, 10);
+}
+const withDates = (yargs) => yargs
+    .option('from', {
+    type: 'string',
+    default: defaultFrom(),
+    description: 'Start date (YYYY-MM-DD)',
+})
+    .option('to', {
+    type: 'string',
+    default: defaultTo(),
+    description: 'End date (YYYY-MM-DD)',
+});
+const withFormat = (yargs) => yargs
+    .option('format', {
+    type: 'string',
+    choices: ['table', 'plain', 'json', 'graph'],
+    description: 'Output format (table=pretty, plain=pipeable, json=raw)',
+})
+    .option('agent', {
+    type: 'boolean',
+    description: 'Agent-friendly output (equivalent to --format json)',
+});
+const withAll = (yargs) => withFormat(withDates(withSubdomain(yargs)));
+function output(format, text) {
+    if (format === 'table') {
+        addLog(_jsx(Text, { children: text }));
+    }
+    else {
+        process.stdout.write(text + '\n');
+    }
+}
+export const analyticsBuilder = (yargs) => yargs
+    .command('stats', 'display KPI numbers (views, visitors, searches)', (yargs) => withAll(yargs)
+    .option('agents', { type: 'boolean', description: 'Show only agent traffic' })
+    .option('humans', { type: 'boolean', description: 'Show only human traffic' })
+    .option('page', { type: 'string', description: 'Filter to a specific page path' }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const format = resolveFormat(argv);
+    try {
+        if (format === 'table')
+            addLog(_jsx(SpinnerLog, { message: "Fetching analytics..." }));
+        const kpi = yield getKpi({ dateFrom: argv.from, dateTo: argv.to, page: argv.page }, argv.subdomain);
+        if (format === 'table')
+            removeLastLog();
+        if (format === 'json') {
+            output(format, JSON.stringify(kpi, null, 2));
+            yield terminate(0);
+            return;
+        }
+        if (format === 'plain') {
+            const lines = [
+                ['METRIC', 'HUMAN', 'AGENT', 'TOTAL'].join('\t'),
+                ['Views', kpi.humanViews, kpi.agentViews, kpi.humanViews + kpi.agentViews].join('\t'),
+                [
+                    'Visitors',
+                    kpi.humanVisitors,
+                    kpi.agentVisitors,
+                    kpi.humanVisitors + kpi.agentVisitors,
+                ].join('\t'),
+                ['Searches', kpi.humanSearches, '', kpi.humanSearches].join('\t'),
+                ['Feedback', kpi.humanFeedback, '', kpi.humanFeedback].join('\t'),
+                [
+                    'Assistant',
+                    kpi.humanAssistant,
+                    kpi.agentMcpSearches,
+                    kpi.humanAssistant + kpi.agentMcpSearches,
+                ].join('\t'),
+            ];
+            output(format, lines.join('\n'));
+            yield terminate(0);
+            return;
+        }
+        if (format === 'graph') {
+            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+            const lines = [];
+            lines.push(chalk.bold(`\nAnalytics \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+            lines.push(chalk.bold('  Human vs Agent\n'));
+            lines.push(formatBarChart([
+                { label: 'Human Views', value: kpi.humanViews, color: 'cyan' },
+                { label: 'Agent Views', value: kpi.agentViews, color: 'magenta' },
+                { label: 'Human Visitors', value: kpi.humanVisitors, color: 'cyan' },
+                { label: 'Agent Visitors', value: kpi.agentVisitors, color: 'magenta' },
+            ]));
+            lines.push(chalk.bold('\n\n  Engagement\n'));
+            lines.push(formatBarChart([
+                { label: 'Searches', value: kpi.humanSearches, color: 'yellow' },
+                { label: 'Feedback', value: kpi.humanFeedback, color: 'green' },
+                { label: 'Assistant (web)', value: kpi.humanAssistant, color: 'blue' },
+                { label: 'Assistant (API)', value: kpi.agentMcpSearches, color: 'magenta' },
+            ]));
+            output('table', lines.join('\n'));
+            yield terminate(0);
+            return;
+        }
+        const agentOnly = argv.agents && !argv.humans;
+        const humanOnly = argv.humans && !argv.agents;
+        const showHuman = !agentOnly;
+        const showAgent = !humanOnly;
+        const showTotal = showHuman && showAgent;
+        const lines = [];
+        const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : 'default';
+        lines.push(chalk.bold(`\nAnalytics \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+        if (argv.page) {
+            lines.push(`  Page: ${argv.page}\n`);
+        }
+        lines.push(chalk.bold('  Views'));
+        if (showHuman)
+            lines.push(`    Human:  ${chalk.cyan(num(kpi.humanViews).padStart(8))}`);
+        if (showAgent)
+            lines.push(`    Agent:  ${chalk.magenta(num(kpi.agentViews).padStart(8))}`);
+        if (showTotal)
+            lines.push(`    Total:  ${num(kpi.humanViews + kpi.agentViews).padStart(8)}`);
+        lines.push(chalk.bold('\n  Visitors'));
+        if (showHuman)
+            lines.push(`    Human:  ${chalk.cyan(num(kpi.humanVisitors).padStart(8))}`);
+        if (showAgent)
+            lines.push(`    Agent:  ${chalk.magenta(num(kpi.agentVisitors).padStart(8))}`);
+        if (showTotal)
+            lines.push(`    Total:  ${num(kpi.humanVisitors + kpi.agentVisitors).padStart(8)}`);
+        lines.push(`\n  Searches:   ${chalk.bold(num(kpi.humanSearches))}`);
+        lines.push(`  Feedback:   ${chalk.bold(num(kpi.humanFeedback))}`);
+        lines.push(`  Assistant:  ${chalk.bold(num(kpi.humanAssistant))} web, ${chalk.bold(num(kpi.agentMcpSearches))} API`);
+        output(format, lines.join('\n'));
+        yield terminate(0);
+    }
+    catch (err) {
+        if (format === 'table')
+            removeLastLog();
+        addLog(_jsx(ErrorLog, { message: err instanceof Error ? err.message : 'unknown error' }));
+        yield terminate(1);
+    }
+}))
+    .command('search', 'display search analytics', (yargs) => withAll(yargs)
+    .option('query', { type: 'string', description: 'Filter by search query substring' })
+    .option('page', { type: 'string', description: 'Filter by top clicked page' }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const format = resolveFormat(argv);
+    try {
+        if (format === 'table')
+            addLog(_jsx(SpinnerLog, { message: "Fetching search analytics..." }));
+        const data = yield getSearches({ dateFrom: argv.from, dateTo: argv.to }, argv.subdomain);
+        if (format === 'table')
+            removeLastLog();
+        let rows = data.searches;
+        if (argv.query) {
+            const q = argv.query.toLowerCase();
+            rows = rows.filter((r) => r.searchQuery.toLowerCase().includes(q));
+        }
+        if (argv.page) {
+            rows = rows.filter((r) => { var _a; return (_a = r.topClickedPage) === null || _a === void 0 ? void 0 : _a.includes(argv.page); });
+        }
+        const headers = ['Query', 'Hits', 'CTR', 'Top Clicked Page', 'Last Searched'];
+        const tableRows = rows.map((r) => [
+            truncate(r.searchQuery, 30),
+            num(r.hits),
+            r.ctr.toFixed(1) + '%',
+            truncate(r.topClickedPage || '\u2014', 30),
+            r.lastSearchedAt.slice(0, 10),
+        ]);
+        if (format === 'json') {
+            output(format, JSON.stringify(data, null, 2));
+        }
+        else if (format === 'graph') {
+            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+            const lines = [];
+            lines.push(chalk.bold(`\nSearch Queries \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+            lines.push(formatBarChart(rows.slice(0, 20).map((r) => ({
+                label: truncate(r.searchQuery, 25),
+                value: r.hits,
+                color: 'yellow',
+            }))));
+            output('table', lines.join('\n'));
+        }
+        else if (format === 'plain') {
+            output(format, formatOutput(format, headers, tableRows, data));
+        }
+        else {
+            const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : 'default';
+            const lines = [];
+            lines.push(chalk.bold(`\nSearch Analytics \u2014 ${label} (${argv.from} to ${argv.to})`));
+            lines.push(`Total Searches: ${chalk.bold(num(data.totalSearches))}\n`);
+            lines.push(formatOutput(format, headers, tableRows, data));
+            output(format, lines.join('\n'));
+        }
+        yield terminate(0);
+    }
+    catch (err) {
+        if (format === 'table')
+            removeLastLog();
+        addLog(_jsx(ErrorLog, { message: err instanceof Error ? err.message : 'unknown error' }));
+        yield terminate(1);
+    }
+}))
+    .command('feedback', 'display feedback analytics', (yargs) => withAll(yargs)
+    .option('type', {
+    type: 'string',
+    choices: ['code', 'page'],
+    description: 'Feedback type: code snippets or page-level aggregation',
+})
+    .option('page', { type: 'string', description: 'Filter to a specific page path' }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
+    const format = resolveFormat(argv);
+    try {
+        if (format === 'table')
+            addLog(_jsx(SpinnerLog, { message: "Fetching feedback..." }));
+        if (argv.type === 'page') {
+            const data = yield getFeedbackByPage({ dateFrom: argv.from, dateTo: argv.to }, argv.subdomain);
+            if (format === 'table')
+                removeLastLog();
+            let rows = data.feedback;
+            if (argv.page)
+                rows = rows.filter((r) => r.path.includes(argv.page));
+            const headers = ['Path', 'Thumbs Up', 'Thumbs Down', 'Code', 'Total'];
+            const tableRows = rows.map((r) => [
+                truncate(r.path, 40),
+                num(r.thumbsUp),
+                num(r.thumbsDown),
+                num(r.code),
+                num(r.total),
+            ]);
+            if (format === 'json') {
+                output(format, JSON.stringify(data, null, 2));
+            }
+            else if (format === 'graph') {
+                const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+                const lines = [];
+                lines.push(chalk.bold(`\nFeedback by Page \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+                lines.push(formatBarChart(rows.slice(0, 20).map((r) => ({
+                    label: truncate(r.path, 25),
+                    value: r.total,
+                    color: 'green',
+                }))));
+                output('table', lines.join('\n'));
+            }
+            else {
+                const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : 'default';
+                const lines = [];
+                if (format === 'table')
+                    lines.push(chalk.bold(`\nFeedback \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+                lines.push(formatOutput(format, headers, tableRows, data));
+                if (format === 'table' && data.hasMore)
+                    lines.push(chalk.dim('\n  (more results available)'));
+                output(format, lines.join('\n'));
+            }
+        }
+        else {
+            const source = argv.type === 'code' ? 'code' : undefined;
+            const data = yield getFeedback({ dateFrom: argv.from, dateTo: argv.to, source }, argv.subdomain);
+            if (format === 'table')
+                removeLastLog();
+            let rows = data.feedback;
+            if (argv.page)
+                rows = rows.filter((r) => r.path.includes(argv.page));
+            const headers = ['ID', 'Path', 'Status', 'Source', 'Comment', 'Created'];
+            const tableRows = rows.map((r) => {
+                var _a, _b, _c;
+                return [
+                    r.id.slice(0, 8),
+                    truncate(r.path, 30),
+                    r.status,
+                    r.source,
+                    truncate((_a = r.comment) !== null && _a !== void 0 ? _a : '\u2014', 30),
+                    (_c = (_b = r.createdAt) === null || _b === void 0 ? void 0 : _b.slice(0, 10)) !== null && _c !== void 0 ? _c : '\u2014',
+                ];
+            });
+            if (format === 'json') {
+                output(format, JSON.stringify(data, null, 2));
+            }
+            else {
+                const label = (_c = argv.subdomain) !== null && _c !== void 0 ? _c : 'default';
+                const lines = [];
+                if (format === 'table')
+                    lines.push(chalk.bold(`\nFeedback \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+                lines.push(formatOutput(format, headers, tableRows, data));
+                if (format === 'table' && data.hasMore)
+                    lines.push(chalk.dim('\n  (more results available)'));
+                output(format, lines.join('\n'));
+            }
+        }
+        yield terminate(0);
+    }
+    catch (err) {
+        if (format === 'table')
+            removeLastLog();
+        addLog(_jsx(ErrorLog, { message: err instanceof Error ? err.message : 'unknown error' }));
+        yield terminate(1);
+    }
+}))
+    .command('conversation', 'view assistant conversation analytics', (yargs) => yargs
+    .command('list', 'list assistant conversations', (yargs) => withAll(yargs).option('page', {
+    type: 'string',
+    description: 'Filter conversations mentioning this page in sources',
+}), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const format = resolveFormat(argv);
+    try {
+        if (format === 'table')
+            addLog(_jsx(SpinnerLog, { message: "Fetching conversations..." }));
+        const data = yield getConversations({ dateFrom: argv.from, dateTo: argv.to }, argv.subdomain);
+        if (format === 'table')
+            removeLastLog();
+        let conversations = data.conversations;
+        if (argv.page) {
+            conversations = conversations.filter((c) => c.sources.some((s) => s.url.includes(argv.page)));
+        }
+        const headers = ['ID', 'Timestamp', 'Query', 'Category'];
+        const tableRows = conversations.map((c) => [
+            c.id,
+            c.timestamp.slice(0, 19).replace('T', ' '),
+            truncate(c.query, 40),
+            c.queryCategory || '\u2014',
+        ]);
+        if (format === 'json') {
+            output(format, JSON.stringify(data, null, 2));
+        }
+        else {
+            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+            const lines = [];
+            if (format === 'table')
+                lines.push(chalk.bold(`\nConversations \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+            lines.push(formatOutput(format, headers, tableRows, data));
+            if (format === 'table' && data.hasMore)
+                lines.push(chalk.dim('\n  (more results available)'));
+            output(format, lines.join('\n'));
+        }
+        yield terminate(0);
+    }
+    catch (err) {
+        if (format === 'table')
+            removeLastLog();
+        addLog(_jsx(ErrorLog, { message: err instanceof Error ? err.message : 'unknown error' }));
+        yield terminate(1);
+    }
+}))
+    .command('view <id>', 'view a single conversation', (yargs) => withFormat(withSubdomain(yargs)).positional('id', {
+    type: 'string',
+    demandOption: true,
+    description: 'Conversation ID',
+}), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const format = resolveFormat(argv);
+    try {
+        if (format === 'table')
+            addLog(_jsx(SpinnerLog, { message: "Fetching conversation..." }));
+        const today = new Date().toISOString().slice(0, 10);
+        let conversation;
+        let cursor;
+        for (let i = 0; i < 10 && !conversation; i++) {
+            const data = yield getConversations({
+                dateFrom: '2020-01-01',
+                dateTo: today,
+                limit: 100,
+                cursor,
+            }, argv.subdomain);
+            conversation = data.conversations.find((c) => c.id === argv.id);
+            if (!data.nextCursor)
+                break;
+            cursor = data.nextCursor;
+        }
+        if (format === 'table')
+            removeLastLog();
+        if (!conversation) {
+            addLog(_jsx(ErrorLog, { message: `Conversation ${argv.id} not found` }));
+            yield terminate(1);
+            return;
+        }
+        if (format === 'json' || format === 'plain') {
+            output(format, JSON.stringify(conversation, null, 2));
+        }
+        else {
+            const lines = [];
+            lines.push(chalk.bold(`\nConversation ${conversation.id}\n`));
+            lines.push(`  Timestamp:  ${conversation.timestamp}`);
+            lines.push(`  Category:   ${conversation.queryCategory || '\u2014'}`);
+            lines.push(chalk.bold('\n  Query:'));
+            lines.push(`  ${conversation.query}`);
+            lines.push(chalk.bold('\n  Response:'));
+            for (const line of conversation.response.split('\n')) {
+                lines.push(`  ${line}`);
+            }
+            if (conversation.sources.length > 0) {
+                lines.push(chalk.bold('\n  Sources:'));
+                for (const src of conversation.sources) {
+                    lines.push(`    ${src.title} \u2014 ${chalk.dim(src.url)}`);
+                }
+            }
+            output(format, lines.join('\n'));
+        }
+        yield terminate(0);
+    }
+    catch (err) {
+        if (format === 'table')
+            removeLastLog();
+        addLog(_jsx(ErrorLog, { message: err instanceof Error ? err.message : 'unknown error' }));
+        yield terminate(1);
+    }
+}))
+    .command('buckets', 'view conversation category buckets', (yargs) => yargs
+    .command('list', 'list conversation buckets', (yargs) => withAll(yargs), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const format = resolveFormat(argv);
+    try {
+        if (format === 'table')
+            addLog(_jsx(SpinnerLog, { message: "Fetching conversation buckets..." }));
+        const data = yield getBuckets({ dateFrom: argv.from, dateTo: argv.to }, argv.subdomain);
+        if (format === 'table')
+            removeLastLog();
+        const headers = ['ID', 'Label', 'Count', 'Last Asked'];
+        const tableRows = data.data.map((b) => [
+            b.id.slice(0, 12),
+            truncate(b.questionSummary, 50),
+            num(b.size),
+            b.lastAsked ? b.lastAsked.slice(0, 10) : '\u2014',
+        ]);
+        if (format === 'json') {
+            output(format, JSON.stringify(data, null, 2));
+        }
+        else if (format === 'graph') {
+            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+            const lines = [];
+            lines.push(chalk.bold(`\nConversation Buckets \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+            lines.push(formatBarChart(data.data.slice(0, 20).map((b) => ({
+                label: truncate(b.questionSummary, 30),
+                value: b.size,
+                color: 'blue',
+            }))));
+            output('table', lines.join('\n'));
+        }
+        else {
+            const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : 'default';
+            const lines = [];
+            if (format === 'table')
+                lines.push(chalk.bold(`\nConversation Buckets \u2014 ${label} (${argv.from} to ${argv.to})\n`));
+            lines.push(formatOutput(format, headers, tableRows, data));
+            if (format === 'table')
+                lines.push(chalk.dim(`\n  Total: ${data.pagination.total}`));
+            output(format, lines.join('\n'));
+        }
+        yield terminate(0);
+    }
+    catch (err) {
+        if (format === 'table')
+            removeLastLog();
+        addLog(_jsx(ErrorLog, { message: err instanceof Error ? err.message : 'unknown error' }));
+        yield terminate(1);
+    }
+}))
+    .command('view <id>', 'view conversations in a bucket', (yargs) => withAll(yargs).positional('id', {
+    type: 'string',
+    demandOption: true,
+    description: 'Bucket ID',
+}), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+    const format = resolveFormat(argv);
+    try {
+        if (format === 'table')
+            addLog(_jsx(SpinnerLog, { message: "Fetching bucket conversations..." }));
+        const data = yield getBucketThreads(argv.id, { dateFrom: argv.from, dateTo: argv.to }, argv.subdomain);
+        if (format === 'table')
+            removeLastLog();
+        if (format === 'json') {
+            output(format, JSON.stringify(data, null, 2));
+        }
+        else {
+            const headers = ['Thread ID', 'Query', 'Length', 'Feedback', 'Created'];
+            const tableRows = data.data.map((t) => [
+                t.id.slice(0, 12),
+                truncate(t.firstUserMessage || '\u2014', 40),
+                num(t.length),
+                `+${t.feedback.up} -${t.feedback.down}`,
+                t.createdAt.slice(0, 10),
+            ]);
+            const lines = [];
+            if (format === 'table')
+                lines.push(chalk.bold(`\nBucket ${argv.id}\n`));
+            lines.push(formatOutput(format, headers, tableRows, data));
+            if (format === 'table' && data.pagination.hasMore)
+                lines.push(chalk.dim('\n  (more results available)'));
+            output(format, lines.join('\n'));
+        }
+        yield terminate(0);
+    }
+    catch (err) {
+        if (format === 'table')
+            removeLastLog();
+        addLog(_jsx(ErrorLog, { message: err instanceof Error ? err.message : 'unknown error' }));
+        yield terminate(1);
+    }
+}))
+    .demandCommand(1, 'specify a subcommand: list or view'))
+    .demandCommand(1, 'specify a subcommand: list, view, or buckets'))
+    .demandCommand(1, 'specify a subcommand: stats, search, feedback, or conversation');

package/bin/analytics/output.js

@@ -0,0 +1,74 @@
+import chalk from 'chalk';
+export function resolveFormat(argv) {
+    if (argv.agent || process.env.CLAUDECODE === '1')
+        return 'json';
+    if (argv.format === 'table' ||
+        argv.format === 'plain' ||
+        argv.format === 'json' ||
+        argv.format === 'graph')
+        return argv.format;
+    return 'plain';
+}
+export function formatPlainTable(headers, rows) {
+    if (rows.length === 0)
+        return '';
+    const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => { var _a; return ((_a = r[i]) !== null && _a !== void 0 ? _a : '').length; })));
+    const headerLine = headers.map((h, i) => h.toUpperCase().padEnd(colWidths[i])).join('\t');
+    const bodyLines = rows.map((row) => row.map((cell, i) => cell.padEnd(colWidths[i])).join('\t'));
+    return [headerLine, ...bodyLines].join('\n');
+}
+export function formatPrettyTable(headers, rows) {
+    if (rows.length === 0)
+        return chalk.dim('  No data found.');
+    const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => { var _a; return ((_a = r[i]) !== null && _a !== void 0 ? _a : '').length; })));
+    const headerLine = headers.map((h, i) => chalk.bold(h.padEnd(colWidths[i]))).join('  ');
+    const separator = chalk.dim(colWidths.map((w) => '\u2500'.repeat(w)).join('\u2500\u2500'));
+    const bodyLines = rows.map((row) => row.map((cell, i) => cell.padEnd(colWidths[i])).join('  '));
+    return [headerLine, separator, ...bodyLines].join('\n');
+}
+function gradientBar(len, rgb) {
+    let result = '';
+    for (let i = 0; i < len; i++) {
+        const t = len === 1 ? 1 : i / (len - 1);
+        const dim = 0.3 + t * 0.7;
+        const r = Math.round(rgb[0] * dim);
+        const g = Math.round(rgb[1] * dim);
+        const b = Math.round(rgb[2] * dim);
+        result += chalk.rgb(r, g, b)('\u2588');
+    }
+    return result;
+}
+const COLOR_MAP = {
+    cyan: [0, 255, 255],
+    magenta: [255, 0, 255],
+    yellow: [255, 255, 0],
+    green: [0, 255, 100],
+    blue: [80, 140, 255],
+    red: [255, 80, 80],
+};
+export function formatBarChart(items, opts = {}) {
+    var _a;
+    if (items.length === 0)
+        return chalk.dim('  No data found.');
+    const maxWidth = (_a = opts.maxWidth) !== null && _a !== void 0 ? _a : 40;
+    const maxVal = Math.max(...items.map((i) => i.value), 1);
+    const maxLabel = Math.max(...items.map((i) => i.label.length));
+    const maxValStr = Math.max(...items.map((i) => i.value.toLocaleString('en-US').length));
+    return items
+        .map((item) => {
+        var _a, _b;
+        const barLen = Math.round((item.value / maxVal) * maxWidth);
+        const rgb = (_b = COLOR_MAP[(_a = item.color) !== null && _a !== void 0 ? _a : 'cyan']) !== null && _b !== void 0 ? _b : COLOR_MAP.cyan;
+        const bar = barLen > 0 ? gradientBar(barLen, rgb) : '';
+        const pad = ' '.repeat(maxWidth - barLen);
+        return `  ${item.label.padEnd(maxLabel)}  ${bar}${pad} ${item.value.toLocaleString('en-US').padStart(maxValStr)}`;
+    })
+        .join('\n');
+}
+export function formatOutput(format, headers, rows, jsonData) {
+    if (format === 'json')
+        return JSON.stringify(jsonData, null, 2);
+    if (format === 'plain')
+        return formatPlainTable(headers, rows);
+    return formatPrettyTable(headers, rows);
+}

package/bin/analytics/types.js

@@ -0,0 +1 @@
+export {};

package/bin/cli.js

@@ -16,7 +16,9 @@ import path from 'path';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 import { accessibilityCheck } from './accessibilityCheck.js';
+import { analyticsBuilder } from './analytics/index.js';
 import { setTelemetryEnabled } from './config.js';
+import { getConfigValue, setConfigValue, clearConfigValue } from './config.js';
 import { CMD_EXEC_PATH } from './constants.js';
 import { checkPort, checkNodeVersion, autoUpgradeIfNeeded, getVersions, suppressConsoleWarnings, terminate, } from './helpers.js';
 import { init } from './init.js';
@@ -260,6 +262,59 @@ export const cli = ({ packageName = 'mint' }) => {
         yield login();
         yield terminate(0);
     }))
+        .command('config', 'manage CLI configuration', (yargs) => yargs
+        .command('set <key> <value>', 'set a configuration value', (yargs) => yargs
+        .positional('key', {
+        type: 'string',
+        demandOption: true,
+        description: 'Config key (e.g. subdomain)',
+    })
+        .positional('value', {
+        type: 'string',
+        demandOption: true,
+        description: 'Config value',
+    }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+        const validKeys = ['subdomain', 'dateFrom', 'dateTo'];
+        if (!validKeys.includes(argv.key)) {
+            addLog(_jsx(ErrorLog, { message: `Unknown config key: "${argv.key}". Valid keys: ${validKeys.join(', ')}` }));
+            yield terminate(1);
+            return;
+        }
+        yield setConfigValue(argv.key, argv.value);
+        addLog(_jsx(SuccessLog, { message: `${argv.key} = "${argv.value}"` }));
+        yield terminate(0);
+    }))
+        .command('get <key>', 'get a configuration value', (yargs) => yargs.positional('key', {
+        type: 'string',
+        demandOption: true,
+        description: 'Config key (e.g. subdomain, dateFrom, dateTo)',
+    }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+        const validKeys = ['subdomain', 'dateFrom', 'dateTo'];
+        if (!validKeys.includes(argv.key)) {
+            addLog(_jsx(ErrorLog, { message: `Unknown config key: "${argv.key}". Valid keys: ${validKeys.join(', ')}` }));
+            yield terminate(1);
+            return;
+        }
+        const val = getConfigValue(argv.key);
+        addLog(_jsx(Text, { children: val !== null && val !== void 0 ? val : 'not set' }));
+        yield terminate(0);
+    }))
+        .command('clear <key>', 'remove a configuration value', (yargs) => yargs.positional('key', {
+        type: 'string',
+        demandOption: true,
+        description: 'Config key (e.g. subdomain, dateFrom, dateTo)',
+    }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+        const validKeys = ['subdomain', 'dateFrom', 'dateTo'];
+        if (!validKeys.includes(argv.key)) {
+            addLog(_jsx(ErrorLog, { message: `Unknown config key: "${argv.key}". Valid keys: ${validKeys.join(', ')}` }));
+            yield terminate(1);
+            return;
+        }
+        yield clearConfigValue(argv.key);
+        addLog(_jsx(SuccessLog, { message: `${argv.key} cleared` }));
+        yield terminate(0);
+    }))
+        .demandCommand(1, 'specify a subcommand: set, get, or clear'))
         .command('update', 'update the CLI to the latest version', () => undefined, () => __awaiter(void 0, void 0, void 0, function* () {
         yield update({ packageName });
         yield terminate(0);
@@ -337,6 +392,7 @@ export const cli = ({ packageName = 'mint' }) => {
             yield terminate(1);
         }
     }))
+        .command('analytics', 'view analytics for your documentation', analyticsBuilder)
         // Print the help menu when the user enters an invalid command.
         .strictCommands()
         .demandCommand(1, 'unknown command. see above for the list of supported commands.')