@mintlify/cli 4.0.1088 → 4.0.1090

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1088",
+  "version": "4.0.1090",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -46,9 +46,9 @@
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
     "@mintlify/common": "1.0.835",
-    "@mintlify/link-rot": "3.0.1009",
+    "@mintlify/link-rot": "3.0.1010",
     "@mintlify/prebuild": "1.0.977",
-    "@mintlify/previewing": "4.0.1037",
+    "@mintlify/previewing": "4.0.1038",
     "@mintlify/validation": "0.1.653",
     "adm-zip": "0.5.16",
     "chalk": "5.2.0",
@@ -93,5 +93,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "8d3507469a2bba7c8ff8b0f5f7139ff3c8240041"
+  "gitHead": "a92a9ad306f6cb919dc792f85519ccc7242a6d67"
 }

package/src/cli.tsx

@@ -20,6 +20,7 @@ import { hideBin } from 'yargs/helpers';
 
 import { accessibilityCheck } from './accessibilityCheck.js';
 import { analyticsBuilder } from './analytics/index.js';
+import { comingSoon } from './comingSoon.js';
 import { setTelemetryEnabled } from './config.js';
 import { getConfigValue, setConfigValue, clearConfigValue } from './config.js';
 import { API_URL } from './constants.js';
@@ -69,7 +70,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       .middleware(telemetryMiddleware)
       .command(
         'dev',
-        'initialize a local preview environment',
+        'Initialize a local preview environment',
         (yargs) =>
           yargs
             .option('open', {
@@ -138,7 +139,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'validate',
-        'validate the documentation build (strict mode, exits on warnings or errors)',
+        'Validate the documentation build (strict mode, exits on warnings or errors)',
         (yargs) =>
           yargs
             .option('local-schema', {
@@ -192,7 +193,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'export',
-        'export a static site for air-gapped deployment',
+        'Export a static site for air-gapped deployment',
         (yargs) =>
           yargs
             .option('output', {
@@ -253,7 +254,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'broken-links',
-        'check for broken links',
+        'Check for broken links',
         (yargs) =>
           yargs
             .option('check-anchors', {
@@ -340,7 +341,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'logout',
-        'logout of your mintlify account',
+        'Logout of your Mintlify account',
         () => undefined,
         async () => {
           await logout();
@@ -349,18 +350,18 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'login',
-        'authenticate your account to mintlify',
+        'Authenticate your account to Mintlify',
         () => undefined,
         async () => {
           await login();
           await terminate(0);
         }
       )
-      .command('config', 'manage CLI configuration', (yargs) =>
+      .command('config', 'Manage CLI configuration', (yargs) =>
         yargs
           .command(
             'set <key> <value>',
-            'set a configuration value',
+            'Set a configuration value',
             (yargs) =>
               yargs
                 .positional('key', {
@@ -391,7 +392,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
           )
           .command(
             'get <key>',
-            'get a configuration value',
+            'Get a configuration value',
             (yargs) =>
               yargs.positional('key', {
                 type: 'string',
@@ -416,7 +417,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
           )
           .command(
             'clear <key>',
-            'remove a configuration value',
+            'Remove a configuration value',
             (yargs) =>
               yargs.positional('key', {
                 type: 'string',
@@ -443,7 +444,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'update',
-        'update the CLI to the latest version',
+        'Update the CLI to the latest version',
         () => undefined,
         async () => {
           await update({ packageName });
@@ -452,7 +453,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         ['a11y', 'accessibility-check', 'a11y-check', 'accessibility'],
-        'check for accessibility issues in documentation',
+        'Check for accessibility issues in documentation',
         (yargs) =>
           yargs
             .option('skip-contrast', {
@@ -491,7 +492,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         ['version', 'v'],
-        'display the current version of the cli and client',
+        'Display the current version of the CLI and client',
         () => undefined,
         async () => {
           const { cli, client } = getVersions();
@@ -515,7 +516,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'new [directory]',
-        'create a new mintlify documentation site',
+        'Create a new Mintlify documentation site',
         (yargs) =>
           yargs
             .positional('directory', {
@@ -550,7 +551,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'workflow',
-        'add a workflow to your documentation repository',
+        'Add a workflow to your documentation repository',
         () => undefined,
         async () => {
           try {
@@ -564,7 +565,32 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
           }
         }
       )
-      .command('analytics', 'view analytics for your documentation', analyticsBuilder)
+      .command('analytics', 'View analytics for your documentation', analyticsBuilder)
+      // 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(
+        'test',
+        '[Coming soon] Test your documentation (run mint test to vote)',
+        () => undefined,
+        comingSoon('test', packageName)
+      )
+      .command(
+        'signup',
+        '[Coming soon] Sign up for a Mintlify account (run mint signup to vote)',
+        () => undefined,
+        comingSoon('signup', 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.')

package/src/comingSoon.tsx

@@ -0,0 +1,29 @@
+import { addLog, SuccessLog, WarningLog } from '@mintlify/previewing';
+import { Text } from 'ink';
+
+import { isTelemetryEnabled } from './config.js';
+import { terminate } from './helpers.js';
+
+export function comingSoon(command: string, packageName: string) {
+  return async () => {
+    if (!isTelemetryEnabled()) {
+      addLog(
+        <WarningLog
+          message={`Telemetry is disabled, so your vote won't be counted. Enable it with: ${packageName} --telemetry=true`}
+        />
+      );
+    } else {
+      addLog(
+        <SuccessLog
+          message={`Thanks for your interest in "${packageName} ${command}"! Your vote has been counted.`}
+        />
+      );
+    }
+    addLog(
+      <Text dimColor>
+        This feature is currently in development. Learn more at https://mintlify.com/docs
+      </Text>
+    );
+    await terminate(0);
+  };
+}