@mintlify/cli 4.0.1410 → 4.0.1411

package/bin/deslop/client.js

@@ -1,74 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { authenticatedFetch } from '../authenticatedFetch.js';
-import { API_URL } from '../constants.js';
-const DEFAULT_CONCURRENCY = 4;
-// Errors that apply to the whole batch (out of credits, service down) rather
-// than a single page — hitting one means the rest will fail identically.
-class DeslopAbortError extends Error {
-}
-export function checkPage(subdomain, pagePath, content) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const endpoint = new URL(`${API_URL}/api/cli/deslop`);
-        endpoint.searchParams.set('subdomain', subdomain);
-        const res = yield authenticatedFetch(endpoint.toString(), {
-            method: 'POST',
-            headers: { Accept: 'application/json', 'Content-Type': 'application/json' },
-            body: JSON.stringify({ path: pagePath, content }),
-        });
-        if (res.status === 402) {
-            throw new DeslopAbortError('Out of AI credits — upgrade or top up in the Mintlify dashboard.');
-        }
-        if (res.status === 503) {
-            throw new DeslopAbortError('Deslop is temporarily unavailable, try again shortly.');
-        }
-        if (!res.ok) {
-            const body = yield res.text().catch(() => '');
-            throw new Error(`API error (${res.status}): ${body || res.statusText}`);
-        }
-        return res.json();
-    });
-}
-export function checkPages(subdomain_1, pages_1) {
-    return __awaiter(this, arguments, void 0, function* (subdomain, pages, concurrency = DEFAULT_CONCURRENCY) {
-        const results = new Array(pages.length);
-        let next = 0;
-        let aborted = false;
-        const worker = () => __awaiter(this, void 0, void 0, function* () {
-            while (next < pages.length && !aborted) {
-                const index = next++;
-                const page = pages[index];
-                try {
-                    const response = yield checkPage(subdomain, page.path, page.content);
-                    results[index] = { file: page.path, response };
-                }
-                catch (err) {
-                    results[index] = {
-                        file: page.path,
-                        error: err instanceof Error ? err.message : 'unknown error',
-                    };
-                    if (err instanceof DeslopAbortError)
-                        aborted = true;
-                }
-            }
-        });
-        yield Promise.all(Array.from({ length: Math.min(concurrency, pages.length) }, worker));
-        // Pages left unprocessed because the batch was aborted after a global failure.
-        for (let index = 0; index < pages.length; index++) {
-            if (!results[index]) {
-                results[index] = {
-                    file: pages[index].path,
-                    error: 'Not checked — stopped after a credits or availability error.',
-                };
-            }
-        }
-        return results;
-    });
-}

package/bin/deslop/index.js

@@ -1,242 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-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 fs from 'node:fs/promises';
-import path from 'node:path';
-import { CMD_EXEC_PATH, terminate } from '../helpers.js';
-import { trackEvent } from '../telemetry/track.js';
-import { checkPages } from './client.js';
-import { resolveChangedFiles, resolveExplicitFiles } from './resolveFiles.js';
-import { normalizeWhitespace, summarizeWhitespace } from './whitespace.js';
-function fixWhitespacePass(files, apply) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const changes = [];
-        for (const file of files) {
-            const fullPath = path.join(CMD_EXEC_PATH, file);
-            const content = yield fs.readFile(fullPath, 'utf-8');
-            const report = normalizeWhitespace(content);
-            const summary = summarizeWhitespace(report.counts);
-            if (!report.changed || !summary)
-                continue;
-            if (apply)
-                yield fs.writeFile(fullPath, report.fixed);
-            changes.push({ file, summary });
-        }
-        return changes;
-    });
-}
-const identity = (text) => text;
-const colorPalette = { green: chalk.green, red: chalk.red, dim: chalk.dim };
-const plainPalette = { green: identity, red: identity, dim: identity };
-function resolveFormat(argv) {
-    if (argv.format === 'table' || argv.format === 'plain' || argv.format === 'json')
-        return argv.format;
-    return 'table';
-}
-function output(format, text) {
-    if (format === 'table') {
-        addLog(_jsx(Text, { children: text }));
-    }
-    else {
-        process.stdout.write(text + '\n');
-    }
-}
-function requireSubdomain(subdomain) {
-    if (!subdomain) {
-        throw new Error('No subdomain set. Pass --subdomain, or run `mint config set subdomain <name>`.');
-    }
-    return subdomain;
-}
-function flaggedFraction(response) {
-    return response.fractionAi + response.fractionAiAssisted;
-}
-// A fully-human page (fraction 0) never fails, even at --threshold 0.
-function isFailing(fraction, threshold) {
-    return fraction > 0 && fraction >= threshold;
-}
-function truncateText(text, max = 100) {
-    const flat = text.replace(/\s+/g, ' ').trim();
-    return flat.length > max ? `${flat.slice(0, max)}…` : flat;
-}
-function renderResult(result, threshold, palette) {
-    var _a;
-    if ('error' in result) {
-        return [`${palette.red('✗')} ${result.file} — ${palette.red(result.error)}`];
-    }
-    const response = result.response;
-    if (response.skipped !== null) {
-        return [`${palette.dim('○')} ${result.file} — ${palette.dim(`skipped (${response.skipped})`)}`];
-    }
-    const fraction = flaggedFraction(response);
-    const failing = isFailing(fraction, threshold);
-    const icon = failing ? palette.red('✗') : palette.green('✓');
-    const percent = Math.round(fraction * 100);
-    const lines = [`${icon} ${result.file} — ${response.predictionShort} (${percent}% AI-written)`];
-    if (!failing)
-        return lines;
-    for (const window of response.windows) {
-        lines.push(`  L${window.startLine}–${window.endLine} [${window.label} ${window.aiAssistanceScore.toFixed(2)}]`);
-        lines.push(`  ${palette.dim(truncateText(window.text))}`);
-        for (const rewrite of (_a = window.rewrites) !== null && _a !== void 0 ? _a : []) {
-            lines.push(`    ↻ ${rewrite.text}`);
-            lines.push(`      ${palette.dim(rewrite.rationale)}`);
-        }
-    }
-    return lines;
-}
-function summarize(results, threshold) {
-    const summary = {
-        checked: 0,
-        passed: 0,
-        failed: 0,
-        skipped: 0,
-        creditsCharged: 0,
-        errors: 0,
-    };
-    for (const result of results) {
-        if ('error' in result) {
-            summary.errors += 1;
-            continue;
-        }
-        summary.creditsCharged += result.response.creditsCharged;
-        if (result.response.skipped !== null) {
-            summary.skipped += 1;
-            continue;
-        }
-        summary.checked += 1;
-        if (isFailing(flaggedFraction(result.response), threshold)) {
-            summary.failed += 1;
-        }
-        else {
-            summary.passed += 1;
-        }
-    }
-    return summary;
-}
-function renderSummaryLine(summary, palette) {
-    const parts = [
-        `${summary.checked} checked`,
-        palette.green(`${summary.passed} passed`),
-        summary.failed > 0 ? palette.red(`${summary.failed} failed`) : `${summary.failed} failed`,
-        palette.dim(`${summary.skipped} skipped`),
-        `${summary.creditsCharged} ${summary.creditsCharged === 1 ? 'credit' : 'credits'} used`,
-    ];
-    if (summary.errors > 0) {
-        parts.push(palette.red(`${summary.errors} ${summary.errors === 1 ? 'error' : 'errors'}`));
-    }
-    return parts.join(' · ');
-}
-export const deslopHandler = (argv) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a;
-    const format = resolveFormat(argv);
-    let spinnerAdded = false;
-    const threshold = typeof argv.threshold === 'number' ? argv.threshold : 0.5;
-    try {
-        const subdomain = requireSubdomain(argv.subdomain);
-        const fileArgs = ((_a = argv.files) !== null && _a !== void 0 ? _a : []).map(String).filter(Boolean);
-        const files = fileArgs.length > 0
-            ? yield resolveExplicitFiles(CMD_EXEC_PATH, fileArgs)
-            : yield resolveChangedFiles(CMD_EXEC_PATH);
-        if (files.length === 0) {
-            if (format === 'json') {
-                process.stderr.write('No changed docs pages to check.\n');
-                output(format, JSON.stringify({
-                    threshold,
-                    results: [],
-                    summary: {
-                        checked: 0,
-                        passed: 0,
-                        failed: 0,
-                        skipped: 0,
-                        errors: 0,
-                        creditsCharged: 0,
-                    },
-                }, null, 2));
-            }
-            else {
-                output(format, 'No changed docs pages to check.');
-            }
-            yield terminate(0);
-            return;
-        }
-        const whitespaceChanges = argv.fixWhitespace ? yield fixWhitespacePass(files, true) : [];
-        const progressMessage = `Checking ${files.length} ${files.length === 1 ? 'page' : 'pages'} for AI-sounding prose...`;
-        if (format === 'table') {
-            addLog(_jsx(SpinnerLog, { message: progressMessage }));
-            spinnerAdded = true;
-        }
-        else {
-            process.stderr.write(progressMessage + '\n');
-        }
-        const pages = yield Promise.all(files.map((file) => __awaiter(void 0, void 0, void 0, function* () {
-            return ({
-                path: file,
-                content: yield fs.readFile(path.join(CMD_EXEC_PATH, file), 'utf-8'),
-            });
-        })));
-        const results = yield checkPages(subdomain, pages);
-        if (spinnerAdded) {
-            removeLastLog();
-            spinnerAdded = false;
-        }
-        const summary = summarize(results, threshold);
-        void trackEvent('cli.deslop.executed', {
-            fileCount: files.length,
-            flaggedCount: summary.failed,
-            format,
-        });
-        if (format === 'json') {
-            output(format, JSON.stringify({
-                threshold,
-                results: results.map((result) => 'error' in result ? { path: result.file, error: result.error } : result.response),
-                summary: {
-                    checked: summary.checked,
-                    passed: summary.passed,
-                    failed: summary.failed,
-                    skipped: summary.skipped,
-                    errors: summary.errors,
-                    creditsCharged: summary.creditsCharged,
-                },
-                whitespaceFixed: whitespaceChanges,
-            }, null, 2));
-        }
-        else {
-            const palette = format === 'table' ? colorPalette : plainPalette;
-            const lines = [];
-            for (const change of whitespaceChanges) {
-                lines.push(`${palette.green('⇥')} ${change.file} — whitespace fixed (${change.summary})`);
-            }
-            if (whitespaceChanges.length)
-                lines.push('');
-            for (const result of results) {
-                lines.push(...renderResult(result, threshold, palette));
-            }
-            lines.push('');
-            lines.push(renderSummaryLine(summary, palette));
-            output(format, lines.join('\n'));
-        }
-        yield terminate(summary.failed > 0 || summary.errors > 0 ? 1 : 0);
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : 'unknown error';
-        if (format === 'table') {
-            if (spinnerAdded)
-                removeLastLog();
-            addLog(_jsx(ErrorLog, { message: message }));
-        }
-        else {
-            process.stderr.write(`Error: ${message}\n`);
-        }
-        yield terminate(1);
-    }
-});

package/bin/deslop/types.js

@@ -1 +0,0 @@
-export {};

package/bin/deslop/whitespace.js

@@ -1,144 +0,0 @@
-// Unusual space characters that should read as a normal space.
-const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
-// Zero-width and BOM characters that should be removed outright.
-const ZERO_WIDTH = /[\u200B-\u200D\u2060\uFEFF]/g;
-const FENCE = /^(\s*)(`{3,}|~{3,})/;
-// Splits a line so odd indices are inline-code spans (left untouched).
-const INLINE_CODE = /(`+[^`]*`+)/;
-function isFrontmatterFence(line, index) {
-    return index === 0 && line.trim() === '---';
-}
-/**
- * Normalize prose whitespace in an MDX document without touching the bytes of
- * fenced code blocks or YAML frontmatter, where spacing is significant.
- */
-export function normalizeWhitespace(content) {
-    var _a, _b, _c;
-    const counts = {
-        trailing: 0,
-        blankRuns: 0,
-        unicodeSpaces: 0,
-        zeroWidth: 0,
-        spaces: 0,
-        finalNewline: false,
-    };
-    const lines = content.split('\n');
-    const out = [];
-    const isProtected = [];
-    let inFence = false;
-    let fenceMarker = '';
-    let inFrontmatter = false;
-    const pushProtected = (line) => {
-        out.push(line);
-        isProtected.push(true);
-    };
-    for (const [index, rawLine] of lines.entries()) {
-        if (isFrontmatterFence(rawLine, index)) {
-            inFrontmatter = true;
-            pushProtected(rawLine);
-            continue;
-        }
-        if (inFrontmatter) {
-            pushProtected(rawLine);
-            if (rawLine.trim() === '---')
-                inFrontmatter = false;
-            continue;
-        }
-        const fence = rawLine.match(FENCE);
-        if (fence) {
-            const marker = (_a = fence[2]) !== null && _a !== void 0 ? _a : '';
-            if (!inFence) {
-                inFence = true;
-                fenceMarker = marker;
-            }
-            else if (marker[0] === fenceMarker[0] && marker.length >= fenceMarker.length) {
-                inFence = false;
-            }
-            pushProtected(rawLine);
-            continue;
-        }
-        if (inFence) {
-            pushProtected(rawLine);
-            continue;
-        }
-        let line = rawLine;
-        // Separate a trailing CR so CRLF files still get their trailing whitespace
-        // stripped (and keep the CR so line endings are preserved).
-        const cr = line.endsWith('\r') ? '\r' : '';
-        if (cr)
-            line = line.slice(0, -1);
-        // Apply substitutions only outside inline-code spans (odd split indices),
-        // so backticked code keeps its exact spacing.
-        line = line
-            .split(INLINE_CODE)
-            .map((seg, i) => {
-            if (i % 2 === 1)
-                return seg;
-            const uni = seg.match(UNICODE_SPACES);
-            if (uni)
-                counts.unicodeSpaces += uni.length;
-            seg = seg.replace(UNICODE_SPACES, ' ');
-            const zw = seg.match(ZERO_WIDTH);
-            if (zw)
-                counts.zeroWidth += zw.length;
-            return seg.replace(ZERO_WIDTH, '');
-        })
-            .join('');
-        const trimmed = line.replace(/[ \t]+$/, '');
-        if (trimmed !== line)
-            counts.trailing += 1;
-        line = trimmed;
-        // Collapse runs of internal spaces (outside inline code), preserving leading indentation.
-        const leading = (_c = (_b = line.match(/^[ \t]*/)) === null || _b === void 0 ? void 0 : _b[0]) !== null && _c !== void 0 ? _c : '';
-        const body = line.slice(leading.length);
-        const collapsed = body
-            .split(INLINE_CODE)
-            .map((seg, i) => (i % 2 === 1 ? seg : seg.replace(/ {2,}/g, ' ')))
-            .join('');
-        if (collapsed !== body)
-            counts.spaces += 1;
-        line = leading + collapsed + cr;
-        out.push(line);
-        isProtected.push(false);
-    }
-    // Collapse runs of 2 or more consecutive blank lines down to a single blank
-    // line, but never inside protected regions (code fences, frontmatter).
-    const collapsed = [];
-    let blankRun = 0;
-    for (const [index, line] of out.entries()) {
-        if (!isProtected[index] && line.trim() === '') {
-            blankRun += 1;
-            if (blankRun <= 1)
-                collapsed.push(line);
-            continue;
-        }
-        if (blankRun > 1)
-            counts.blankRuns += 1;
-        blankRun = 0;
-        collapsed.push(line);
-    }
-    if (blankRun > 1)
-        counts.blankRuns += 1;
-    let fixed = collapsed.join('\n').replace(/\n+$/, '');
-    if (content.length > 0) {
-        counts.finalNewline = !content.endsWith('\n') || content.endsWith('\n\n');
-        fixed += '\n';
-    }
-    return { fixed, changed: fixed !== content, counts };
-}
-export function summarizeWhitespace(counts) {
-    const parts = [];
-    if (counts.trailing)
-        parts.push(`${counts.trailing} trailing`);
-    if (counts.blankRuns)
-        parts.push(`${counts.blankRuns} blank-line runs`);
-    if (counts.unicodeSpaces)
-        parts.push(`${counts.unicodeSpaces} unicode spaces`);
-    if (counts.zeroWidth)
-        parts.push(`${counts.zeroWidth} zero-width chars`);
-    if (counts.spaces)
-        parts.push(`${counts.spaces} collapsed spaces`);
-    if (counts.finalNewline)
-        parts.push('final newline');
-    return parts.length ? parts.join(', ') : null;
-}

package/src/deslop/client.ts

@@ -1,77 +0,0 @@
-import { authenticatedFetch } from '../authenticatedFetch.js';
-import { API_URL } from '../constants.js';
-import type { DeslopFileResult, DeslopResponse } from './types.js';
-
-const DEFAULT_CONCURRENCY = 4;
-
-// Errors that apply to the whole batch (out of credits, service down) rather
-// than a single page — hitting one means the rest will fail identically.
-class DeslopAbortError extends Error {}
-
-export async function checkPage(
-  subdomain: string,
-  pagePath: string,
-  content: string
-): Promise<DeslopResponse> {
-  const endpoint = new URL(`${API_URL}/api/cli/deslop`);
-  endpoint.searchParams.set('subdomain', subdomain);
-
-  const res = await authenticatedFetch(endpoint.toString(), {
-    method: 'POST',
-    headers: { Accept: 'application/json', 'Content-Type': 'application/json' },
-    body: JSON.stringify({ path: pagePath, content }),
-  });
-
-  if (res.status === 402) {
-    throw new DeslopAbortError('Out of AI credits — upgrade or top up in the Mintlify dashboard.');
-  }
-  if (res.status === 503) {
-    throw new DeslopAbortError('Deslop is temporarily unavailable, try again shortly.');
-  }
-  if (!res.ok) {
-    const body = await res.text().catch(() => '');
-    throw new Error(`API error (${res.status}): ${body || res.statusText}`);
-  }
-
-  return res.json() as Promise<DeslopResponse>;
-}
-
-export async function checkPages(
-  subdomain: string,
-  pages: { path: string; content: string }[],
-  concurrency: number = DEFAULT_CONCURRENCY
-): Promise<DeslopFileResult[]> {
-  const results = new Array<DeslopFileResult>(pages.length);
-  let next = 0;
-  let aborted = false;
-
-  const worker = async () => {
-    while (next < pages.length && !aborted) {
-      const index = next++;
-      const page = pages[index]!;
-      try {
-        const response = await checkPage(subdomain, page.path, page.content);
-        results[index] = { file: page.path, response };
-      } catch (err) {
-        results[index] = {
-          file: page.path,
-          error: err instanceof Error ? err.message : 'unknown error',
-        };
-        if (err instanceof DeslopAbortError) aborted = true;
-      }
-    }
-  };
-
-  await Promise.all(Array.from({ length: Math.min(concurrency, pages.length) }, worker));
-
-  // Pages left unprocessed because the batch was aborted after a global failure.
-  for (let index = 0; index < pages.length; index++) {
-    if (!results[index]) {
-      results[index] = {
-        file: pages[index]!.path,
-        error: 'Not checked — stopped after a credits or availability error.',
-      };
-    }
-  }
-  return results;
-}