Error Handling and Test Coverage Improvements

.github/workflows/ci.yml

@@ -140,7 +140,7 @@ jobs:
         node-version: ${{ matrix.node-version }}
     - run: npm ci
     - run: npm run build
-    - run: node bin/repomix
+    - run: node bin/repomix.cjs
     - name: Upload build artifact
       uses: actions/upload-artifact@v4
       with:

bin/repomix.cjs

@@ -1,7 +1,57 @@
 #!/usr/bin/env node
-'use strict';
+
+const nodeVersion = process.versions.node;
+const [major] = nodeVersion.split('.').map(Number);
+
+const EXIT_CODES = {
+  SUCCESS: 0,
+  ERROR: 1,
+};
+
+if (major < 16) {
+  console.error(`Repomix requires Node.js version 16 or higher. Current version: ${nodeVersion}\n`);
+  process.exit(EXIT_CODES.ERROR);
+}
+
+function setupErrorHandlers() {
+  process.on('uncaughtException', (error) => {
+    console.error('Uncaught Exception:', error);
+    process.exit(EXIT_CODES.ERROR);
+  });
+
+  process.on('unhandledRejection', (reason) => {
+    console.error('Unhandled Promise Rejection:', reason);
+    process.exit(EXIT_CODES.ERROR);
+  });
+
+  function shutdown() {
+    process.exit(EXIT_CODES.SUCCESS);
+  }
+
+  process.on('SIGINT', () => {
+    console.log('\nReceived SIGINT. Shutting down...');
+    shutdown();
+  });
+  process.on('SIGTERM', shutdown);
+}
 
 (async () => {
-  const { run } = await import('../lib/cli/cliRun.js');
-  run();
+  try {
+    setupErrorHandlers();
+
+    const { run } = await import('../lib/cli/cliRun.js');
+    await run();
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error('Fatal Error:', {
+        name: error.name,
+        message: error.message,
+        stack: error.stack,
+      });
+    } else {
+      console.error('Fatal Error:', error);
+    }
+
+    process.exit(EXIT_CODES.ERROR);
+  }
 })();

biome.json

@@ -2,6 +2,7 @@
   "$schema": "https://biomejs.dev/schemas/1.8.3/schema.json",
   "files": {
     "include": [
+      "./bin/**",
       "./src/**",
       "./tests/**",
       "package.json",

package.json

@@ -19,7 +19,7 @@
     "lint-secretlint": "secretlint \"**/*\" --secretlintignore .gitignore",
     "test": "vitest",
     "test-coverage": "vitest run --coverage",
-    "cli-run": "npm run build && node --trace-warnings bin/repomix",
+    "cli-run": "npm run build && node --trace-warnings bin/repomix.cjs",
     "npm-publish": "npm run lint && npm run test-coverage && npm run build && npm publish",
     "npm-release-patch": "npm version patch && npm run npm-publish",
     "npm-release-minor": "npm version minor && npm run npm-publish",

src/cli/actions/initAction.ts

@@ -38,7 +38,7 @@ export const runInitAction = async (rootDir: string, isGlobal: boolean): Promise
   }
 };
 
-export async function createConfigFile(rootDir: string, isGlobal: boolean): Promise<boolean> {
+export const createConfigFile = async (rootDir: string, isGlobal: boolean): Promise<boolean> => {
   const configPath = path.resolve(isGlobal ? getGlobalDirectory() : rootDir, 'repomix.config.json');
 
   const isCreateConfig = await prompts.confirm({
@@ -121,9 +121,9 @@ export async function createConfigFile(rootDir: string, isGlobal: boolean): Prom
   );
 
   return true;
-}
+};
 
-export async function createIgnoreFile(rootDir: string, isGlobal: boolean): Promise<boolean> {
+export const createIgnoreFile = async (rootDir: string, isGlobal: boolean): Promise<boolean> => {
   if (isGlobal) {
     prompts.log.info(`Skipping ${pc.green('.repomixignore')} file creation for global configuration.`);
     return false;
@@ -173,4 +173,4 @@ export async function createIgnoreFile(rootDir: string, isGlobal: boolean): Prom
   );
 
   return true;
-}
+};

src/cli/actions/remoteAction.ts

@@ -18,21 +18,28 @@ export const runRemoteAction = async (repoUrl: string, options: CliOptions): Pro
     throw new RepomixError('Git is not installed or not in the system PATH.');
   }
 
-  const formattedUrl = formatGitUrl(repoUrl);
-  const tempDir = await createTempDirectory();
   const spinner = new Spinner('Cloning repository...');
 
+  const tempDirPath = await createTempDirectory();
+
   try {
     spinner.start();
-    await cloneRepository(formattedUrl, tempDir);
+
+    // Clone the repository
+    await cloneRepository(formatGitUrl(repoUrl), tempDirPath);
+
     spinner.succeed('Repository cloned successfully!');
     logger.log('');
 
-    const result = await runDefaultAction(tempDir, tempDir, options);
-    await copyOutputToCurrentDirectory(tempDir, process.cwd(), result.config.output.filePath);
+    // Run the default action on the cloned repository
+    const result = await runDefaultAction(tempDirPath, tempDirPath, options);
+    await copyOutputToCurrentDirectory(tempDirPath, process.cwd(), result.config.output.filePath);
+  } catch (error) {
+    spinner.fail('Error during repository cloning. cleanup...');
+    throw error;
   } finally {
-    // Clean up the temporary directory
-    await cleanupTempDirectory(tempDir);
+    // Cleanup the temporary directory
+    await cleanupTempDirectory(tempDirPath);
   }
 };
 
@@ -52,13 +59,13 @@ export const formatGitUrl = (url: string): string => {
   return url;
 };
 
-const createTempDirectory = async (): Promise<string> => {
+export const createTempDirectory = async (): Promise<string> => {
   const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'repomix-'));
   logger.trace(`Created temporary directory. (path: ${pc.dim(tempDir)})`);
   return tempDir;
 };
 
-const cloneRepository = async (url: string, directory: string): Promise<void> => {
+export const cloneRepository = async (url: string, directory: string): Promise<void> => {
   logger.log(`Clone repository: ${url} to temporary directory. ${pc.dim(`path: ${directory}`)}`);
   logger.log('');
 
@@ -69,12 +76,12 @@ const cloneRepository = async (url: string, directory: string): Promise<void> =>
   }
 };
 
-const cleanupTempDirectory = async (directory: string): Promise<void> => {
+export const cleanupTempDirectory = async (directory: string): Promise<void> => {
   logger.trace(`Cleaning up temporary directory: ${directory}`);
   await fs.rm(directory, { recursive: true, force: true });
 };
 
-const checkGitInstallation = async (): Promise<boolean> => {
+export const checkGitInstallation = async (): Promise<boolean> => {
   try {
     const result = await execAsync('git --version');
     return !result.stderr;
@@ -84,7 +91,7 @@ const checkGitInstallation = async (): Promise<boolean> => {
   }
 };
 
-const copyOutputToCurrentDirectory = async (
+export const copyOutputToCurrentDirectory = async (
   sourceDir: string,
   targetDir: string,
   outputFileName: string,

src/cli/cliRun.ts

@@ -26,10 +26,8 @@ export interface CliOptions extends OptionValues {
   remote?: string;
 }
 
-export async function run() {
+export const run = async () => {
   try {
-    const version = await getVersion();
-
     program
       .description('Repomix - Pack your repository into a single AI-friendly file')
       .arguments('[directory]')
@@ -52,9 +50,9 @@ export async function run() {
   } catch (error) {
     handleError(error);
   }
-}
+};
 
-const executeAction = async (directory: string, cwd: string, options: CliOptions) => {
+export const executeAction = async (directory: string, cwd: string, options: CliOptions) => {
   logger.setVerbose(options.verbose || false);
 
   if (options.version) {

src/core/file/permissionCheck.ts

@@ -24,7 +24,7 @@ export class PermissionError extends Error {
   }
 }
 
-export async function checkDirectoryPermissions(dirPath: string): Promise<PermissionCheckResult> {
+export const checkDirectoryPermissions = async (dirPath: string): Promise<PermissionCheckResult> => {
   try {
     // First try to read directory contents
     await fs.readdir(dirPath);
@@ -87,9 +87,9 @@ export async function checkDirectoryPermissions(dirPath: string): Promise<Permis
       error: error instanceof Error ? error : new Error(String(error)),
     };
   }
-}
+};
 
-function getMacOSPermissionMessage(dirPath: string, errorCode?: string): string {
+const getMacOSPermissionMessage = (dirPath: string, errorCode?: string): string => {
   if (platform() === 'darwin') {
     return `Permission denied: Cannot access '${dirPath}', error code: ${errorCode}.
 
@@ -109,4 +109,4 @@ If your terminal app is not listed:
   }
 
   return `Permission denied: Cannot access '${dirPath}'`;
-}
+};

tests/cli/actions/remoteAction.test.ts

@@ -1,43 +1,85 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { formatGitUrl } from '../../../src/cli/actions/remoteAction.js';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import path from 'node:path';
+import { beforeEach, describe, expect, test, vi } from 'vitest';
+import {
+  checkGitInstallation,
+  cleanupTempDirectory,
+  copyOutputToCurrentDirectory,
+  createTempDirectory,
+  formatGitUrl,
+  runRemoteAction,
+} from '../../../src/cli/actions/remoteAction.js';
 
-vi.mock('node:fs/promises');
-vi.mock('node:child_process');
-vi.mock('../../../src/cli/actions/defaultAction.js');
-vi.mock('../../../src/shared/logger.js');
+vi.mock('node:fs/promises', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('node:fs/promises')>();
+  return {
+    ...actual,
+    copyFile: vi.fn(),
+  };
+});
+vi.mock('../../../src/shared/logger');
 
-describe('remoteAction', () => {
+describe('remoteAction functions', () => {
   beforeEach(() => {
     vi.resetAllMocks();
   });
 
-  afterEach(() => {
-    vi.restoreAllMocks();
+  describe('runRemoteAction', () => {
+    test('should clone the repository', async () => {
+      vi.mocked(fs.copyFile).mockResolvedValue(undefined);
+      await runRemoteAction('yamadashy/repomix', {});
+    });
+  });
+
+  describe('checkGitInstallation Integration', () => {
+    test('should detect git installation in real environment', async () => {
+      const result = await checkGitInstallation();
+      expect(result).toBe(true);
+    });
   });
 
   describe('formatGitUrl', () => {
-    it('should format GitHub shorthand correctly', () => {
+    test('should convert GitHub shorthand to full URL', () => {
       expect(formatGitUrl('user/repo')).toBe('https://github.com/user/repo.git');
       expect(formatGitUrl('user-name/repo-name')).toBe('https://github.com/user-name/repo-name.git');
       expect(formatGitUrl('user_name/repo_name')).toBe('https://github.com/user_name/repo_name.git');
     });
 
-    it('should add .git to HTTPS URLs if missing', () => {
+    test('should handle HTTPS URLs', () => {
       expect(formatGitUrl('https://github.com/user/repo')).toBe('https://github.com/user/repo.git');
+      expect(formatGitUrl('https://github.com/user/repo.git')).toBe('https://github.com/user/repo.git');
     });
 
-    it('should not modify URLs that are already correctly formatted', () => {
-      expect(formatGitUrl('https://github.com/user/repo.git')).toBe('https://github.com/user/repo.git');
-      expect(formatGitUrl('git@github.com:user/repo.git')).toBe('git@github.com:user/repo.git');
+    test('should not modify SSH URLs', () => {
+      const sshUrl = 'git@github.com:user/repo.git';
+      expect(formatGitUrl(sshUrl)).toBe(sshUrl);
     });
+  });
+
+  describe('copyOutputToCurrentDirectory', () => {
+    test('should copy output file', async () => {
+      const sourceDir = '/source/dir';
+      const targetDir = '/target/dir';
+      const fileName = 'output.txt';
+
+      vi.mocked(fs.copyFile).mockResolvedValue();
 
-    it('should not modify SSH URLs', () => {
-      expect(formatGitUrl('git@github.com:user/repo.git')).toBe('git@github.com:user/repo.git');
+      await copyOutputToCurrentDirectory(sourceDir, targetDir, fileName);
+
+      expect(fs.copyFile).toHaveBeenCalledWith(path.join(sourceDir, fileName), path.join(targetDir, fileName));
     });
 
-    it('should not modify URLs from other Git hosting services', () => {
-      expect(formatGitUrl('https://gitlab.com/user/repo.git')).toBe('https://gitlab.com/user/repo.git');
-      expect(formatGitUrl('https://bitbucket.org/user/repo.git')).toBe('https://bitbucket.org/user/repo.git');
+    test('should throw error when copy fails', async () => {
+      const sourceDir = '/source/dir';
+      const targetDir = '/target/dir';
+      const fileName = 'output.txt';
+
+      vi.mocked(fs.copyFile).mockRejectedValue(new Error('Permission denied'));
+
+      await expect(copyOutputToCurrentDirectory(sourceDir, targetDir, fileName)).rejects.toThrow(
+        'Failed to copy output file',
+      );
     });
   });
 });