@mintlify/cli 4.0.1068 → 4.0.1069

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1068",
+  "version": "4.0.1069",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -88,5 +88,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "3401569a70e020cc6f08559f5f6feed9715c8324"
+  "gitHead": "10c9be1d7e8d3ccf3f86df9498a1e334090b401e"
 }

package/src/cli.tsx

@@ -27,10 +27,8 @@ import { accessibilityCheck } from './accessibilityCheck.js';
 import { setTelemetryEnabled } from './config.js';
 import {
   checkPort,
-  checkForMintJson,
   checkNodeVersion,
-  upgradeConfig,
-  checkForDocsJson,
+  autoUpgradeIfNeeded,
   getVersions,
   suppressConsoleWarnings,
   terminate,
@@ -109,6 +107,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
             .example('mintlify dev', 'run with default settings (opens in browser)')
             .example('mintlify dev --no-open', 'run without opening in browser'),
         async (argv) => {
+          await autoUpgradeIfNeeded();
           const port = await checkPort(argv);
           const { cli: cliVersion } = getVersions();
           if (port != undefined) {
@@ -273,11 +272,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
               description: 'also check links inside <Snippet> components',
             }),
         async (argv) => {
-          const hasMintJson = await checkForMintJson();
-          if (!hasMintJson) {
-            await checkForDocsJson();
-          }
-
+          await autoUpgradeIfNeeded();
           addLog(<SpinnerLog message="checking for broken links..." />);
           try {
             const graph = await buildGraph(undefined, {
@@ -355,10 +350,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
             })
             .epilog('example: `mintlify rename introduction.mdx overview.mdx`'),
         async ({ from, to, force }) => {
-          const hasMintJson = await checkForMintJson();
-          if (!hasMintJson) {
-            await checkForDocsJson();
-          }
+          await autoUpgradeIfNeeded();
           await renameFilesAndUpdateLinksInContent(from, to, force);
           await terminate(0);
         }
@@ -372,18 +364,6 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
           await terminate(0);
         }
       )
-      .command(
-        'upgrade',
-        'upgrade mint.json file to docs.json (current format)',
-        () => undefined,
-        async () => {
-          const hasMintJson = await checkForMintJson();
-          if (!hasMintJson) {
-            await checkForDocsJson();
-          }
-          await upgradeConfig();
-        }
-      )
       .command(
         'migrate-mdx',
         'migrate mdx openapi endpoint pages to x-mint extensions and docs.json',

package/src/helpers.tsx

@@ -9,6 +9,7 @@ import {
   SpinnerLog,
   removeLastLog,
   LOCAL_LINKED_CLI_VERSION,
+  WarningLog,
 } from '@mintlify/previewing';
 import { upgradeToDocsConfig, validatePathWithinCwd } from '@mintlify/validation';
 import detect from 'detect-port';
@@ -94,6 +95,19 @@ export const checkForDocsJson = async () => {
   }
 };
 
+export const autoUpgradeIfNeeded = async () => {
+  const hasMintJson = await checkForMintJson();
+  if (!hasMintJson) return;
+
+  const docsJsonPath = path.join(CMD_EXEC_PATH, 'docs.json');
+  const hasDocsJson = await fse.pathExists(docsJsonPath);
+  if (!hasDocsJson) {
+    addLog(<WarningLog message="Legacy mint.json detected, auto-upgrading to docs.json" />);
+    addLog(<SpinnerLog message="upgrading mint.json to docs.json..." />);
+    await upgradeConfig();
+  }
+};
+
 export const upgradeConfig = async () => {
   try {
     const mintJsonPath = path.join(CMD_EXEC_PATH, 'mint.json');