@mintlify/cli 4.0.1813 → 4.1.1

package/bin/cli.js

@@ -1,813 +0,0 @@
-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, jsxs as _jsxs } from "react/jsx-runtime";
-import { addLog, dev, exportSite, ErrorLog, SuccessLog, Logs, WarningLog, } from '@mintlify/previewing';
-import { thumbnailOverrideSchema } from '@mintlify/validation';
-import { render, Text } from 'ink';
-import yargs from 'yargs';
-import { hideBin } from 'yargs/helpers';
-import { accessibilityCheck } from './accessibilityCheck.js';
-import { addDomain } from './addDomain.js';
-import { claimDeployment, createAgentClaimLink } from './agent-claim.js';
-import { SETUP_AGENTS, setupAgent } from './agent-setup.js';
-import { analyticsBuilder } from './analytics/index.js';
-import { brokenLinksHandler } from './brokenLinks.js';
-import { comingSoon } from './comingSoon.js';
-import { setTelemetryEnabled } from './config.js';
-import { getConfigValue, setConfigValue, clearConfigValue } from './config.js';
-import { API_URL } from './constants.js';
-import { pushBaseCheckout } from './deploy-base.js';
-import { deployFromGithubActions, isGithubActions } from './deploy-github-actions.js';
-import { formatGithubSetup, setupGithubDeployment } from './deploy-github-setup.js';
-import { DEPLOY_HELP, deploymentInstructions } from './deploy-instructions.js';
-import { agentEditorUrl, formatDeployment, prepareAgentDeployment } from './deploy.js';
-import { FEEDBACK_CATEGORIES, feedback } from './feedback.js';
-import { formatHandler } from './format.js';
-import { checkPort, checkNodeVersion, autoUpgradeIfNeeded, getVersions, isAI, suppressConsoleWarnings, terminate, } from './helpers.js';
-import { init } from './init.js';
-import { fetchInstructions, formatTopics } from './instructions.js';
-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 { agents, listMigrationDocs, migrateWithAgent, migrationInstructions, } from './migrate.js';
-import { ogCommand } from './og.js';
-import { buildOverlayRegistryForCheck, checkOpenApiFile } from './openApiCheck.js';
-import { scoreHandler } from './score/index.js';
-import { signup } from './signup.js';
-import { status, getCliSubdomains } from './status.js';
-import { trackEvent, trackTelemetryPreferenceChange } from './telemetry/track.js';
-import { update } from './update.js';
-import { splitList, validateHandler } from './validate/command.js';
-import { RULES } from './validate/rules/index.js';
-import { PARSE_ERROR } from './validate/rules/parseError.js';
-import { GROUPS } from './validate/types.js';
-import { renderWelcome } from './welcome.js';
-import { workflowsBuilder } from './workflows/index.js';
-// The branded welcome screen replaces yargs' default help, but only for an
-// interactive human at a TTY. Piped, scripted, AI, and test callers keep the
-// plain yargs help so their output stays parseable and stable.
-const shouldShowWelcome = (args) => {
-    const interactive = Boolean(process.stdout.isTTY) && !isAI() && process.env.CLI_TEST_MODE !== 'true';
-    if (!interactive)
-        return false;
-    if (args.length === 0)
-        return true;
-    const positionals = args.filter((arg) => !arg.startsWith('-'));
-    const command = positionals[0];
-    // `help` followed by a subcommand (e.g. `mint help dev`) is a subcommand
-    // lookup — let yargs handle it rather than intercepting with the welcome screen.
-    const isTopLevel = command === undefined || (command === 'help' && positionals.length === 1);
-    const helpRequested = command === 'help' || args.includes('--help') || args.includes('-h');
-    return isTopLevel && helpRequested;
-};
-const showWelcome = (packageName) => __awaiter(void 0, void 0, void 0, function* () {
-    const { cli: version } = getVersions(packageName);
-    const subdomain = getConfigValue('subdomain');
-    let signedIn = false;
-    try {
-        signedIn = Boolean(yield getAccessToken());
-    }
-    catch (_a) { }
-    process.stdout.write(renderWelcome({ packageName, version, signedIn, subdomain }));
-    yield terminate(0);
-});
-export const cli = ({ packageName = 'mint' }) => {
-    const commandArguments = hideBin(process.argv);
-    if (shouldShowWelcome(commandArguments)) {
-        return showWelcome(packageName);
-    }
-    const telemetryMiddleware = createTelemetryMiddleware();
-    render(_jsx(Logs, {}));
-    return (yargs(commandArguments)
-        .scriptName(packageName)
-        .option('telemetry', {
-        type: 'boolean',
-        alias: 't',
-        description: 'Enable or disable usage telemetry',
-    })
-        .middleware((argv) => __awaiter(void 0, void 0, void 0, function* () {
-        if (argv.telemetry !== undefined && argv._.length === 0) {
-            yield setTelemetryEnabled(argv.telemetry);
-            yield trackTelemetryPreferenceChange({ enabled: argv.telemetry });
-            addLog(_jsx(SuccessLog, { message: `telemetry ${argv.telemetry ? 'enabled' : 'disabled'}` }));
-            yield terminate(0);
-        }
-    }), true)
-        .middleware(checkNodeVersion)
-        .middleware(suppressConsoleWarnings)
-        .middleware(telemetryMiddleware)
-        .command('agent', 'Set up AI coding agents for Mintlify', (yargs) => yargs
-        .command('setup', 'Install Mintlify skills and configure Admin MCP', (yargs) => yargs
-        .exitProcess(false)
-        .option('agent', {
-        alias: 'a',
-        type: 'string',
-        array: true,
-        choices: SETUP_AGENTS,
-        description: 'Agents to configure (defaults to interactive selection)',
-    })
-        .option('global', {
-        alias: 'g',
-        type: 'boolean',
-        default: false,
-        description: 'Set up agents for your user account instead of this project',
-    })
-        .example('$0 agent setup', 'Choose agents and set up the current project')
-        .example('$0 agent setup --agent codex --global', 'Set up Codex for your user account')
-        .epilog('Requires Node.js 22.20 or later and npm. Admin MCP requires a separate OAuth sign-in in each agent.'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        try {
-            yield setupAgent({ agents: argv.agent, global: argv.global });
-            yield terminate(0);
-        }
-        catch (error) {
-            process.stderr.write(`${error instanceof Error ? error.message : 'Agent setup failed.'}\n`);
-            yield terminate(1);
-        }
-    }))
-        .demandCommand(1, 'Run mint agent setup to configure your coding agents.'))
-        .command('claim', 'Claim a site created with mint deploy', (yargs) => yargs
-        .option('email', { type: 'string', description: 'User email for a claim link' })
-        .option('code', {
-        type: 'string',
-        description: 'Code returned by the user from the claim page',
-    })
-        .option('directory', {
-        type: 'string',
-        default: '.',
-        description: 'Original documentation directory used for mint deploy',
-    })
-        .conflicts('code', 'email')
-        .example('$0 claim --email you@example.com', 'Get a claim link for the current site')
-        .example('$0 claim --code ABCDEFGH', 'Finish the claim with the code from the user')
-        .epilog('Run from the same directory as mint deploy, or pass --directory. Ask the user to open the claim link and return the code. The CLI reads saved credentials internally; do not read or print keychain secrets. Retry the same command if Mintlify signup fails.'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        try {
-            const message = yield claimDeployment({ apiUrl: API_URL, directory: argv.directory, code: argv.code, email: argv.email }, (message) => process.stderr.write(`${message}\n`));
-            process.stdout.write(`${message}\n`);
-            yield terminate(0);
-        }
-        catch (error) {
-            process.stderr.write(`${error instanceof Error ? error.message : 'Claim failed.'}\n`);
-            yield terminate(1);
-        }
-    }))
-        .command('deploy', 'Provision an anonymous docs site and get Git push instructions', (yargs) => yargs
-        .option('subdomain', {
-        type: 'string',
-        description: 'Requested site name; required for the first deployment or --new',
-    })
-        .option('org-name', { type: 'string', description: 'Organization display name' })
-        .option('directory', {
-        type: 'string',
-        default: '.',
-        description: 'Documentation directory associated with this site',
-    })
-        .option('new', {
-        type: 'boolean',
-        default: false,
-        description: 'Create a new registration and site',
-    })
-        .option('email', {
-        type: 'string',
-        description: 'User email for an optional claim link',
-    })
-        .option('github', {
-        type: 'boolean',
-        description: 'Trust this GitHub repository to deploy the site and write a GitHub Actions workflow',
-    })
-        .option('force', {
-        type: 'boolean',
-        default: false,
-        description: 'With --github, overwrite an existing .github/workflows/mintlify.yml',
-    })
-        .option('base', {
-        type: 'boolean',
-        description: 'Provision a base, edited in the Mintlify editor, instead of a docs site',
-    })
-        .option('push', {
-        type: 'string',
-        description: 'With --base, rebase this clone onto main and push it to the base',
-    })
-        .implies('push', 'base')
-        .conflicts('push', 'email')
-        .conflicts('github', 'email')
-        .conflicts('base', 'github')
-        .example('$0 deploy --subdomain my-docs', 'Provision a site without signing in')
-        .example('$0 deploy --email you@example.com', 'Get repository access and a claim link for the current site')
-        .example('$0 deploy --new --subdomain another-site', 'Create another anonymous site')
-        .example('$0 deploy --base --subdomain my-base', 'Provision a base and get its editor link')
-        .example('$0 deploy --github --subdomain my-docs', 'Deploy the site from GitHub Actions on every push to the default branch')
-        .example('$0 deploy --subdomain my-docs', 'In GitHub Actions with id-token: write, push the current commit to a trusted site')
-        .epilog(DEPLOY_HELP), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        try {
-            if (isGithubActions()) {
-                const siteUrl = yield deployFromGithubActions({ apiUrl: API_URL, directory: argv.directory, subdomain: argv.subdomain }, (message) => process.stderr.write(`${message}\n`));
-                process.stdout.write(`Pushed to ${argv.subdomain}; the build starts now.\nSite: ${siteUrl}\n`);
-                yield terminate(0);
-                return;
-            }
-            if (argv.github) {
-                const setup = yield setupGithubDeployment({
-                    apiUrl: API_URL,
-                    directory: argv.directory,
-                    subdomain: argv.subdomain,
-                    orgName: argv.orgName,
-                    newSite: argv.new,
-                    force: argv.force,
-                }, (message) => process.stderr.write(`Warning: ${message}\n`), (message) => process.stderr.write(`${message}\n`));
-                process.stdout.write(`${formatGithubSetup(setup)}\n`);
-                yield terminate(0);
-                return;
-            }
-            const result = yield prepareAgentDeployment({
-                apiUrl: API_URL,
-                directory: argv.directory,
-                subdomain: argv.subdomain,
-                orgName: argv.orgName,
-                newSite: argv.new,
-                base: argv.base,
-            }, (message) => {
-                process.stderr.write(`Warning: ${message}\n`);
-            }, (message) => process.stderr.write(`${message}\n`));
-            if (argv.push && result.status === 'ready') {
-                yield pushBaseCheckout(argv.push, result.write);
-                process.stdout.write(`Pushed ${argv.push} to the base.\nEditor: ${agentEditorUrl(result.site)}\n`);
-                yield terminate(0);
-                return;
-            }
-            process.stdout.write(`${formatDeployment(result, API_URL)}\n`);
-            let claimUrl;
-            if (argv.email && result.status === 'ready') {
-                try {
-                    process.stderr.write('Creating the claim link...\n');
-                    claimUrl = yield createAgentClaimLink(API_URL, result.credentials, argv.email);
-                }
-                catch (error) {
-                    const reason = error instanceof Error ? ` ${error.message}` : '';
-                    process.stderr.write(`Warning: Could not create the claim link.${reason} Your site is provisioned; retry with --email later.\n`);
-                }
-            }
-            process.stdout.write(`${deploymentInstructions(result, claimUrl)}\n`);
-            yield terminate(0);
-        }
-        catch (error) {
-            process.stderr.write(`${error instanceof Error ? error.message : 'Deployment failed.'}\n`);
-            yield terminate(1);
-        }
-    }))
-        .command('dev', 'Initialize a local preview environment', (yargs) => yargs
-        .option('open', {
-        type: 'boolean',
-        default: true,
-        description: 'open a local preview in the browser',
-    })
-        .option('local-schema', {
-        type: 'boolean',
-        default: false,
-        hidden: true,
-        description: 'use a locally hosted schema file (note: only https protocol is supported in production)',
-    })
-        .option('client-version', {
-        type: 'string',
-        hidden: true,
-        description: 'the version of the client to use for cli testing',
-    })
-        .option('local-client-version', {
-        type: 'string',
-        hidden: true,
-        description: 'path to local client repo to symlink for development',
-    })
-        .option('groups', {
-        type: 'array',
-        description: 'Mock user groups for local development and testing',
-        example: '--groups admin user',
-    })
-        .option('signed-in', {
-        type: 'boolean',
-        default: false,
-        description: 'Mock a signed-in user with no groups for local development and testing',
-    })
-        .option('disable-openapi', {
-        type: 'boolean',
-        default: false,
-        description: 'Disable OpenAPI file generation',
-    })
-        .option('disable-prefetch', {
-        type: 'boolean',
-        default: false,
-        description: 'Disable navigation prefetching in the local preview',
-    })
-        .option('host', {
-        type: 'boolean',
-        default: false,
-        description: 'Expose the local preview on your network',
-    })
-        .option('classic', {
-        type: 'boolean',
-        default: false,
-        description: 'Preview with the classic client',
-    })
-        .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;
-        yield autoUpgradeIfNeeded();
-        const port = yield checkPort(argv);
-        const { cli: cliVersion } = getVersions(packageName);
-        let accessToken;
-        let subdomain;
-        try {
-            accessToken = (_a = (yield getAccessToken())) !== null && _a !== void 0 ? _a : undefined;
-            const configuredSubdomain = getConfigValue('subdomain');
-            subdomain =
-                configuredSubdomain !== null && configuredSubdomain !== void 0 ? configuredSubdomain : (accessToken ? (yield getCliSubdomains(accessToken))[0] : undefined);
-        }
-        catch (_c) { }
-        if (port != undefined) {
-            yield dev(Object.assign(Object.assign({}, argv), { groups: (_b = argv.groups) !== null && _b !== void 0 ? _b : (argv.signedIn ? [] : undefined), port,
-                packageName,
-                cliVersion,
-                accessToken,
-                subdomain, apiUrl: API_URL }));
-        }
-        else {
-            addLog(_jsx(ErrorLog, { message: "no available port found" }));
-            yield terminate(1);
-        }
-    }))
-        .command('validate', 'Check the docs: content, OpenAPI specs, then a strict build. Exits 0 with no errors, 1 with errors, 2 when validate itself could not run', (yargs) => yargs
-        .option('local-schema', {
-        type: 'boolean',
-        default: false,
-        hidden: true,
-        description: 'use a locally hosted schema file',
-    })
-        .option('client-version', {
-        type: 'string',
-        hidden: true,
-        description: 'the version of the client to use for cli testing',
-    })
-        .option('groups', {
-        type: 'array',
-        description: 'Mock user groups for validation',
-    })
-        .option('files', {
-        type: 'string',
-        array: true,
-        description: 'Limit page checks to these files or globs; site-wide checks and the build still cover the whole site',
-    })
-        .option('build', {
-        type: 'boolean',
-        default: true,
-        description: 'Run the strict build after the other checks pass; --no-build skips it, so no client download is needed. Remote OpenAPI specs are still fetched unless openapi rules are disabled',
-    })
-        .option('enable', {
-        type: 'string',
-        array: true,
-        coerce: splitList,
-        description: 'Turn on rules or groups (comma-separated), for example after --disable all',
-    })
-        .option('disable', {
-        type: 'string',
-        array: true,
-        coerce: splitList,
-        description: 'Turn off rules or groups (comma-separated), or all; parse errors are still reported',
-    })
-        .option('fix', {
-        type: 'boolean',
-        default: false,
-        description: 'Apply the fixes and check again',
-    })
-        .option('format', {
-        type: 'string',
-        choices: ['text', 'json'],
-        default: 'text',
-        description: 'Output format; json prints one report ({ passed, summary, diagnostics, build }) and nothing else on stdout, and errors to stderr',
-    })
-        .usage('usage: mint validate [options]')
-        .epilogue([
-        `Groups: ${GROUPS.join(', ')}. Rules:`,
-        ...RULES.map(({ id, description }) => `  ${id} — ${description}`),
-        `  parse-error — ${PARSE_ERROR.description} (always runs)`,
-    ].join('\n'))
-        .example('mint validate', 'run every check and the build')
-        .example('mint validate --no-build --format json', 'fast offline check for scripts and agents')
-        .example('mint validate --files "guides/**/*.mdx" --fix', 'check some pages and apply fixes')
-        .example('mint validate --disable all --enable content', 'run the content rules only; missing-file and import-error still run the build')
-        .strict(), (argv) => validateHandler(argv, packageName))
-        .command('export', 'Export a static site for air-gapped deployment', (yargs) => yargs
-        .option('output', {
-        type: 'string',
-        default: 'export.zip',
-        description: 'output zip file path',
-    })
-        .option('client-version', {
-        type: 'string',
-        hidden: true,
-    })
-        .option('local-client-version', {
-        type: 'string',
-        hidden: true,
-        description: 'path to local client repo to symlink for development',
-    })
-        .option('groups', {
-        type: 'array',
-        description: 'Mock user groups for export',
-    })
-        .option('base-path', {
-        type: 'string',
-        description: 'path prefix the export will be served under, e.g. /docs',
-    })
-        .option('disable-openapi', {
-        type: 'boolean',
-        default: false,
-        description: 'Disable OpenAPI file generation',
-    })
-        .option('classic', {
-        type: 'boolean',
-        default: false,
-        description: 'Export with the classic client',
-    })
-        .usage('usage: mintlify export [options]')
-        .example('mintlify export', 'export as export.zip')
-        .example('mintlify export --output docs.zip', 'export to custom filename')
-        .example('mintlify export --base-path /docs', 'export for hosting under /docs'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        const { cli: cliVersion } = getVersions(packageName);
-        yield exportSite(Object.assign(Object.assign({}, argv), { packageName,
-            cliVersion }));
-        yield terminate(0);
-    }))
-        .command('openapi-check <filename>', false, (yargs) => yargs
-        .positional('filename', {
-        describe: 'the filename of the OpenAPI spec (e.g. ./openapi.yaml) or the URL to the OpenAPI spec (e.g. https://petstore3.swagger.io/api/v3/openapi.json)',
-        type: 'string',
-        demandOption: true,
-    })
-        .option('local-schema', {
-        type: 'boolean',
-        default: false,
-        description: 'use a locally hosted schema file (note: only https protocol is supported in production)',
-    }), (_a) => __awaiter(void 0, [_a], void 0, function* ({ filename, 'local-schema': localSchema }) {
-        addLog(_jsx(WarningLog, { message: "openapi-check is deprecated, use `mintlify validate` instead" }));
-        let overlayRegistry;
-        try {
-            overlayRegistry = yield buildOverlayRegistryForCheck(localSchema);
-        }
-        catch (error) {
-            addLog(_jsx(ErrorLog, { message: error instanceof Error ? error.message : String(error) }));
-            yield terminate(1);
-            return;
-        }
-        const valid = yield checkOpenApiFile(filename, localSchema, overlayRegistry);
-        yield terminate(valid ? 0 : 1);
-    }))
-        .command('broken-links', 'Check for broken links', (yargs) => yargs
-        .option('files', {
-        type: 'string',
-        array: true,
-        description: 'Files or globs to check (defaults to the whole site)',
-    })
-        .option('check-anchors', {
-        type: 'boolean',
-        default: false,
-        description: 'also validate anchor links (e.g. #section) against heading slugs',
-    })
-        .option('check-external', {
-        type: 'boolean',
-        default: false,
-        description: 'also check external links for broken URLs',
-    })
-        .option('check-snippets', {
-        type: 'boolean',
-        default: false,
-        description: 'also check links inside <Snippet> components',
-    })
-        .option('check-redirects', {
-        type: 'boolean',
-        default: false,
-        description: 'also check that docs.json redirect destinations resolve to valid paths',
-    })
-        .example('mint broken-links --files introduction.mdx', 'Check a specific page')
-        .example('mint broken-links --files "guides/**/*.mdx"', 'Check pages matching a glob'), (argv) => brokenLinksHandler(argv))
-        .command('instructions [topics..]', 'Print Mintlify workflow instructions for agents', (yargs) => yargs
-        .positional('topics', {
-        type: 'string',
-        array: true,
-        default: [],
-        description: 'Topic and optional subtopic',
-    })
-        .example('mint instructions', 'List topics')
-        .example('mint instructions publish domain', 'Custom domain instructions'), (_a) => __awaiter(void 0, [_a], void 0, function* ({ topics }) {
-        if (topics.length === 0) {
-            process.stdout.write(formatTopics());
-            yield terminate(0);
-            return;
-        }
-        let markdown;
-        try {
-            markdown = yield fetchInstructions(topics);
-        }
-        catch (error) {
-            addLog(_jsx(ErrorLog, { message: error instanceof Error ? error.message : String(error) }));
-            yield terminate(1);
-            return;
-        }
-        yield new Promise((resolve) => process.stdout.write(markdown, () => resolve()));
-        yield terminate(0);
-    }))
-        .command('status', 'View current authentication status', () => undefined, () => __awaiter(void 0, void 0, void 0, function* () {
-        yield status();
-        yield terminate(0);
-    }))
-        .command('logout', 'Logout of your Mintlify account', () => undefined, () => __awaiter(void 0, void 0, void 0, function* () {
-        yield logout();
-        yield terminate(0);
-    }))
-        .command('login', 'Authenticate your account to Mintlify', () => undefined, () => __awaiter(void 0, void 0, void 0, function* () {
-        yield login();
-        yield terminate(0);
-    }))
-        .command('signup', 'Create a new Mintlify account', (yargs) => yargs
-        .option('firstName', { type: 'string', description: 'First name' })
-        .option('lastName', { type: 'string', description: 'Last name' })
-        .option('company', { type: 'string', description: 'Company name' })
-        .option('email', { type: 'string', description: 'Email address' })
-        .epilogue('Note: this command does not return until the user clicks the verification link ' +
-        'sent to their email, which can take several minutes. Non-interactive or scripted ' +
-        'callers should run it as a background process rather than waiting on it synchronously.'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        yield signup({
-            firstName: argv.firstName,
-            lastName: argv.lastName,
-            company: argv.company,
-            email: argv.email,
-        });
-        yield terminate(0);
-    }))
-        .command('add-domain <domain>', 'Add a custom domain to your deployment', (yargs) => yargs
-        .positional('domain', {
-        type: 'string',
-        demandOption: true,
-        description: 'The custom domain to add (e.g. docs.example.com)',
-    })
-        .option('basePath', {
-        type: 'string',
-        description: 'Serve the docs under a base path (e.g. /docs)',
-    }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        yield addDomain(argv.domain, argv.basePath);
-        yield terminate(0);
-    }))
-        .command('feedback <message>', 'Send feedback to the Mintlify team', (yargs) => yargs
-        .positional('message', {
-        type: 'string',
-        demandOption: true,
-        description: 'Feedback to send. Leave out API keys, tokens, and other secrets',
-    })
-        .option('client-id', {
-        type: 'string',
-        demandOption: true,
-        description: 'ID for this report, so the team can tell retries apart',
-    })
-        .option('category', {
-        choices: FEEDBACK_CATEGORIES,
-        demandOption: true,
-        description: 'Feedback category',
-    })
-        .example('$0 feedback "mint dev crashes on a missing image" --client-id 7f3a --category bug', 'Report a bug')
-        .epilog('Never include API keys, tokens, passwords, or other secrets in the message.'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        const sent = yield feedback({
-            message: argv.message,
-            clientId: argv.clientId,
-            category: argv.category,
-        });
-        yield terminate(sent ? 0 : 1);
-    }))
-        .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);
-    }))
-        .command(['a11y', 'accessibility-check', 'a11y-check', 'accessibility'], 'Check for accessibility issues in documentation', (yargs) => yargs
-        .option('skip-contrast', {
-        type: 'boolean',
-        default: false,
-        description: 'Skip color contrast checks',
-    })
-        .option('skip-alt-text', {
-        type: 'boolean',
-        default: false,
-        description: 'Skip alt text checks on images and videos',
-    })
-        .check((argv) => {
-        if (argv.skipContrast && argv.skipAltText) {
-            throw new Error('Cannot skip both contrast and alt-text checks');
-        }
-        return true;
-    })
-        .example('mint a11y', 'Run all accessibility checks')
-        .example('mint a11y --skip-contrast', 'Only check for missing alt text')
-        .example('mint a11y --skip-alt-text', 'Only check color contrast'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        let accessibilityCheckTerminateCode = 0;
-        let mdxLinterTerminateCode = 0;
-        if (!argv.skipContrast) {
-            accessibilityCheckTerminateCode = yield accessibilityCheck();
-        }
-        if (!argv.skipAltText) {
-            mdxLinterTerminateCode = yield mdxLinter();
-        }
-        yield terminate(accessibilityCheckTerminateCode || mdxLinterTerminateCode);
-    }))
-        .command('og [page]', 'Render the social preview (OG) image for a page', (yargs) => yargs
-        .positional('page', {
-        type: 'string',
-        description: 'Page path, such as guides/webhooks. Defaults to index',
-    })
-        .option('preset', {
-        choices: thumbnailOverrideSchema.shape.preset.unwrap().options,
-        description: 'Try a preset without editing docs.json',
-    })
-        .option('surface', {
-        choices: thumbnailOverrideSchema.shape.surface.unwrap().options,
-        description: 'Try a surface without editing docs.json',
-    })
-        .option('appearance', {
-        choices: thumbnailOverrideSchema.shape.appearance.unwrap().options,
-        description: 'Try an appearance without editing docs.json',
-    })
-        .option('output', {
-        type: 'string',
-        description: 'Where to write the PNG. Defaults to a temporary file',
-    })
-        .option('open', {
-        type: 'boolean',
-        default: true,
-        description: 'Open the image after rendering. Use --no-open in CI',
-    })
-        .example('mint og guides/webhooks', 'Render one page and open it')
-        .example('mint og --preset headline --surface brand', 'Try settings on the home page')
-        .example('mint og --output og.png --no-open', 'Render to a file in CI'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        yield terminate(yield ogCommand(argv));
-    }))
-        .command(['version', 'v'], 'Display the current version of the CLI and client', () => undefined, () => __awaiter(void 0, void 0, void 0, function* () {
-        const { cli, client } = getVersions(packageName);
-        addLog(_jsxs(Text, { children: [_jsx(Text, { bold: true, color: "green", children: "cli version" }), ' ', cli] }));
-        addLog(_jsxs(Text, { children: [_jsx(Text, { bold: true, color: "green", children: "client version" }), ' ', client] }));
-    }))
-        .command('new [directory]', 'Create a new Mintlify documentation site', (yargs) => yargs
-        .positional('directory', {
-        describe: 'The directory to initialize your documentation',
-        type: 'string',
-        default: '.',
-    })
-        .option('theme', {
-        type: 'string',
-        description: 'Theme for the documentation site',
-    })
-        .option('name', {
-        type: 'string',
-        description: 'Name of the documentation project',
-    })
-        .option('template', {
-        type: 'string',
-        description: 'Use a template as a starting point',
-    })
-        .option('force', {
-        type: 'boolean',
-        default: false,
-        description: 'Create the documentation in a subdirectory',
-    }), (_a) => __awaiter(void 0, [_a], void 0, function* ({ directory, theme, name, force, template }) {
-        try {
-            yield init(directory, force, theme, name, template);
-            yield terminate(0);
-        }
-        catch (error) {
-            addLog(_jsx(ErrorLog, { message: error instanceof Error ? error.message : 'error occurred' }));
-            yield terminate(1);
-        }
-    }))
-        .command('analytics', 'View analytics for your documentation', analyticsBuilder)
-        .command(['automations', 'workflow', 'workflows'], 'Create and manage automations', workflowsBuilder)
-        .command('score [url]', 'Run agent readiness checks on a docs site', (yargs) => yargs
-        .positional('url', {
-        type: 'string',
-        description: 'URL of the docs site to check (defaults to your configured subdomain)',
-    })
-        .option('format', {
-        type: 'string',
-        choices: ['table', 'plain', 'json'],
-        description: 'Output format',
-    })
-        .example('mint score', 'Run agent readiness checks on your default subdomain')
-        .example('mint score docs.example.com', 'Run agent readiness checks on a URL'), scoreHandler)
-        .command('format', 'Format MDX files in the current directory', (yargs) => yargs
-        .usage('usage: mint format')
-        .example('mint format', 'format all MDX files in the current directory'), formatHandler)
-        .command('migrate', 'Print instructions for migrating a docs site to Mintlify', (yargs) => yargs
-        .option('from', {
-        type: 'string',
-        choices: listMigrationDocs('sources'),
-        description: 'Include instructions for a source platform',
-    })
-        .option('topic', {
-        type: 'string',
-        choices: listMigrationDocs('topics'),
-        description: 'Print a single topic',
-    })
-        .option('agent', {
-        type: 'string',
-        choices: Object.keys(agents),
-        description: 'Run the migration with a coding agent',
-    })
-        .option('claude', {
-        type: 'boolean',
-        description: 'Alias for --agent claude',
-    }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a;
-        const agent = (_a = argv.agent) !== null && _a !== void 0 ? _a : (argv.claude ? 'claude' : undefined);
-        void trackEvent('cli.migrate.executed', {
-            from: argv.from,
-            topic: argv.topic,
-            agent,
-        });
-        if (agent) {
-            try {
-                return yield terminate(yield migrateWithAgent(agent, argv.from));
-            }
-            catch (error) {
-                addLog(_jsx(ErrorLog, { message: error instanceof Error ? error.message : String(error) }));
-                return yield terminate(1);
-            }
-        }
-        yield new Promise((resolve) => process.stdout.write(migrationInstructions(argv), () => resolve()));
-        yield terminate(0);
-    }))
-        // Coming soon commands — visible in help, tracked via telemetry to gauge interest.
-        .command('ai', '[Coming soon] AI-powered documentation (run mint ai to vote)', () => undefined, comingSoon('ai', packageName))
-        .command('mcp', '[Coming soon] MCP server for documentation (run mint mcp to vote)', () => undefined, comingSoon('mcp', packageName))
-        // Print the help menu when the user enters an invalid command.
-        .strictCommands()
-        .demandCommand(1, 'unknown command. see above for the list of supported commands.')
-        // Alias option flags --help = -h, default --version = -v
-        .alias('h', 'help')
-        .alias('v', 'version')
-        .parseAsync());
-};