@mintlify/cli 4.0.1129 → 4.0.1131

package/bin/cli.js

@@ -211,6 +211,11 @@ export const cli = ({ packageName = 'mint' }) => {
         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',
     }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
         yield autoUpgradeIfNeeded();
         addLog(_jsx(SpinnerLog, { message: "checking for broken links..." }));
@@ -250,6 +255,23 @@ export const cli = ({ packageName = 'mint' }) => {
                     }
                 }
             }
+            if (argv['check-redirects']) {
+                const brokenRedirects = graph.getBrokenRedirects();
+                if (brokenRedirects.length > 0) {
+                    const configFilename = yield 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(_jsx(SuccessLog, { message: "no broken links found" }));
@@ -401,18 +423,18 @@ export const cli = ({ packageName = 'mint' }) => {
         }
     }))
         .command('analytics', 'View analytics for your documentation', analyticsBuilder)
-        .command('score <url>', 'Run agent readiness checks on a docs site', (yargs) => yargs
+        .command('score [url]', 'Run agent readiness checks on a docs site', (yargs) => 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'],
         description: 'Output format',
     })
-        .example('mint score docs.example.com', 'Run agent readiness checks'), scoreHandler)
+        .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.
         .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))

package/bin/score/index.js

@@ -11,7 +11,10 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { addLog, ErrorLog, SpinnerLog, removeLastLog } from '@mintlify/previewing';
 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';
 const POLL_INTERVAL_MS = 3000;
@@ -93,12 +96,32 @@ function pollForScore(slug, afterIso, onAttempt) {
         throw new Error(`Score did not complete within ${POLL_TIMEOUT_MS / 1000}s`);
     });
 }
+function resolveDefaultSubdomain() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const fromConfig = getConfigValue('subdomain');
+        if (fromConfig)
+            return fromConfig;
+        const accessToken = yield getAccessToken();
+        if (!accessToken)
+            return undefined;
+        const subdomains = yield getCliSubdomains(accessToken);
+        return subdomains[0];
+    });
+}
 export const scoreHandler = (argv) => __awaiter(void 0, void 0, void 0, function* () {
     const format = resolveFormat(argv);
     try {
+        let url = argv.url;
+        if (!url) {
+            const subdomain = yield 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(_jsx(SpinnerLog, { message: "Checking agent readiness..." }));
-        const resolved = yield resolveScoreForUrl(argv.url);
+        const resolved = yield resolveScoreForUrl(url);
         let final;
         if (resolved.status === 'ready') {
             const score = yield fetchScoreBySlug(resolved.slug);
@@ -138,7 +161,7 @@ export const scoreHandler = (argv) => __awaiter(void 0, void 0, void 0, function
                 removeLastLog();
         }
         void trackEvent('cli.score.executed', {
-            url: argv.url,
+            url,
             score: final.overallScore,
             format,
             status: resolved.status,