@mintlify/cli 4.0.1099 → 4.0.1100

package/__test__/analytics/format.test.ts

@@ -5,6 +5,11 @@ import {
   formatPrettyTable,
   resolveFormat,
 } from '../../src/analytics/output.js';
+import * as helpers from '../../src/helpers.js';
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
 
 describe('num', () => {
   it('formats numbers with locale separators', () => {
@@ -81,31 +86,21 @@ describe('formatPlainTable', () => {
 });
 
 describe('resolveFormat', () => {
-  it('returns json when agent flag is set', () => {
-    expect(resolveFormat({ agent: true })).toBe('json');
-  });
-
-  it('returns json when CLAUDECODE env is set', () => {
-    const prev = process.env.CLAUDECODE;
-    process.env.CLAUDECODE = '1';
+  it('returns json when AI mode is active', () => {
+    vi.spyOn(helpers, 'isAI').mockReturnValue(true);
     expect(resolveFormat({})).toBe('json');
-    process.env.CLAUDECODE = prev;
   });
 
   it('returns specified format', () => {
-    const prev = process.env.CLAUDECODE;
-    delete process.env.CLAUDECODE;
+    vi.spyOn(helpers, 'isAI').mockReturnValue(true);
     expect(resolveFormat({ format: 'plain' })).toBe('plain');
     expect(resolveFormat({ format: 'json' })).toBe('json');
     expect(resolveFormat({ format: 'graph' })).toBe('graph');
-    process.env.CLAUDECODE = prev;
   });
 
   it('defaults to plain', () => {
-    const prev = process.env.CLAUDECODE;
-    delete process.env.CLAUDECODE;
+    vi.spyOn(helpers, 'isAI').mockReturnValue(false);
     expect(resolveFormat({})).toBe('plain');
-    process.env.CLAUDECODE = prev;
   });
 });
 

package/__test__/telemetry.test.ts

@@ -4,11 +4,11 @@ import os from 'os';
 
 import { isTelemetryEnabled, setTelemetryEnabled } from '../src/config.js';
 import { TELEMETRY_ASYNC_TIMEOUT_MS } from '../src/constants.js';
-import { getDistinctId } from '../src/telemetry/distinctId.js';
 import {
   createTelemetryMiddleware,
   getSanitizedCommandForTelemetry,
-} from '../src/telemetry/middleware.js';
+} from '../src/middlewares/telemetryMiddleware.js';
+import { getDistinctId } from '../src/telemetry/distinctId.js';
 import * as trackModule from '../src/telemetry/track.js';
 import { trackCommand, trackTelemetryPreferenceChange } from '../src/telemetry/track.js';
 

package/bin/analytics/index.js

@@ -13,12 +13,12 @@ import chalk from 'chalk';
 import { Text } from 'ink';
 import { getConfigValue } from '../config.js';
 import { terminate } from '../helpers.js';
+import { subdomainMiddleware } from '../middlewares/subdomainMiddleware.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() {
@@ -44,15 +44,10 @@ const withDates = (yargs) => yargs
     default: defaultTo(),
     description: 'End date (YYYY-MM-DD)',
 });
-const withFormat = (yargs) => yargs
-    .option('format', {
+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) {
@@ -63,11 +58,12 @@ function output(format, text) {
         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* () {
+export const analyticsBuilder = (yargs) => withAll(yargs)
+    .middleware(subdomainMiddleware)
+    .command('stats', 'display KPI numbers (views, visitors, searches)', (yargs) => withAll(yargs).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 {
@@ -105,7 +101,7 @@ export const analyticsBuilder = (yargs) => yargs
             return;
         }
         if (format === 'graph') {
-            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : '';
             const lines = [];
             lines.push(chalk.bold(`\nAnalytics \u2014 ${label} (${argv.from} to ${argv.to})\n`));
             lines.push(chalk.bold('  Human vs Agent\n'));
@@ -126,31 +122,20 @@ export const analyticsBuilder = (yargs) => yargs
             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';
+        const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : '';
         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(`    Human:  ${chalk.cyan(num(kpi.humanViews).padStart(8))}`);
+        lines.push(`    Agent:  ${chalk.magenta(num(kpi.agentViews).padStart(8))}`);
+        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(`    Human:  ${chalk.cyan(num(kpi.humanVisitors).padStart(8))}`);
+        lines.push(`    Agent:  ${chalk.magenta(num(kpi.agentVisitors).padStart(8))}`);
+        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`);
@@ -195,7 +180,7 @@ export const analyticsBuilder = (yargs) => yargs
             output(format, JSON.stringify(data, null, 2));
         }
         else if (format === 'graph') {
-            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : '';
             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) => ({
@@ -209,7 +194,7 @@ export const analyticsBuilder = (yargs) => yargs
             output(format, formatOutput(format, headers, tableRows, data));
         }
         else {
-            const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : 'default';
+            const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : '';
             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`);
@@ -256,7 +241,7 @@ export const analyticsBuilder = (yargs) => yargs
                 output(format, JSON.stringify(data, null, 2));
             }
             else if (format === 'graph') {
-                const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+                const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : '';
                 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) => ({
@@ -267,7 +252,7 @@ export const analyticsBuilder = (yargs) => yargs
                 output('table', lines.join('\n'));
             }
             else {
-                const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : 'default';
+                const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : '';
                 const lines = [];
                 if (format === 'table')
                     lines.push(chalk.bold(`\nFeedback \u2014 ${label} (${argv.from} to ${argv.to})\n`));
@@ -301,7 +286,7 @@ export const analyticsBuilder = (yargs) => yargs
                 output(format, JSON.stringify(data, null, 2));
             }
             else {
-                const label = (_c = argv.subdomain) !== null && _c !== void 0 ? _c : 'default';
+                const label = (_c = argv.subdomain) !== null && _c !== void 0 ? _c : '';
                 const lines = [];
                 if (format === 'table')
                     lines.push(chalk.bold(`\nFeedback \u2014 ${label} (${argv.from} to ${argv.to})\n`));
@@ -348,7 +333,7 @@ export const analyticsBuilder = (yargs) => yargs
             output(format, JSON.stringify(data, null, 2));
         }
         else {
-            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : '';
             const lines = [];
             if (format === 'table')
                 lines.push(chalk.bold(`\nConversations \u2014 ${label} (${argv.from} to ${argv.to})\n`));
@@ -449,7 +434,7 @@ export const analyticsBuilder = (yargs) => yargs
             output(format, JSON.stringify(data, null, 2));
         }
         else if (format === 'graph') {
-            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : 'default';
+            const label = (_a = argv.subdomain) !== null && _a !== void 0 ? _a : '';
             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) => ({
@@ -460,7 +445,7 @@ export const analyticsBuilder = (yargs) => yargs
             output('table', lines.join('\n'));
         }
         else {
-            const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : 'default';
+            const label = (_b = argv.subdomain) !== null && _b !== void 0 ? _b : '';
             const lines = [];
             if (format === 'table')
                 lines.push(chalk.bold(`\nConversation Buckets \u2014 ${label} (${argv.from} to ${argv.to})\n`));

package/bin/analytics/output.js

@@ -1,12 +1,13 @@
 import chalk from 'chalk';
+import { isAI } from '../helpers.js';
 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;
+    if (isAI())
+        return 'json';
     return 'plain';
 }
 export function formatPlainTable(headers, rows) {

package/bin/cli.js

@@ -27,9 +27,9 @@ import { getAccessToken } from './keyring.js';
 import { login } from './login.js';
 import { logout } from './logout.js';
 import { mdxLinter } from './mdxLinter.js';
+import { createTelemetryMiddleware } from './middlewares/telemetryMiddleware.js';
 import { checkOpenApiFile, getOpenApiFilenamesFromDocsConfig } from './openApiCheck.js';
-import { status, getCliSubdomain } from './status.js';
-import { createTelemetryMiddleware } from './telemetry/middleware.js';
+import { status, getCliSubdomains } from './status.js';
 import { trackTelemetryPreferenceChange } from './telemetry/track.js';
 import { update } from './update.js';
 import { addWorkflow } from './workflow.js';
@@ -89,7 +89,7 @@ export const cli = ({ packageName = 'mint' }) => {
         .usage('usage: mintlify dev [options]')
         .example('mintlify dev', 'run with default settings (opens in browser)')
         .example('mintlify dev --no-open', 'run without opening in browser'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b;
+        var _a;
         yield autoUpgradeIfNeeded();
         const port = yield checkPort(argv);
         const { cli: cliVersion } = getVersions();
@@ -99,9 +99,9 @@ export const cli = ({ packageName = 'mint' }) => {
             accessToken = (_a = (yield getAccessToken())) !== null && _a !== void 0 ? _a : undefined;
             const configuredSubdomain = getConfigValue('subdomain');
             subdomain =
-                configuredSubdomain !== null && configuredSubdomain !== void 0 ? configuredSubdomain : (accessToken ? (_b = (yield getCliSubdomain(accessToken))) !== null && _b !== void 0 ? _b : undefined : undefined);
+                configuredSubdomain !== null && configuredSubdomain !== void 0 ? configuredSubdomain : (accessToken ? (yield getCliSubdomains(accessToken))[0] : undefined);
         }
-        catch (_c) { }
+        catch (_b) { }
         if (port != undefined) {
             yield dev(Object.assign(Object.assign({}, argv), { port,
                 packageName,

package/bin/login.js

@@ -8,15 +8,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { input } from '@inquirer/prompts';
-import { addLog, ErrorLog, SuccessLog } from '@mintlify/previewing';
+import { input, search } from '@inquirer/prompts';
+import { addLog, ErrorLog, InfoLog, SuccessLog } from '@mintlify/previewing';
 import chalk from 'chalk';
 import { Box, Text } from 'ink';
 import open from 'open';
 import { calculatePKCECodeChallenge, randomNonce, randomPKCECodeVerifier, randomState, } from 'openid-client';
 import { startCallbackServer } from './callbackServer.js';
+import { setConfigValue } from './config.js';
 import { DASHBOARD_URL, STYTCH_CLIENT_ID, TOKEN_ENDPOINT } from './constants.js';
 import { storeCredentials } from './keyring.js';
+import { getCliSubdomains } from './status.js';
 import { trackLoginAttempt, trackLoginFailed, trackLoginSuccess } from './telemetry/track.js';
 export function login() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -80,5 +82,43 @@ export function login() {
         yield storeCredentials(token.access_token, token.refresh_token);
         void trackLoginSuccess();
         addLog(_jsx(SuccessLog, { message: "logged in successfully" }));
+        yield promptSubdomainSelection(token.access_token);
+    });
+}
+function isPromptCancellationError(error) {
+    return error instanceof Error && error.name === 'ExitPromptError';
+}
+function promptSubdomainSelection(accessToken) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const subdomains = yield getCliSubdomains(accessToken);
+        if (subdomains.length === 0)
+            return;
+        if (subdomains.length === 1) {
+            yield setConfigValue('subdomain', subdomains[0]);
+            addLog(_jsx(InfoLog, { message: `default project set to ${subdomains[0]}` }));
+            return;
+        }
+        yield new Promise((resolve) => setTimeout(resolve, 50));
+        let chosen;
+        try {
+            chosen = yield search({
+                message: 'Select a default project',
+                source: (term) => {
+                    const results = term
+                        ? subdomains.filter((s) => s.toLowerCase().includes(term.toLowerCase()))
+                        : subdomains;
+                    return results.map((s) => ({ name: s, value: s }));
+                },
+            });
+        }
+        catch (error) {
+            if (isPromptCancellationError(error)) {
+                addLog(_jsx(InfoLog, { message: `No project set. To set a default project, run ${chalk.bold('mintlify config set subdomain <subdomain>')}` }));
+                return;
+            }
+            throw error;
+        }
+        yield setConfigValue('subdomain', chosen);
+        addLog(_jsx(InfoLog, { message: `default project set to ${chosen}` }));
     });
 }

package/bin/middlewares/subdomainMiddleware.js

@@ -0,0 +1,28 @@
+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 { getConfigValue } from '../config.js';
+import { getAccessToken } from '../keyring.js';
+import { getCliSubdomains } from '../status.js';
+export function subdomainMiddleware(argv) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (argv.subdomain)
+            return;
+        const fromConfig = getConfigValue('subdomain');
+        if (fromConfig) {
+            argv.subdomain = fromConfig;
+            return;
+        }
+        const accessToken = yield getAccessToken();
+        if (!accessToken)
+            return;
+        const subdomains = yield getCliSubdomains(accessToken);
+        argv.subdomain = subdomains[0];
+    });
+}

package/bin/{telemetry/middleware.js → middlewares/telemetryMiddleware.js}

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { getConfigValue } from '../config.js';
 import { getVersions } from '../helpers.js';
-import { trackCommand } from './track.js';
+import { trackCommand } from '../telemetry/track.js';
 const SCRAPE_SUBCOMMANDS = new Set(['page', 'site', 'openapi']);
 export function getSanitizedCommandForTelemetry(_) {
     const parts = _.filter((p) => typeof p === 'string');

package/bin/status.js

@@ -19,23 +19,22 @@ import { getAccessToken } from './keyring.js';
 const StatusResponseSchema = z.object({
     user: z.object({ email: z.string() }),
     org: z.object({ name: z.string() }),
-    subdomain: z.string().nullable().optional(),
+    subdomains: z.array(z.string()).default([]),
 });
-export function getCliSubdomain(accessToken) {
+export function getCliSubdomains(accessToken) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a;
         try {
             const res = yield fetch(`${API_URL}/api/cli/status`, {
                 headers: { Authorization: `Bearer ${accessToken}` },
             });
             if (!res.ok)
-                return null;
+                return [];
             const json = yield res.json().catch(() => null);
             const parsed = StatusResponseSchema.safeParse(json);
-            return parsed.success ? (_a = parsed.data.subdomain) !== null && _a !== void 0 ? _a : null : null;
+            return parsed.success ? parsed.data.subdomains : [];
         }
-        catch (_b) {
-            return null;
+        catch (_a) {
+            return [];
         }
     });
 }
@@ -59,9 +58,9 @@ export function status() {
                 addLog(_jsx(ErrorLog, { message: "unexpected response from server. please try again." }));
                 return;
             }
-            const { user, org, subdomain: apiSubdomain } = parsed.data;
+            const { user, org, subdomains } = parsed.data;
             const version = getCliVersion();
-            const subdomain = (_b = (_a = getConfigValue('subdomain')) !== null && _a !== void 0 ? _a : apiSubdomain) !== null && _b !== void 0 ? _b : null;
+            const subdomain = (_b = (_a = getConfigValue('subdomain')) !== null && _a !== void 0 ? _a : subdomains[0]) !== null && _b !== void 0 ? _b : null;
             addLog(_jsxs(Box, { flexDirection: "column", paddingY: 1, children: [version && (_jsxs(Box, { children: [_jsx(Box, { minWidth: 16, children: _jsx(Text, { dimColor: true, children: "Version" }) }), _jsx(Text, { children: version })] })), _jsxs(Box, { children: [_jsx(Box, { minWidth: 16, children: _jsx(Text, { dimColor: true, children: "Email" }) }), _jsx(Text, { children: user.email })] }), _jsxs(Box, { children: [_jsx(Box, { minWidth: 16, children: _jsx(Text, { dimColor: true, children: "Organization" }) }), _jsx(Text, { children: org.name })] }), subdomain && (_jsxs(Box, { children: [_jsx(Box, { minWidth: 16, children: _jsx(Text, { dimColor: true, children: "Subdomain" }) }), _jsx(Text, { children: subdomain })] }))] }));
         }
         catch (e) {