@mintlify/cli 4.0.1129 → 4.0.1131

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1129",
+  "version": "4.0.1131",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -45,11 +45,11 @@
   },
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
-    "@mintlify/common": "1.0.861",
-    "@mintlify/link-rot": "3.0.1038",
-    "@mintlify/prebuild": "1.0.1004",
-    "@mintlify/previewing": "4.0.1065",
-    "@mintlify/validation": "0.1.672",
+    "@mintlify/common": "1.0.862",
+    "@mintlify/link-rot": "3.0.1040",
+    "@mintlify/prebuild": "1.0.1005",
+    "@mintlify/previewing": "4.0.1066",
+    "@mintlify/validation": "0.1.673",
     "adm-zip": "0.5.16",
     "chalk": "5.2.0",
     "color": "4.2.3",
@@ -93,5 +93,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "d4240c6001812a92c13023f1d23d9b1f292be002"
+  "gitHead": "ce2406d3df08c0001f4991ab8559de6a09e13838"
 }

package/src/cli.tsx

@@ -271,6 +271,11 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
               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',
             }),
         async (argv) => {
           await autoUpgradeIfNeeded();
@@ -314,6 +319,25 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
               }
             }
 
+            if (argv['check-redirects']) {
+              const brokenRedirects = graph.getBrokenRedirects();
+              if (brokenRedirects.length > 0) {
+                const configFilename = await fs
+                  .access(path.join(CMD_EXEC_PATH, 'docs.json'))
+                  .then(() => 'docs.json')
+                  .catch(() => 'mint.json');
+                const labels = brokenRedirects.map(
+                  ({ source, destination }) => `${source} → ${destination}`
+                );
+                const existing = brokenLinksByFile[configFilename];
+                if (existing) {
+                  existing.push(...labels);
+                } else {
+                  brokenLinksByFile[configFilename] = labels;
+                }
+              }
+            }
+
             if (Object.keys(brokenLinksByFile).length === 0) {
               clearLogs();
               addLog(<SuccessLog message="no broken links found" />);
@@ -555,21 +579,21 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command('analytics', 'View analytics for your documentation', analyticsBuilder)
       .command(
-        'score <url>',
+        'score [url]',
         'Run agent readiness checks on a docs site',
         (yargs: Argv) =>
           yargs
             .positional('url', {
               type: 'string',
-              demandOption: true,
-              description: 'URL of the docs site to check',
+              description: 'URL of the docs site to check (defaults to your configured subdomain)',
             })
             .option('format', {
               type: 'string',
               choices: ['table', 'plain', 'json'] as const,
               description: 'Output format',
             })
-            .example('mint score docs.example.com', 'Run agent readiness checks'),
+            .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
       )
       // Coming soon commands — visible in help, tracked via telemetry to gauge interest.

package/src/score/index.tsx

@@ -2,7 +2,10 @@ import { addLog, ErrorLog, SpinnerLog, removeLastLog } from '@mintlify/previewin
 import chalk from 'chalk';
 import { Text } from 'ink';
 
+import { getConfigValue } from '../config.js';
 import { terminate } from '../helpers.js';
+import { getAccessToken } from '../keyring.js';
+import { getCliSubdomains } from '../status.js';
 import { trackEvent } from '../telemetry/track.js';
 import { fetchScoreBySlug, resolveScoreForUrl } from './client.js';
 import type { Check, ScoreResponse } from './types.js';
@@ -96,11 +99,30 @@ async function pollForScore(
   throw new Error(`Score did not complete within ${POLL_TIMEOUT_MS / 1000}s`);
 }
 
-export const scoreHandler = async (argv: { url: string; format?: string }) => {
+async function resolveDefaultSubdomain(): Promise<string | undefined> {
+  const fromConfig = getConfigValue('subdomain');
+  if (fromConfig) return fromConfig;
+  const accessToken = await getAccessToken();
+  if (!accessToken) return undefined;
+  const subdomains = await getCliSubdomains(accessToken);
+  return subdomains[0];
+}
+
+export const scoreHandler = async (argv: { url?: string; format?: string }) => {
   const format = resolveFormat(argv);
   try {
+    let url = argv.url;
+    if (!url) {
+      const subdomain = await resolveDefaultSubdomain();
+      if (!subdomain) {
+        throw new Error(
+          'No URL provided and no default subdomain set. Run `mint login` to set one, or pass a URL: `mint score <url>`.'
+        );
+      }
+      url = `${subdomain}.mintlify.app`;
+    }
     if (format === 'table') addLog(<SpinnerLog message="Checking agent readiness..." />);
-    const resolved = await resolveScoreForUrl(argv.url);
+    const resolved = await resolveScoreForUrl(url);
 
     let final: ScoreResponse;
 
@@ -134,7 +156,7 @@ export const scoreHandler = async (argv: { url: string; format?: string }) => {
     }
 
     void trackEvent('cli.score.executed', {
-      url: argv.url,
+      url,
       score: final.overallScore,
       format,
       status: resolved.status,