@mintlify/cli 4.0.1122 → 4.0.1124

package/bin/cli.js

@@ -33,7 +33,6 @@ import { scoreHandler } from './score/index.js';
 import { status, getCliSubdomains } from './status.js';
 import { trackTelemetryPreferenceChange } from './telemetry/track.js';
 import { update } from './update.js';
-import { addWorkflow } from './workflow.js';
 export const cli = ({ packageName = 'mint' }) => {
     const telemetryMiddleware = createTelemetryMiddleware();
     render(_jsx(Logs, {}));
@@ -400,16 +399,6 @@ export const cli = ({ packageName = 'mint' }) => {
             addLog(_jsx(ErrorLog, { message: error instanceof Error ? error.message : 'error occurred' }));
             yield terminate(1);
         }
-    }))
-        .command('workflow', 'Add a workflow to your documentation repository', () => undefined, () => __awaiter(void 0, void 0, void 0, function* () {
-        try {
-            yield addWorkflow();
-            yield terminate(0);
-        }
-        catch (error) {
-            addLog(_jsx(ErrorLog, { message: error instanceof Error ? error.message : 'error occurred' }));
-            yield terminate(1);
-        }
     }))
         .command('analytics', 'View analytics for your documentation', analyticsBuilder)
         .command('score <url>', 'Run agent readiness checks on a docs site', (yargs) => yargs

package/bin/score/client.js

@@ -9,13 +9,28 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { authenticatedFetch } from '../authenticatedFetch.js';
 import { API_URL } from '../constants.js';
-export function getScore(url) {
+export function resolveScoreForUrl(url) {
     return __awaiter(this, void 0, void 0, function* () {
         const endpoint = new URL(`${API_URL}/api/cli/score`);
         endpoint.searchParams.set('url', url);
         const res = yield authenticatedFetch(endpoint.toString(), {
             headers: { Accept: 'application/json' },
         });
+        if (res.status !== 200 && res.status !== 202) {
+            const body = yield res.text().catch(() => '');
+            throw new Error(`API error (${res.status}): ${body || res.statusText}`);
+        }
+        return res.json();
+    });
+}
+export function fetchScoreBySlug(slug) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const endpoint = new URL(`${API_URL}/api/cli/score/${encodeURIComponent(slug)}`);
+        const res = yield authenticatedFetch(endpoint.toString(), {
+            headers: { Accept: 'application/json' },
+        });
+        if (res.status === 202)
+            return null;
         if (!res.ok) {
             const body = yield res.text().catch(() => '');
             throw new Error(`API error (${res.status}): ${body || res.statusText}`);

package/bin/score/index.js

@@ -13,7 +13,9 @@ import chalk from 'chalk';
 import { Text } from 'ink';
 import { terminate } from '../helpers.js';
 import { trackEvent } from '../telemetry/track.js';
-import { getScore } from './client.js';
+import { fetchScoreBySlug, resolveScoreForUrl } from './client.js';
+const POLL_INTERVAL_MS = 3000;
+const POLL_TIMEOUT_MS = 120000;
 function resolveFormat(argv) {
     if (argv.format === 'table' || argv.format === 'plain' || argv.format === 'json')
         return argv.format;
@@ -49,6 +51,18 @@ function renderPlain(checks, prefix = '') {
     }
     return lines;
 }
+function renderTable(score, opts) {
+    const scoreColor = score.overallScore >= 70 ? 'green' : score.overallScore >= 40 ? 'yellow' : 'red';
+    const header = (opts === null || opts === void 0 ? void 0 : opts.stale)
+        ? chalk.bold(`\nAgent Readiness Score — ${score.canonicalUrl}`) +
+            chalk.dim(` (last run ${new Date(score.computedAt).toLocaleString()})\n`)
+        : chalk.bold(`\nAgent Readiness Score — ${score.canonicalUrl}\n`);
+    const lines = [header];
+    lines.push(`  Score: ${chalk[scoreColor].bold(`${score.overallScore}%`)}\n`);
+    lines.push(chalk.bold('  Checks'));
+    lines.push(...renderChecks(score.checks));
+    return lines.join('\n');
+}
 function output(format, text) {
     if (format === 'table') {
         addLog(_jsx(Text, { children: text }));
@@ -57,37 +71,88 @@ function output(format, text) {
         process.stdout.write(text + '\n');
     }
 }
+function sleep(ms) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    });
+}
+function pollForScore(slug, afterIso, onAttempt) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const deadline = Date.now() + POLL_TIMEOUT_MS;
+        while (Date.now() < deadline) {
+            yield sleep(POLL_INTERVAL_MS);
+            onAttempt === null || onAttempt === void 0 ? void 0 : onAttempt();
+            const score = yield fetchScoreBySlug(slug);
+            if (!score)
+                continue;
+            if (afterIso === null)
+                return score;
+            if (new Date(score.computedAt).getTime() > new Date(afterIso).getTime())
+                return score;
+        }
+        throw new Error(`Score did not complete within ${POLL_TIMEOUT_MS / 1000}s`);
+    });
+}
 export const scoreHandler = (argv) => __awaiter(void 0, void 0, void 0, function* () {
     const format = resolveFormat(argv);
     try {
         if (format === 'table')
-            addLog(_jsx(SpinnerLog, { message: "Running agent readiness checks..." }));
-        const data = yield getScore(argv.url);
+            addLog(_jsx(SpinnerLog, { message: "Checking agent readiness..." }));
+        const resolved = yield resolveScoreForUrl(argv.url);
+        let final;
+        if (resolved.status === 'ready') {
+            const score = yield fetchScoreBySlug(resolved.slug);
+            if (format === 'table')
+                removeLastLog();
+            if (!score)
+                throw new Error('Score was unexpectedly unavailable');
+            final = score;
+        }
+        else if (resolved.status === 'stale_refresh_queued') {
+            const stale = yield fetchScoreBySlug(resolved.slug);
+            if (format === 'table')
+                removeLastLog();
+            if (!stale)
+                throw new Error('Stale score was unexpectedly unavailable');
+            if (format === 'table') {
+                output('table', renderTable(stale, { stale: true }));
+                addLog(_jsx(SpinnerLog, { message: "Refreshing score in the background..." }));
+            }
+            else {
+                process.stderr.write('Refreshing score in the background...\n');
+            }
+            final = yield pollForScore(resolved.slug, stale.computedAt);
+            if (format === 'table')
+                removeLastLog();
+        }
+        else {
+            if (format === 'table') {
+                removeLastLog();
+                addLog(_jsx(SpinnerLog, { message: "Queued a new scoring run. Waiting for first result..." }));
+            }
+            else {
+                process.stderr.write('Queued a new scoring run. Waiting for first result...\n');
+            }
+            final = yield pollForScore(resolved.slug, null);
+            if (format === 'table')
+                removeLastLog();
+        }
         void trackEvent('cli.score.executed', {
             url: argv.url,
-            score: data.overallScore,
+            score: final.overallScore,
             format,
+            status: resolved.status,
         });
-        if (format === 'table')
-            removeLastLog();
         if (format === 'json') {
-            output(format, JSON.stringify(data, null, 2));
-            yield terminate(0);
-            return;
+            output(format, JSON.stringify(final, null, 2));
         }
-        if (format === 'plain') {
-            const lines = [`SCORE\t${data.overallScore}`, ...renderPlain(data.checks)];
+        else if (format === 'plain') {
+            const lines = [`SCORE\t${final.overallScore}`, ...renderPlain(final.checks)];
             output(format, lines.join('\n'));
-            yield terminate(0);
-            return;
         }
-        const scoreColor = data.overallScore >= 70 ? 'green' : data.overallScore >= 40 ? 'yellow' : 'red';
-        const lines = [];
-        lines.push(chalk.bold(`\nAgent Readiness Score — ${data.url}\n`));
-        lines.push(`  Score: ${chalk[scoreColor].bold(`${data.overallScore}%`)}\n`);
-        lines.push(chalk.bold('  Checks'));
-        lines.push(...renderChecks(data.checks));
-        output(format, lines.join('\n'));
+        else {
+            output(format, renderTable(final));
+        }
         yield terminate(0);
     }
     catch (err) {