@mintlify/cli 4.0.1465 → 4.0.1467

package/src/mintTest.tsx

@@ -4,16 +4,22 @@ import {
   DEFAULT_COMMAND_TIMEOUT_MS,
   DEFAULT_CONCURRENCY,
   clearRunSave,
+  countReport,
   discoverCodeBlocks,
+  loadLatestTestRun,
   loadRunSave,
   runCodeTests,
   type RunSave,
 } from './agent-harness/index.js';
+import { API_URL } from './constants.js';
 import { CMD_EXEC_PATH, findDocsRoot, isAI, terminate } from './helpers.js';
 import { getAccessToken } from './keyring.js';
 import { fileInNavPaths, loadDocsNavScope } from './mintTestNav.js';
-import { countReport, formatDuration, runMintTestUi } from './mintTestUi.js';
-import { getCliStatus } from './status.js';
+import { firstLine, taskProblemLabel } from './mintTestText.js';
+import { formatDuration, runMintTestUi } from './mintTestUi.js';
+import { fetchCliStatus } from './status.js';
+
+const ALLOWED_ORGS = new Set(['mintlify', 'mintlify internal']);
 
 export async function mintTestHandler(): Promise<void> {
   try {
@@ -23,10 +29,21 @@ export async function mintTestHandler(): Promise<void> {
       await terminate(1);
       return;
     }
-    const cliStatus = await getCliStatus(accessToken);
-    const orgName = cliStatus?.org.name.toLowerCase();
-    if (orgName !== 'mintlify' && orgName !== 'mintlify internal') {
-      process.stderr.write('mint test is not available for your organization.\n');
+    const cliStatus = await fetchCliStatus();
+    if (!cliStatus.ok) {
+      const message =
+        cliStatus.reason === 'unauthenticated'
+          ? 'your session has expired. Run `mint login` to authenticate.'
+          : cliStatus.reason === 'unreachable'
+            ? `could not reach Mintlify at ${API_URL}${cliStatus.detail ? ` (${cliStatus.detail})` : ''}.`
+            : 'unexpected response from Mintlify. Please try again.';
+      process.stderr.write(`${message}\n`);
+      await terminate(1);
+      return;
+    }
+    const orgName = cliStatus.status.org.name;
+    if (!ALLOWED_ORGS.has(orgName.toLowerCase())) {
+      process.stderr.write(`mint test is not available for your organization (${orgName}).\n`);
       await terminate(1);
       return;
     }
@@ -46,7 +63,6 @@ export async function mintTestHandler(): Promise<void> {
     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: RunSave | null = await loadRunSave(outputDirectory);
@@ -60,6 +76,7 @@ export async function mintTestHandler(): Promise<void> {
         save = { ...save, selectedFiles };
       }
     }
+    const lastReport = await loadLatestTestRun(docsRoot);
 
     if (interactive) {
       const exitCode = await runMintTestUi({
@@ -67,8 +84,8 @@ export async function mintTestHandler(): Promise<void> {
         docsRoot,
         pages,
         autoSelectedFiles,
-        totalPages,
         save,
+        lastReport,
       });
       await terminate(exitCode);
       return;
@@ -93,6 +110,15 @@ export async function mintTestHandler(): Promise<void> {
     );
     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`);
     await terminate(report.status === 'passed' ? 0 : 1);
   } catch (error) {
     process.stderr.write(

package/src/mintTestFilePreview.ts

@@ -0,0 +1,32 @@
+import fs from 'node:fs/promises';
+
+export const PREVIEW_BYTE_LIMIT = 64 * 1024;
+
+export type FilePreview = { binary: true } | { binary: false; text: string; truncated: boolean };
+
+export async function readFilePreview(filePath: string): Promise<FilePreview> {
+  const buffer = new Uint8Array(PREVIEW_BYTE_LIMIT + 1);
+  const file = await fs.open(filePath, 'r');
+  let bytesRead = 0;
+
+  try {
+    while (bytesRead < buffer.length) {
+      const result = await file.read(buffer, bytesRead, buffer.length - bytesRead, bytesRead);
+      if (result.bytesRead === 0) break;
+      bytesRead += result.bytesRead;
+    }
+  } finally {
+    await 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/src/mintTestText.ts

@@ -0,0 +1,35 @@
+export interface FooterSegment {
+  key: string;
+  action: string;
+}
+
+/**
+ * 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: string): FooterSegment[] {
+  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: string | undefined, maxLength = 160): string {
+  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: 'failed' | 'agent_error'): string {
+  return status === 'agent_error' ? 'test could not be generated' : 'tests failed';
+}