@mintlify/cli 4.0.1337 → 4.0.1339

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1337",
+  "version": "4.0.1339",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -45,11 +45,11 @@
   },
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
-    "@mintlify/common": "1.0.1041",
-    "@mintlify/link-rot": "3.0.1233",
+    "@mintlify/common": "1.0.1042",
+    "@mintlify/link-rot": "3.0.1235",
     "@mintlify/models": "0.0.343",
-    "@mintlify/prebuild": "1.0.1189",
-    "@mintlify/previewing": "4.0.1258",
+    "@mintlify/prebuild": "1.0.1190",
+    "@mintlify/previewing": "4.0.1259",
     "@mintlify/validation": "0.1.798",
     "adm-zip": "0.5.16",
     "chalk": "5.2.0",
@@ -92,5 +92,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "e6c3793e677c3aa79650fb9fbd31467ff1649d2e"
+  "gitHead": "3498acefd9c006ff788a60431cca85d03053d782"
 }

package/src/cli.tsx

@@ -24,6 +24,7 @@ import { setTelemetryEnabled } from './config.js';
 import { getConfigValue, setConfigValue, clearConfigValue } from './config.js';
 import { API_URL } from './constants.js';
 import { deslopHandler } from './deslop/index.js';
+import { resolveExplicitFiles } from './deslop/resolveFiles.js';
 import {
   CMD_EXEC_PATH,
   checkPort,
@@ -296,6 +297,11 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
         '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,
@@ -315,19 +321,35 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
               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'),
         async (argv) => {
           await autoUpgradeIfNeeded();
           addLog(<SpinnerLog message="checking for broken links..." />);
           try {
+            const fileArgs = (argv.files ?? []).map(String).filter(Boolean);
+            const sourceFiles =
+              fileArgs.length > 0
+                ? new Set(
+                    (await resolveExplicitFiles(CMD_EXEC_PATH, fileArgs)).map((file) =>
+                      path.normalize(file)
+                    )
+                  )
+                : undefined;
             const graph = await buildGraph(undefined, {
               checkSnippets: argv['check-snippets'],
             });
             graph.precomputeFileResolutions();
 
-            const brokenInternalLinks = graph.getBrokenInternalLinks({
-              checkAnchors: argv['check-anchors'],
-            });
+            const brokenInternalLinks = graph
+              .getBrokenInternalLinks({
+                checkAnchors: argv['check-anchors'],
+              })
+              .filter(
+                ({ relativeDir, filename }) =>
+                  !sourceFiles || sourceFiles.has(path.join(relativeDir, filename))
+              );
 
             const brokenLinksByFile: Record<string, string[]> = {};
 
@@ -342,7 +364,10 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
             });
 
             if (argv['check-external']) {
-              const brokenExternalLinks = await getBrokenExternalLinks(graph);
+              const brokenExternalLinks = await getBrokenExternalLinks(
+                graph,
+                sourceFiles ? { sourceFiles } : undefined
+              );
               for (const result of brokenExternalLinks) {
                 for (const source of result.sources) {
                   const label = result.status