@mintlify/cli 4.0.1655 → 4.0.1656

package/bin/mintTest.js

@@ -1,122 +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 path from 'node:path';
-import { DEFAULT_COMMAND_TIMEOUT_MS, DEFAULT_CONCURRENCY, clearRunSave, countReport, discoverCodeBlocks, loadLatestTestRun, loadRunSave, runCodeTests, } from './agent-harness/index.js';
-import { CMD_EXEC_PATH, findDocsRoot, isAI, terminate } from './helpers.js';
-import { getAccessToken } from './keyring.js';
-import { fileInNavPaths, loadDocsNavScope } from './mintTestNav.js';
-import { trackMintTestGenerationResult, trackMintTestRunCompleted, trackMintTestRunStarted, } from './mintTestTelemetry.js';
-import { firstLine, taskProblemLabel } from './mintTestText.js';
-import { formatDuration, runMintTestUi } from './mintTestUi.js';
-export function mintTestHandler() {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d;
-        try {
-            const accessToken = yield getAccessToken().catch(() => null);
-            if (!accessToken) {
-                process.stderr.write('not logged in. Run `mint login` to authenticate.\n');
-                yield terminate(1);
-                return;
-            }
-            const targetPath = yield findDocsRoot(CMD_EXEC_PATH);
-            const interactive = process.stdin.isTTY === true &&
-                process.stdout.isTTY === true &&
-                !isAI() &&
-                !process.env.CI &&
-                process.env.CLI_TEST_MODE !== 'true';
-            const { docsRoot, pages: discoveredPages } = yield discoverCodeBlocks(targetPath);
-            const scope = yield loadDocsNavScope(docsRoot);
-            const pages = scope
-                ? discoveredPages.filter((page) => fileInNavPaths(page.file, scope.navPaths))
-                : discoveredPages;
-            const autoSelectedFiles = (scope ? pages.filter((page) => fileInNavPaths(page.file, scope.autoSelectedPaths)) : pages).map((page) => page.file);
-            const totalPages = scope ? scope.navPaths.size : pages.length;
-            const outputDirectory = path.join(docsRoot, 'tests', 'mint-test');
-            let save = yield loadRunSave(outputDirectory);
-            if (save) {
-                const known = new Set(pages.map((page) => page.file));
-                const selectedFiles = save.selectedFiles.filter((file) => known.has(file));
-                if (selectedFiles.length === 0) {
-                    yield clearRunSave(outputDirectory);
-                    save = null;
-                }
-                else {
-                    save = Object.assign(Object.assign({}, save), { selectedFiles });
-                }
-            }
-            const lastReport = yield loadLatestTestRun(docsRoot);
-            if (interactive) {
-                const exitCode = yield runMintTestUi({
-                    targetPath,
-                    docsRoot,
-                    pages,
-                    autoSelectedFiles,
-                    totalPages,
-                    save,
-                    lastReport,
-                });
-                yield terminate(exitCode);
-                return;
-            }
-            const agents = (_a = save === null || save === void 0 ? void 0 : save.agents) !== null && _a !== void 0 ? _a : ['claude'];
-            const model = (_b = save === null || save === void 0 ? void 0 : save.model) !== null && _b !== void 0 ? _b : 'claude-opus-4-8';
-            const selectedFiles = (_c = save === null || save === void 0 ? void 0 : save.selectedFiles) !== null && _c !== void 0 ? _c : autoSelectedFiles;
-            const resumed = save !== null;
-            if (save)
-                process.stdout.write(`resuming run ${save.runId}\n`);
-            void trackMintTestRunStarted({
-                mode: 'non_interactive',
-                resumed,
-                agents,
-                model,
-                selectedPageCount: new Set(selectedFiles).size,
-                totalPageCount: totalPages,
-            });
-            const report = yield runCodeTests({
-                path: targetPath,
-                agents,
-                model,
-                selectedFiles,
-                outputDirectory,
-                runId: (_d = save === null || save === void 0 ? void 0 : save.runId) !== null && _d !== void 0 ? _d : null,
-                concurrency: DEFAULT_CONCURRENCY,
-                commandTimeoutMs: DEFAULT_COMMAND_TIMEOUT_MS,
-                signal: new AbortController().signal,
-                onTaskUpdate: () => { },
-                onGenerationResult: (result) => {
-                    void trackMintTestGenerationResult(Object.assign(Object.assign({}, result), { mode: 'non_interactive', resumed }));
-                },
-            });
-            yield trackMintTestRunCompleted(report, {
-                mode: 'non_interactive',
-                resumed,
-                totalPageCount: totalPages,
-            });
-            const counts = countReport(report.tasks);
-            process.stdout.write(`mint test ${report.status}: ${counts.passed} passed, ${counts.failed} failed, ${counts.agentErrors} agent errors\n`);
-            process.stdout.write(`finished in ${formatDuration(report.durationMs)}\n`);
-            process.stdout.write(`report: ${report.reportPath}\n`);
-            for (const task of report.tasks) {
-                if (task.status !== 'failed' && task.status !== 'agent_error')
-                    continue;
-                const reason = firstLine(task.error);
-                process.stdout.write(`  ✗ ${task.file}: ${taskProblemLabel(task.status)}${reason ? ` (${reason})` : ''}\n`);
-                process.stdout.write(`    output: ${task.directory}\n`);
-            }
-            if (report.historyError)
-                process.stderr.write(`warning: ${report.historyError}\n`);
-            yield terminate(report.status === 'passed' ? 0 : 1);
-        }
-        catch (error) {
-            process.stderr.write(`mint test failed: ${error instanceof Error ? error.message : 'unknown error'}\n`);
-            yield terminate(1);
-        }
-    });
-}

package/bin/mintTestFilePreview.js

@@ -1,39 +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 fs from 'node:fs/promises';
-export const PREVIEW_BYTE_LIMIT = 64 * 1024;
-export function readFilePreview(filePath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const buffer = new Uint8Array(PREVIEW_BYTE_LIMIT + 1);
-        const file = yield fs.open(filePath, 'r');
-        let bytesRead = 0;
-        try {
-            while (bytesRead < buffer.length) {
-                const result = yield file.read(buffer, bytesRead, buffer.length - bytesRead, bytesRead);
-                if (result.bytesRead === 0)
-                    break;
-                bytesRead += result.bytesRead;
-            }
-        }
-        finally {
-            yield file.close();
-        }
-        const contents = buffer.subarray(0, bytesRead);
-        if (contents.includes(0))
-            return { binary: true };
-        return {
-            binary: false,
-            text: new TextDecoder()
-                .decode(contents.subarray(0, PREVIEW_BYTE_LIMIT))
-                .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, '�'),
-            truncated: bytesRead > PREVIEW_BYTE_LIMIT,
-        };
-    });
-}

package/bin/mintTestNav.js

@@ -1,35 +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 { getAllPathsInDocsNav } from '@mintlify/common';
-import { getConfigObj } from '@mintlify/prebuild';
-export function loadDocsNavScope(docsRoot) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const config = (yield getConfigObj(docsRoot, 'docs').catch(() => null));
-        const navigation = config === null || config === void 0 ? void 0 : config.navigation;
-        if (!navigation)
-            return null;
-        const navPaths = new Set(getAllPathsInDocsNav(navigation));
-        if (navPaths.size === 0)
-            return null;
-        const firstLanguage = 'languages' in navigation ? navigation.languages[0] : null;
-        const autoSelectedPaths = firstLanguage ? new Set(getAllPathsInDocsNav(firstLanguage)) : navPaths;
-        return { navPaths, autoSelectedPaths };
-    });
-}
-export function navCandidatesForFile(file) {
-    const base = file.replace(/\.mdx?$/i, '');
-    const candidates = [base];
-    if (base.endsWith('/index'))
-        candidates.push(base.slice(0, -'/index'.length));
-    return candidates;
-}
-export function fileInNavPaths(file, paths) {
-    return navCandidatesForFile(file).some((candidate) => paths.has(candidate));
-}

package/bin/mintTestTelemetry.js

@@ -1,63 +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 { countReport, } from './agent-harness/index.js';
-import { trackEvent } from './telemetry/track.js';
-export function trackMintTestRunStarted(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ mode, resumed, agents, model, selectedPageCount, totalPageCount, }) {
-        yield trackEvent('cli.test.started', {
-            mode,
-            resumed,
-            agents,
-            model,
-            selected_page_count: selectedPageCount,
-            total_page_count: totalPageCount,
-        });
-    });
-}
-export function trackMintTestRunCompleted(report_1, _a) {
-    return __awaiter(this, arguments, void 0, function* (report, { mode, resumed, totalPageCount }) {
-        const counts = countReport(report.tasks);
-        const skippedCheckCount = report.tasks.filter((task) => !task.testable && task.status === 'passed').length;
-        const tokenCount = report.tasks.reduce((total, task) => total + task.tokens, 0);
-        const runnableCheckCount = report.tasks.filter((task) => task.testable).length;
-        yield trackEvent('cli.test.completed', {
-            mode,
-            resumed,
-            status: report.status,
-            agents: report.agents,
-            model: report.model,
-            selected_page_count: new Set(report.selectedFiles).size,
-            total_page_count: totalPageCount,
-            total_check_count: report.tasks.length,
-            runnable_check_count: runnableCheckCount,
-            passed_check_count: counts.passed - skippedCheckCount,
-            failed_check_count: counts.failed,
-            skipped_check_count: skippedCheckCount,
-            agent_error_check_count: counts.agentErrors,
-            cancelled_check_count: counts.cancelled,
-            token_count: tokenCount,
-            duration_ms: report.durationMs,
-        });
-    });
-}
-export function trackMintTestGenerationResult(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ status, mode, resumed, agent, model, attemptCount, tokenCount, durationMs, generatedFileCount, }) {
-        yield trackEvent(`cli.test.generation.${status}`, {
-            mode,
-            resumed,
-            agent,
-            model,
-            attempt_count: attemptCount,
-            token_count: tokenCount,
-            duration_ms: durationMs,
-            generated_file_count: generatedFileCount,
-        });
-    });
-}

package/bin/mintTestText.js

@@ -1,31 +0,0 @@
-/**
- * Split a footer hint such as `↑/↓/j/k move · Enter exit` into key/action pairs so the key can
- * be rendered bold and the action plain.
- */
-export function footerSegments(text) {
-    return text
-        .split(' · ')
-        .map((segment) => segment.trim())
-        .filter((segment) => segment.length > 0)
-        .map((segment) => {
-        const split = segment.indexOf(' ');
-        if (split === -1)
-            return { key: segment, action: '' };
-        return { key: segment.slice(0, split), action: segment.slice(split + 1).trim() };
-    });
-}
-/** First non-empty line of a multi-line message, trimmed to fit a terminal row. */
-export function firstLine(text, maxLength = 160) {
-    if (!text)
-        return '';
-    const line = text
-        .split(/\r?\n/)
-        .map((candidate) => candidate.trim())
-        .find((candidate) => candidate.length > 0);
-    if (!line)
-        return '';
-    return line.length > maxLength ? `${line.slice(0, maxLength - 1)}…` : line;
-}
-export function taskProblemLabel(status) {
-    return status === 'agent_error' ? 'test could not be generated' : 'tests failed';
-}

package/bin/mintTestTree.js

@@ -1,94 +0,0 @@
-function buildTree(pages) {
-    var _a;
-    const root = { id: 'dir:', kind: 'directory', label: '.', blockCount: 0, children: [] };
-    const directories = new Map([['', root]]);
-    for (const page of pages) {
-        const parts = page.file.split('/');
-        let parent = root;
-        let directoryPath = '';
-        for (const part of parts.slice(0, -1)) {
-            directoryPath = directoryPath ? `${directoryPath}/${part}` : part;
-            let directory = directories.get(directoryPath);
-            if (!directory) {
-                directory = {
-                    id: `dir:${directoryPath}`,
-                    kind: 'directory',
-                    label: part,
-                    blockCount: 0,
-                    children: [],
-                };
-                directories.set(directoryPath, directory);
-                parent.children.push(directory);
-            }
-            parent = directory;
-        }
-        parent.children.push({
-            id: `file:${page.file}`,
-            kind: 'file',
-            label: (_a = parts[parts.length - 1]) !== null && _a !== void 0 ? _a : page.file,
-            file: page.file,
-            blockCount: page.blockCount,
-            children: [],
-        });
-    }
-    const sumBlocks = (node) => {
-        if (node.kind === 'file')
-            return node.blockCount;
-        node.blockCount = node.children.reduce((total, child) => total + sumBlocks(child), 0);
-        return node.blockCount;
-    };
-    sumBlocks(root);
-    const sortChildren = (node) => {
-        node.children.sort((left, right) => {
-            if (left.kind !== right.kind)
-                return left.kind === 'directory' ? -1 : 1;
-            return left.label.localeCompare(right.label);
-        });
-        for (const child of node.children)
-            sortChildren(child);
-    };
-    sortChildren(root);
-    return root;
-}
-function descendantFiles(node) {
-    if (node.kind === 'file')
-        return node.file ? [node.file] : [];
-    return node.children.flatMap(descendantFiles);
-}
-function selectionState(files, selectedFiles) {
-    if (files.length === 0)
-        return 'none';
-    const selectedCount = files.filter((file) => selectedFiles.has(file)).length;
-    if (selectedCount === 0)
-        return 'none';
-    return selectedCount === files.length ? 'all' : 'some';
-}
-export function visibleScopeRows(pages, expandedDirectories, selectedFiles) {
-    const root = buildTree(pages);
-    const rows = [];
-    const visit = (node, depth) => {
-        const files = descendantFiles(node);
-        const expanded = node.kind === 'directory' ? expandedDirectories.has(node.id) : undefined;
-        rows.push(Object.assign(Object.assign(Object.assign({ id: node.id, kind: node.kind, label: node.label, depth }, (node.file ? { file: node.file } : {})), { blockCount: node.blockCount, selectableFiles: files, selection: selectionState(files, selectedFiles) }), (expanded !== undefined ? { expanded } : {})));
-        if (node.kind === 'directory' && expanded) {
-            for (const child of node.children)
-                visit(child, depth + 1);
-        }
-    };
-    for (const child of root.children)
-        visit(child, 0);
-    return rows;
-}
-export function toggleScopeSelection(selectedFiles, row) {
-    const next = new Set(selectedFiles);
-    if (row.selectableFiles.length === 0)
-        return next;
-    const shouldSelect = row.selectableFiles.some((file) => !next.has(file));
-    for (const file of row.selectableFiles) {
-        if (shouldSelect)
-            next.add(file);
-        else
-            next.delete(file);
-    }
-    return next;
-}