@mintlify/cli 4.0.1812 → 4.1.1

package/__test__/migrate.test.ts

@@ -1,186 +0,0 @@
-import { isBuiltInComponent } from '@mintlify/common';
-import { addLog } from '@mintlify/previewing';
-import { spawn, type ChildProcess } from 'node:child_process';
-import { EventEmitter } from 'node:events';
-import { readdirSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-import { mockProcessExit } from 'vitest-mock-process';
-
-import { windowsCompatibleSpawnOptions } from '../src/helpers.js';
-import {
-  agentArgs,
-  agents,
-  listMigrationDocs,
-  migrateWithAgent,
-  migrationInstructions,
-} from '../src/migrate.js';
-import { runCommand } from './utils.js';
-
-vi.mock('node:child_process', async (importOriginal) => ({
-  ...(await importOriginal<typeof import('node:child_process')>()),
-  spawn: vi.fn(),
-}));
-vi.mock('@mintlify/previewing', async (importOriginal) => ({
-  ...(await importOriginal<typeof import('@mintlify/previewing')>()),
-  addLog: vi.fn(),
-}));
-
-const spawnMock = vi.mocked(spawn);
-const child = (emit: (child: EventEmitter) => void) => {
-  spawnMock.mockImplementationOnce(() => {
-    const proc = new EventEmitter();
-    setImmediate(() => emit(proc));
-    return proc as ChildProcess;
-  });
-};
-const enoent = (proc: EventEmitter) =>
-  proc.emit('error', Object.assign(new Error('spawn ENOENT'), { code: 'ENOENT' }));
-
-const root = path.join(__dirname, '../migrate');
-const names = (section: string) =>
-  readdirSync(path.join(root, section))
-    .filter((file) => file.endsWith('.md'))
-    .map((file) => file.slice(0, -3));
-const read = (...segments: string[]) => readFileSync(path.join(root, ...segments), 'utf8');
-const docs = [
-  'index.md',
-  ...names('topics').map((name) => `topics/${name}.md`),
-  ...names('sources').map((name) => `sources/${name}.md`),
-];
-const prose = (markdown: string) => markdown.replace(/^(`{3,}).*\n[\s\S]*?^\1\s*$/gm, '');
-
-const template = [
-  '## Detect',
-  '## Get the source',
-  '### From the repo',
-  '### From an export',
-  '### From the live site',
-  '## Config → docs.json',
-  '## Navigation',
-  '## Content conversion',
-  '## Assets',
-  '## URLs and redirects',
-  '## Known gaps',
-];
-
-const components = (text: string) => [...text.matchAll(/<([A-Z][\w.]+)/g)].map(([, name]) => name!);
-const targets = (markdown: string) =>
-  prose(markdown)
-    .split('\n')
-    .flatMap((line) =>
-      line.startsWith('|')
-        ? [line.split('|').slice(1)]
-        : line.split(/[;.] /).map((clause) => clause.split('→'))
-    )
-    .flatMap(([source = '', ...rest]) =>
-      components(rest.join(' ')).filter((name) => !components(source).includes(name))
-    );
-
-const exit = mockProcessExit();
-
-describe('migrate', () => {
-  it('lists topics and sources from disk', () => {
-    expect(listMigrationDocs('topics')).toEqual(names('topics').sort());
-    expect(listMigrationDocs('sources')).toEqual(names('sources').sort());
-    expect(listMigrationDocs('sources')).toContain('nuxt');
-  });
-
-  it('prints the overview with every topic and source', () => {
-    const output = migrationInstructions({});
-    expect(output.startsWith(read('index.md').trimEnd())).toBe(true);
-    expect(output).toContain(`Topics: ${names('topics').sort().join(', ')}.`);
-    expect(output).toContain(`Sources: ${names('sources').sort().join(', ')}.`);
-  });
-
-  it('appends the source guide to the overview', () => {
-    const output = migrationInstructions({ from: 'nuxt' });
-    expect(output.startsWith(read('index.md').trimEnd())).toBe(true);
-    expect(output.endsWith(read('sources', 'nuxt.md'))).toBe(true);
-  });
-
-  it('prints only the topic', () => {
-    expect(migrationInstructions({ topic: 'verify' })).toBe(read('topics', 'verify.md'));
-  });
-
-  it.each(names('sources'))('source %s follows the template', (name) => {
-    const headings = prose(read('sources', `${name}.md`)).match(/^#{1,3} .*/gm) ?? [];
-    expect(headings[0]).toMatch(/^# \S/);
-    expect(headings.slice(1)).toEqual(template);
-  });
-
-  it.each(docs)('%s references only existing topics and sources', (doc) => {
-    for (const [, flag, name] of read(doc).matchAll(/--(topic|from) ([a-z][\w-]*)/g)) {
-      expect(names(flag === 'topic' ? 'topics' : 'sources'), `${doc}: --${flag} ${name}`).toContain(
-        name
-      );
-    }
-  });
-
-  it.each(docs)('%s maps only to Mintlify components', (doc) => {
-    expect(targets(read(doc)).filter((name) => !isBuiltInComponent(name))).toEqual([]);
-  });
-
-  it('rejects unknown values with the valid choices', async () => {
-    const stderr = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
-    await runCommand('migrate', '--from', 'nope').catch(() => undefined);
-    const output = stderr.mock.calls.map(([chunk]) => String(chunk)).join('');
-    expect(output).toContain('nope');
-    expect(output).toContain('nuxt');
-    stderr.mockRestore();
-  });
-
-  it('offers every agent as an --agent choice', async () => {
-    const stderr = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
-    await runCommand('migrate', '--agent', 'nope').catch(() => undefined);
-    const output = stderr.mock.calls.map(([chunk]) => String(chunk)).join('');
-    expect(output).toContain(
-      `Choices: ${Object.keys(agents)
-        .map((name) => `"${name}"`)
-        .join(', ')}`
-    );
-    stderr.mockRestore();
-  });
-
-  const base = 'Migrate a documentation site to Mintlify in the current directory. Run';
-  const plain = `${base} \`mint migrate\` and follow the instructions it prints.`;
-  const nuxt = `${base} \`mint migrate --from nuxt\` and follow the instructions it prints.`;
-
-  it.each([
-    ['claude', [plain], [nuxt]],
-    ['codex', [plain], [nuxt]],
-    ['cursor', [plain], [nuxt]],
-    ['gemini', ['-i', plain], ['-i', nuxt]],
-  ] as const)('%s builds its argv', (name, without, withFrom) => {
-    expect(agentArgs(name)).toEqual(without);
-    expect(agentArgs(name, 'nuxt')).toEqual(withFrom);
-  });
-
-  it('--claude runs claude', async () => {
-    child((proc) => proc.emit('close', 0));
-    await runCommand('migrate', '--claude', '--from', 'nuxt');
-    expect(spawnMock).toHaveBeenCalledWith(
-      'claude',
-      [windowsCompatibleSpawnOptions.shell ? `"${nuxt}"` : nuxt],
-      expect.objectContaining({ stdio: 'inherit' })
-    );
-    expect(exit).toHaveBeenCalledWith(0);
-  });
-
-  it('rejects a missing binary with its install command', async () => {
-    child(enoent);
-    await expect(migrateWithAgent('gemini')).rejects.toThrow(
-      `gemini not found. Install it with: ${agents.gemini.install}`
-    );
-  });
-
-  it('prints the install command and exits nonzero for a missing binary', async () => {
-    child(enoent);
-    await runCommand('migrate', '--agent', 'cursor');
-    expect(vi.mocked(addLog)).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: `cursor-agent not found. Install it with: ${agents.cursor.install}` },
-      })
-    );
-    expect(exit).toHaveBeenCalledWith(1);
-  });
-});

package/__test__/openApiCheck.test.ts

@@ -1,185 +0,0 @@
-import { getOpenApiDocumentFromUrl, isAllowedLocalSchemaUrl, validate } from '@mintlify/common';
-import { addLog } from '@mintlify/previewing';
-import { mockProcessExit } from 'vitest-mock-process';
-
-import { readLocalOpenApiFile } from '../src/helpers.js';
-import { getOpenApiFilenamesFromDocsConfig } from '../src/openApiCheck.js';
-import { mockValidOpenApiDocument, runCommand } from './utils.js';
-
-vi.mock('@mintlify/common', async (importOriginal) => {
-  const mod = await importOriginal<typeof import('@mintlify/common')>();
-  return {
-    ...mod,
-    getOpenApiDocumentFromUrl: vi.fn(),
-    isAllowedLocalSchemaUrl: vi.fn(),
-    validate: vi.fn(),
-  };
-});
-
-vi.mock('@mintlify/prebuild', async (importOriginal) => {
-  const mod = await importOriginal<typeof import('@mintlify/prebuild')>();
-  return {
-    ...mod,
-    getMintIgnore: vi.fn(async () => []),
-    discoverOverlayFiles: vi.fn(async () => []),
-  };
-});
-
-vi.mock('@mintlify/previewing', async (importOriginal) => {
-  const mod = await importOriginal<typeof import('@mintlify/previewing')>();
-  return { ...mod, addLog: vi.fn() };
-});
-
-vi.mock('../src/helpers.js', async (importOriginal) => {
-  const originalModule = await importOriginal<typeof import('../src/helpers.js')>();
-  return {
-    ...originalModule,
-    readLocalOpenApiFile: vi.fn(),
-  };
-});
-
-const addLogSpy = vi.mocked(addLog);
-const processExitMock = mockProcessExit();
-
-describe('getOpenApiFilenamesFromDocsConfig', () => {
-  it('reads api.openapi string', () => {
-    expect(
-      getOpenApiFilenamesFromDocsConfig({
-        api: { openapi: 'https://example.com/openapi.yaml' },
-      })
-    ).toEqual(['https://example.com/openapi.yaml']);
-  });
-
-  it('reads api.openapi array and object source form', () => {
-    expect(
-      getOpenApiFilenamesFromDocsConfig({
-        api: { openapi: ['https://a.com/o.yaml', 'https://b.com/o.yaml'] },
-      })
-    ).toEqual(['https://a.com/o.yaml', 'https://b.com/o.yaml']);
-    expect(
-      getOpenApiFilenamesFromDocsConfig({
-        api: { openapi: { source: 'https://c.com/o.yaml' } },
-      })
-    ).toEqual(['https://c.com/o.yaml']);
-  });
-
-  it('returns empty when api or openapi is missing', () => {
-    expect(getOpenApiFilenamesFromDocsConfig({})).toEqual([]);
-    expect(getOpenApiFilenamesFromDocsConfig({ api: {} })).toEqual([]);
-  });
-});
-
-describe('openApiCheck', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  afterEach(() => {
-    vi.clearAllMocks();
-  });
-
-  const expectDeprecationWarning = () => {
-    expect(addLogSpy).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({
-        props: { message: 'openapi-check is deprecated, use `mintlify validate` instead' },
-      })
-    );
-  };
-
-  it('valid openApi file from url', async () => {
-    vi.mocked(isAllowedLocalSchemaUrl).mockReturnValueOnce(true);
-    vi.mocked(getOpenApiDocumentFromUrl).mockResolvedValueOnce(mockValidOpenApiDocument);
-
-    await runCommand('openapi-check', 'https://petstore3.swagger.io/api/v3/openapi.json');
-
-    expectDeprecationWarning();
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: 'OpenAPI definition is valid.' },
-      })
-    );
-    expect(processExitMock).toHaveBeenCalledWith(0);
-  });
-
-  it('invalid openApi file from url', async () => {
-    vi.mocked(isAllowedLocalSchemaUrl).mockReturnValueOnce(true);
-    vi.mocked(getOpenApiDocumentFromUrl).mockRejectedValueOnce(
-      new Error('Could not parse OpenAPI document.')
-    );
-
-    await runCommand('openapi-check', 'https://petstore3.swagger.io/api/v3/openapi.json');
-
-    expectDeprecationWarning();
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: 'Could not parse OpenAPI document.' },
-      })
-    );
-    expect(processExitMock).toHaveBeenCalledWith(1);
-  });
-
-  it('valid openApi file from localhost', async () => {
-    vi.mocked(isAllowedLocalSchemaUrl).mockReturnValueOnce(true);
-    vi.mocked(getOpenApiDocumentFromUrl).mockResolvedValueOnce(mockValidOpenApiDocument);
-
-    await runCommand('openapi-check', 'http://localhost:3000/openapi.json');
-
-    expectDeprecationWarning();
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: 'OpenAPI definition is valid.' },
-      })
-    );
-    expect(processExitMock).toHaveBeenCalledWith(0);
-  });
-
-  it('invalid openApi file from localhost', async () => {
-    vi.mocked(isAllowedLocalSchemaUrl).mockReturnValueOnce(false);
-
-    await runCommand('openapi-check', 'http://localhost:3000/openapi.json');
-
-    expectDeprecationWarning();
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: 'include the --local-schema flag to check locally hosted OpenAPI files' },
-      })
-    );
-    expect(processExitMock).toHaveBeenCalledWith(0);
-  });
-
-  it('valid openApi file from local file', async () => {
-    vi.mocked(isAllowedLocalSchemaUrl).mockReturnValueOnce(false);
-    vi.mocked(readLocalOpenApiFile).mockResolvedValueOnce(mockValidOpenApiDocument);
-    vi.mocked(validate).mockResolvedValueOnce({
-      valid: true,
-      errors: [],
-    });
-
-    await runCommand('openapi-check', 'test/openapi.yaml');
-
-    expectDeprecationWarning();
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: 'OpenAPI definition is valid.' },
-      })
-    );
-    expect(processExitMock).toHaveBeenCalledWith(0);
-  });
-
-  it('invalid openApi file from local file', async () => {
-    vi.mocked(isAllowedLocalSchemaUrl).mockReturnValueOnce(false);
-    vi.mocked(readLocalOpenApiFile).mockResolvedValueOnce(mockValidOpenApiDocument);
-    vi.mocked(validate).mockRejectedValueOnce(new Error('some schema parsing error'));
-
-    await runCommand('openapi-check', 'test/openapi.yaml');
-
-    expectDeprecationWarning();
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: 'some schema parsing error' },
-      })
-    );
-    expect(processExitMock).toHaveBeenCalledWith(1);
-  });
-});

package/__test__/pathValidation.test.ts

@@ -1,25 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { readLocalOpenApiFile } from '../src/helpers.js';
-
-describe('readLocalOpenApiFile', () => {
-  describe('path traversal prevention', () => {
-    it('rejects path traversal with ../', async () => {
-      await expect(readLocalOpenApiFile('../etc/passwd')).rejects.toThrow(
-        'path: ../etc/passwd is outside the current directory'
-      );
-    });
-
-    it('rejects absolute paths', async () => {
-      await expect(readLocalOpenApiFile('/etc/passwd')).rejects.toThrow(
-        'path: /etc/passwd is outside the current directory'
-      );
-    });
-
-    it('rejects deep path traversal', async () => {
-      await expect(readLocalOpenApiFile('../../secret.yaml')).rejects.toThrow(
-        'path: ../../secret.yaml is outside the current directory'
-      );
-    });
-  });
-});

package/__test__/resolveFiles.test.ts

@@ -1,70 +0,0 @@
-import fs from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
-
-import { resolveExplicitFiles } from '../src/resolveFiles.js';
-
-let baseDir: string;
-
-async function writeFixture(rel: string) {
-  const filePath = path.join(baseDir, rel);
-  await fs.mkdir(path.dirname(filePath), { recursive: true });
-  await fs.writeFile(filePath, '# fixture\n');
-}
-
-beforeEach(async () => {
-  baseDir = await fs.mkdtemp(path.join(os.tmpdir(), 'resolve-files-test-'));
-});
-
-afterEach(async () => {
-  await fs.rm(baseDir, { recursive: true, force: true });
-});
-
-describe('resolveExplicitFiles', () => {
-  it('resolves literal paths', async () => {
-    await writeFixture('docs/a.mdx');
-    await expect(resolveExplicitFiles(baseDir, ['docs/a.mdx'])).resolves.toEqual(['docs/a.mdx']);
-  });
-
-  it('normalizes leading ./', async () => {
-    await writeFixture('docs/a.md');
-    await expect(resolveExplicitFiles(baseDir, ['./docs/a.md'])).resolves.toEqual(['docs/a.md']);
-  });
-
-  it('errors listing paths that matched nothing', async () => {
-    await writeFixture('docs/a.mdx');
-    await expect(
-      resolveExplicitFiles(baseDir, ['docs/a.mdx', 'docs/missing.mdx', 'nope/*.mdx'])
-    ).rejects.toThrow('No matching files for: docs/missing.mdx, nope/*.mdx');
-  });
-
-  it('accepts existing literal paths regardless of extension', async () => {
-    await writeFixture('README.txt');
-    await expect(resolveExplicitFiles(baseDir, ['README.txt'])).resolves.toEqual(['README.txt']);
-  });
-
-  it('rejects a directory passed as a literal path', async () => {
-    await fs.mkdir(path.join(baseDir, 'docs'), { recursive: true });
-    await expect(resolveExplicitFiles(baseDir, ['docs'])).rejects.toThrow('No matching files');
-  });
-
-  it('expands globs recursively and keeps only docs files', async () => {
-    await writeFixture('docs/a.mdx');
-    await writeFixture('docs/nested/deep/b.mdx');
-    await writeFixture('docs/nested/notes.txt');
-    await writeFixture('top.md');
-
-    await expect(resolveExplicitFiles(baseDir, ['docs/**/*.mdx'])).resolves.toEqual([
-      'docs/a.mdx',
-      'docs/nested/deep/b.mdx',
-    ]);
-    await expect(resolveExplicitFiles(baseDir, ['*.md'])).resolves.toEqual(['top.md']);
-  });
-
-  it('dedupes overlapping literal and glob matches', async () => {
-    await writeFixture('docs/a.mdx');
-    await expect(resolveExplicitFiles(baseDir, ['docs/a.mdx', 'docs/*.mdx'])).resolves.toEqual([
-      'docs/a.mdx',
-    ]);
-  });
-});

package/__test__/sessionId.test.ts

@@ -1,46 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-
-const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mint-session-'));
-vi.mock('../src/constants.js', () => ({ CONFIG_DIR: dir }));
-
-const file = path.join(dir, 'telemetry-session.json');
-const now = Date.parse('2026-11-02T12:00:00.000Z');
-const minutes = (n: number) => n * 60 * 1000;
-const load = async () => (await import('../src/telemetry/sessionId.js')).getSessionId;
-const save = (lastSeenAt: number) =>
-  fs.writeFileSync(file, JSON.stringify({ id: 'saved', lastSeenAt }));
-
-beforeEach(() => {
-  vi.resetModules();
-  fs.rmSync(file, { force: true });
-});
-
-describe('getSessionId', () => {
-  it('starts a UUIDv7 session and saves it', async () => {
-    const id = (await load())(now);
-    expect(id).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
-    expect(parseInt(id.replace(/-/g, '').slice(0, 12), 16)).toBe(now);
-    expect(JSON.parse(fs.readFileSync(file, 'utf-8'))).toEqual({ id, lastSeenAt: now });
-  });
-
-  it('resumes a session active in the last 30 minutes', async () => {
-    save(now - minutes(29));
-    expect((await load())(now)).toBe('saved');
-    expect(JSON.parse(fs.readFileSync(file, 'utf-8')).lastSeenAt).toBe(now);
-  });
-
-  it('rotates after 30 minutes idle', async () => {
-    save(now - minutes(31));
-    expect((await load())(now)).not.toBe('saved');
-  });
-
-  it('keeps one id per process and refreshes activity', async () => {
-    const getSessionId = await load();
-    const id = getSessionId(now);
-    expect(getSessionId(now + minutes(60))).toBe(id);
-    expect(JSON.parse(fs.readFileSync(file, 'utf-8')).lastSeenAt).toBe(now + minutes(60));
-  });
-});

package/__test__/signup.test.ts

@@ -1,36 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-import { AUTH_MD_URL, signup } from '../src/signup.js';
-
-vi.mock('../src/helpers.js', async (importOriginal) => ({
-  ...(await importOriginal<typeof import('../src/helpers.js')>()),
-  isAI: () => true,
-}));
-
-afterEach(() => {
-  vi.unstubAllGlobals();
-  vi.restoreAllMocks();
-});
-
-describe('signup for agents', () => {
-  it('prints auth.md instead of starting the email signup', async () => {
-    const request = vi.fn().mockResolvedValue(new Response('# auth.md body'));
-    vi.stubGlobal('fetch', request);
-    const write = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
-
-    await signup({ firstName: 'A', lastName: 'B', company: 'C', email: 'a@example.com' });
-
-    expect(request).toHaveBeenCalledTimes(1);
-    expect(request.mock.calls[0]?.[0]).toBe(AUTH_MD_URL);
-    expect(write).toHaveBeenCalledWith('# auth.md body\n');
-  });
-
-  it('does not print a failed auth.md response', async () => {
-    vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('nope', { status: 502 })));
-    const write = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
-
-    await signup();
-
-    expect(write).not.toHaveBeenCalledWith('nope\n');
-  });
-});

package/__test__/update.test.ts

@@ -1,117 +0,0 @@
-import * as previewing from '@mintlify/previewing';
-
-import {
-  getLatestCliVersion,
-  getVersions,
-  execFileAsync,
-  windowsCompatibleSpawnOptions,
-} from '../src/helpers.js';
-import { update } from '../src/update.js';
-
-vi.mock('@mintlify/previewing', async () => {
-  const originalModule =
-    await vi.importActual<typeof import('@mintlify/previewing')>('@mintlify/previewing');
-  return {
-    ...originalModule,
-    getClientVersion: vi.fn().mockReturnValue('1.0.0'),
-    getLatestClientVersion: vi.fn().mockResolvedValue('2.0.0'),
-    downloadTargetMint: vi.fn().mockResolvedValue(undefined),
-  };
-});
-
-vi.mock('../src/helpers.js', async () => {
-  const originalModule =
-    await vi.importActual<typeof import('../src/helpers.js')>('../src/helpers.js');
-  return {
-    ...originalModule,
-    execFileAsync: vi.fn(),
-    getLatestCliVersion: vi.fn(),
-    getVersions: vi.fn().mockReturnValue({
-      cli: '1.0.0',
-      client: '1.0.0',
-    }),
-  };
-});
-
-const addLogSpy = vi.spyOn(previewing, 'addLog');
-const addErrorLogSpy = vi.spyOn(previewing, 'addErrorLog');
-
-describe('update', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  afterEach(() => {
-    vi.resetAllMocks();
-  });
-
-  it('should update the cli successfully', async () => {
-    vi.mocked(getVersions).mockReturnValue({
-      cli: '1.0.0',
-      client: '1.0.0',
-    });
-    vi.mocked(getLatestCliVersion).mockReturnValue('2.0.0');
-    vi.mocked(execFileAsync).mockResolvedValue({ stdout: '', stderr: '' });
-    vi.mocked(previewing.downloadTargetMint).mockResolvedValue();
-
-    await update({ packageName: 'mintlify' });
-
-    expect(execFileAsync).toHaveBeenCalledWith(
-      'npm',
-      ['install', '-g', 'mintlify@latest', '--silent'],
-      windowsCompatibleSpawnOptions
-    );
-    expect(previewing.downloadTargetMint).toHaveBeenCalledWith({
-      targetVersion: '2.0.0',
-      existingVersion: '1.0.0',
-    });
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: 'updated mintlify to the latest version: 2.0.0' },
-      })
-    );
-  });
-
-  it('should return when already up to date', async () => {
-    vi.mocked(getVersions).mockReturnValue({
-      cli: '1.0.0',
-      client: '1.0.0',
-    });
-    vi.mocked(getLatestCliVersion).mockReturnValue('1.0.0');
-    vi.mocked(previewing.getLatestClientVersion).mockResolvedValue('1.0.0');
-    vi.mocked(previewing.getClientVersion).mockReturnValue('1.0.0');
-
-    await update({ packageName: 'mintlify' });
-
-    expect(execFileAsync).not.toHaveBeenCalled();
-    expect(previewing.downloadTargetMint).not.toHaveBeenCalled();
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({ props: { message: 'already up to date' } })
-    );
-  });
-
-  it('should handle cli update failure', async () => {
-    vi.mocked(getVersions).mockReturnValue({
-      cli: '1.0.0',
-      client: '1.0.0',
-    });
-    vi.mocked(getLatestCliVersion).mockReturnValue('2.0.0');
-    vi.mocked(execFileAsync).mockRejectedValue(new Error('Update failed'));
-
-    await update({ packageName: 'mintlify' });
-
-    expect(addLogSpy).toHaveBeenCalledTimes(2);
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({ props: { message: 'updating...' } })
-    );
-    expect(addLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({ props: { message: 'updating mintlify package...' } })
-    );
-    expect(addErrorLogSpy).toHaveBeenCalledTimes(1);
-    expect(addErrorLogSpy).toHaveBeenCalledWith(
-      expect.objectContaining({
-        props: { message: 'Failed to update mintlify@2.0.0 using npm: Update failed' },
-      })
-    );
-  });
-});