@gguf/coder 0.3.1 → 0.3.2

package/source/tools/read-file.spec.tsx

@@ -1,801 +0,0 @@
-import {mkdirSync, rmSync, writeFileSync} from 'node:fs';
-import {join} from 'node:path';
-import test from 'ava';
-import {render} from 'ink-testing-library';
-import React from 'react';
-import {themes} from '../config/themes';
-import {ThemeContext} from '../hooks/useTheme';
-import {readFileTool} from './read-file';
-
-// ============================================================================
-// Test Helpers
-// ============================================================================
-
-console.log(`\nread-file.spec.tsx – ${React.version}`);
-
-// Create a mock theme provider for tests
-function TestThemeProvider({children}: {children: React.ReactNode}) {
-	const themeContextValue = {
-		currentTheme: 'tokyo-night' as const,
-		colors: themes['tokyo-night'].colors,
-		setCurrentTheme: () => {},
-	};
-
-	return (
-		<ThemeContext.Provider value={themeContextValue}>
-			{children}
-		</ThemeContext.Provider>
-	);
-}
-
-// ============================================================================
-// Tests for ReadFileFormatter Component Rendering
-// ============================================================================
-
-test('ReadFileFormatter renders with path', async t => {
-	const testDir = join(process.cwd(), 'test-read-formatter-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'test.ts'), 'const x = 1;');
-
-		const formatter = readFileTool.formatter;
-		if (!formatter) {
-			t.fail('Formatter is not defined');
-			return;
-		}
-
-		const element = await formatter(
-			{path: join(testDir, 'test.ts')},
-			'   1: const x = 1;',
-		);
-		const {lastFrame} = render(
-			<TestThemeProvider>{element}</TestThemeProvider>,
-		);
-
-		const output = lastFrame();
-		t.truthy(output);
-		t.regex(output!, /read_file/);
-		t.regex(output!, /test\.ts/);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test('ReadFileFormatter shows metadata only indicator', async t => {
-	const testDir = join(process.cwd(), 'test-read-metadata-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		const content = 'line\n'.repeat(400); // Over 300 lines
-		writeFileSync(join(testDir, 'large.ts'), content);
-
-		const formatter = readFileTool.formatter;
-		if (!formatter) {
-			t.fail('Formatter is not defined');
-			return;
-		}
-
-		const element = await formatter(
-			{path: join(testDir, 'large.ts')},
-			'File: large.ts\nType: TypeScript\nTotal lines: 400',
-		);
-		const {lastFrame} = render(
-			<TestThemeProvider>{element}</TestThemeProvider>,
-		);
-
-		const output = lastFrame();
-		t.truthy(output);
-		t.regex(output!, /metadata only/);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test('ReadFileFormatter handles error results gracefully', async t => {
-	const formatter = readFileTool.formatter;
-	if (!formatter) {
-		t.fail('Formatter is not defined');
-		return;
-	}
-
-	const element = await formatter(
-		{path: 'nonexistent.ts'},
-		'Error: File not found',
-	);
-	const {lastFrame} = render(element);
-
-	const output = lastFrame();
-	t.is(output, '');
-});
-
-test('ReadFileFormatter displays line range for partial reads', async t => {
-	const testDir = join(process.cwd(), 'test-read-range-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(
-			join(testDir, 'test.ts'),
-			'line1\nline2\nline3\nline4\nline5',
-		);
-
-		const formatter = readFileTool.formatter;
-		if (!formatter) {
-			t.fail('Formatter is not defined');
-			return;
-		}
-
-		const element = await formatter(
-			{path: join(testDir, 'test.ts'), start_line: 2, end_line: 4},
-			'   2: line2\n   3: line3\n   4: line4',
-		);
-		const {lastFrame} = render(
-			<TestThemeProvider>{element}</TestThemeProvider>,
-		);
-
-		const output = lastFrame();
-		t.truthy(output);
-		t.regex(output!, /Lines:/);
-		t.regex(output!, /2 - 4/);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-// ============================================================================
-// Tests for read_file Handler - Progressive Disclosure
-// ============================================================================
-
-test.serial(
-	'read_file returns content directly for small files (<300 lines)',
-	async t => {
-		t.timeout(10000);
-		const testDir = join(process.cwd(), 'test-read-small-temp');
-
-		try {
-			mkdirSync(testDir, {recursive: true});
-			const content = 'line\n'.repeat(100);
-			writeFileSync(join(testDir, 'small.ts'), content);
-
-			const result = await readFileTool.tool.execute!(
-				{
-					path: join(testDir, 'small.ts'),
-				},
-				{toolCallId: 'test', messages: []},
-			);
-
-			// Should return content with line numbers, not metadata
-			t.regex(result, /^\s*1:/);
-			t.regex(result, /^\s*100:/m);
-			t.false(result.includes('File:'));
-		} finally {
-			rmSync(testDir, {recursive: true, force: true});
-		}
-	},
-);
-
-test.serial(
-	'read_file returns metadata for files >300 lines without ranges',
-	async t => {
-		t.timeout(10000);
-		const testDir = join(process.cwd(), 'test-read-metadata-only-temp');
-
-		try {
-			mkdirSync(testDir, {recursive: true});
-			const content = 'line\n'.repeat(400);
-			writeFileSync(join(testDir, 'large.ts'), content);
-
-			const result = await readFileTool.tool.execute!(
-				{
-					path: join(testDir, 'large.ts'),
-				},
-				{toolCallId: 'test', messages: []},
-			);
-
-			// Should return metadata, not content
-			t.regex(result, /File:/);
-			t.regex(result, /Type: TypeScript/);
-			t.regex(result, /Total lines: \d+/); // Don't check exact number
-			t.regex(result, /Estimated tokens:/);
-			t.false(result.match(/^\s*1:/m) !== null);
-		} finally {
-			rmSync(testDir, {recursive: true, force: true});
-		}
-	},
-);
-
-test.serial(
-	'read_file returns content for files >300 lines with ranges',
-	async t => {
-		t.timeout(10000);
-		const testDir = join(process.cwd(), 'test-read-large-range-temp');
-
-		try {
-			mkdirSync(testDir, {recursive: true});
-			const content = 'line\n'.repeat(400);
-			writeFileSync(join(testDir, 'large.ts'), content);
-
-			const result = await readFileTool.tool.execute!(
-				{
-					path: join(testDir, 'large.ts'),
-					start_line: 1,
-					end_line: 50,
-				},
-				{toolCallId: 'test', messages: []},
-			);
-
-			// Should return content with line numbers
-			t.regex(result, /^\s*1:/);
-			t.regex(result, /^\s*50:/m);
-			t.false(result.includes('File:'));
-		} finally {
-			rmSync(testDir, {recursive: true, force: true});
-		}
-	},
-);
-
-test.serial(
-	'read_file provides progressive read suggestions for medium files',
-	async t => {
-		t.timeout(10000);
-		const testDir = join(process.cwd(), 'test-read-medium-temp');
-
-		try {
-			mkdirSync(testDir, {recursive: true});
-			const content = 'line\n'.repeat(350);
-			writeFileSync(join(testDir, 'medium.ts'), content);
-
-			const result = await readFileTool.tool.execute!(
-				{
-					path: join(testDir, 'medium.ts'),
-				},
-				{toolCallId: 'test', messages: []},
-			);
-
-			// Should suggest progressive reading
-			t.regex(result, /Medium file/);
-			t.regex(result, /start_line: 1, end_line: 250/);
-			t.regex(result, /start_line: 251/);
-		} finally {
-			rmSync(testDir, {recursive: true, force: true});
-		}
-	},
-);
-
-test.serial('read_file provides chunk suggestions for large files', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-chunks-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		const content = 'line\n'.repeat(1000);
-		writeFileSync(join(testDir, 'large.ts'), content);
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'large.ts'),
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		// Should suggest chunked reading
-		t.regex(result, /Large file/);
-		t.regex(result, /Targeted read/);
-		t.regex(result, /Progressive read/);
-		t.regex(result, /Example chunks/);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-// ============================================================================
-// Tests for read_file Handler - Line Range Reading
-// ============================================================================
-
-test.serial('read_file reads specific line range', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-range-specific-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(
-			join(testDir, 'test.ts'),
-			'line1\nline2\nline3\nline4\nline5',
-		);
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'test.ts'),
-				start_line: 2,
-				end_line: 4,
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		// Should only contain lines 2-4
-		t.regex(result, /^\s*2: line2/m);
-		t.regex(result, /^\s*3: line3/m);
-		t.regex(result, /^\s*4: line4/m);
-		t.false(result.includes('line1'));
-		t.false(result.includes('line5'));
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file handles start_line only', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-start-only-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(
-			join(testDir, 'test.ts'),
-			'line1\nline2\nline3\nline4\nline5',
-		);
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'test.ts'),
-				start_line: 3,
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		// Should read from line 3 to end
-		t.false(result.includes('line1'));
-		t.false(result.includes('line2'));
-		t.regex(result, /^\s*3: line3/m);
-		t.regex(result, /^\s*5: line5/m);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file handles end_line only', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-end-only-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(
-			join(testDir, 'test.ts'),
-			'line1\nline2\nline3\nline4\nline5',
-		);
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'test.ts'),
-				end_line: 3,
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		// Should read from start to line 3
-		t.regex(result, /^\s*1: line1/m);
-		t.regex(result, /^\s*3: line3/m);
-		t.false(result.includes('line4'));
-		t.false(result.includes('line5'));
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file clamps line ranges to file bounds', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-clamp-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'test.ts'), 'line1\nline2\nline3');
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'test.ts'),
-				start_line: 0, // Should clamp to 1
-				end_line: 100, // Should clamp to 3
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		// Should read entire file
-		t.regex(result, /^\s*1: line1/m);
-		t.regex(result, /^\s*3: line3/m);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-// ============================================================================
-// Tests for read_file Handler - File Type Detection
-// ============================================================================
-
-test.serial('read_file detects common file types', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-types-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-
-		const files = {
-			'file.ts': 'TypeScript',
-			'file.tsx': 'TypeScript React',
-			'file.js': 'JavaScript',
-			'file.py': 'Python',
-			'file.go': 'Go',
-			'file.md': 'Markdown',
-			'file.json': 'JSON',
-		};
-
-		for (const [filename, expectedType] of Object.entries(files)) {
-			const content = 'line\n'.repeat(400);
-			writeFileSync(join(testDir, filename), content);
-
-			const result = await readFileTool.tool.execute!(
-				{
-					path: join(testDir, filename),
-				},
-				{toolCallId: 'test', messages: []},
-			);
-
-			t.regex(
-				result,
-				new RegExp(`Type: ${expectedType}`),
-				`Should detect ${expectedType}`,
-			);
-		}
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-// ============================================================================
-// Tests for read_file Validator
-// ============================================================================
-
-test.serial('read_file validator rejects nonexistent files', async t => {
-	t.timeout(10000);
-
-	const result = await readFileTool.validator!({
-		path: '/nonexistent/file.ts',
-	});
-
-	t.false(result.valid);
-	if (!result.valid) {
-		t.regex(result.error, /does not exist/);
-	}
-});
-
-test.serial('read_file validator accepts valid files', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-validate-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'test.ts'), 'content');
-
-		const result = await readFileTool.validator!({
-			path: join(testDir, 'test.ts'),
-		});
-
-		t.true(result.valid);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file validator rejects start_line < 1', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-validate-start-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'test.ts'), 'content');
-
-		const result = await readFileTool.validator!({
-			path: join(testDir, 'test.ts'),
-			start_line: 0,
-		});
-
-		t.false(result.valid);
-		if (!result.valid) {
-			t.regex(result.error, /start_line must be >= 1/);
-		}
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file validator rejects end_line < start_line', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-validate-range-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'test.ts'), 'line1\nline2\nline3');
-
-		const result = await readFileTool.validator!({
-			path: join(testDir, 'test.ts'),
-			start_line: 3,
-			end_line: 1,
-		});
-
-		t.false(result.valid);
-		if (!result.valid) {
-			t.regex(result.error, /end_line must be >= start_line/);
-		}
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file validator rejects end_line > file length', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-validate-length-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'test.ts'), 'line1\nline2\nline3');
-
-		const result = await readFileTool.validator!({
-			path: join(testDir, 'test.ts'),
-			end_line: 100,
-		});
-
-		t.false(result.valid);
-		if (!result.valid) {
-			t.regex(result.error, /exceeds file length/);
-		}
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-// ============================================================================
-// Tests for read_file Handler - Error Handling
-// ============================================================================
-
-test.serial('read_file throws error for nonexistent file', async t => {
-	t.timeout(10000);
-
-	await t.throwsAsync(
-		async () => {
-			await readFileTool.tool.execute!(
-				{
-					path: '/nonexistent/file.ts',
-				},
-				{toolCallId: 'test', messages: []},
-			);
-		},
-		{message: /does not exist/},
-	);
-});
-
-test.serial('read_file throws error for empty files', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-empty-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'empty.ts'), '');
-
-		await t.throwsAsync(
-			async () => {
-				await readFileTool.tool.execute!(
-					{
-						path: join(testDir, 'empty.ts'),
-					},
-					{toolCallId: 'test', messages: []},
-				);
-			},
-			{message: /exists but is empty/},
-		);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-// ============================================================================
-// Edge Cases and Stress Tests
-// ============================================================================
-
-test.serial('read_file handles files with unicode characters', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-unicode-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(
-			join(testDir, 'unicode.ts'),
-			'const greeting = "Hello 世界 🌍";\nconst emoji = "🚀";',
-			'utf-8',
-		);
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'unicode.ts'),
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		t.true(result.includes('世界'));
-		t.true(result.includes('🌍'));
-		t.true(result.includes('🚀'));
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file handles files with very long lines', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-long-lines-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		const longLine = 'a'.repeat(10000);
-		writeFileSync(join(testDir, 'long.ts'), `${longLine}\nshort line`);
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'long.ts'),
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		t.true(result.includes('a'.repeat(100))); // Should include long content
-		t.true(result.includes('short line'));
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file handles files with Windows line endings', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-crlf-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'windows.ts'), 'line1\r\nline2\r\nline3');
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'windows.ts'),
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		// Should handle CRLF properly
-		t.regex(result, /^\s*1:/m);
-		t.regex(result, /^\s*2:/m);
-		t.regex(result, /^\s*3:/m);
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial('read_file handles files with mixed line endings', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-mixed-endings-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		writeFileSync(join(testDir, 'mixed.ts'), 'line1\nline2\r\nline3\n');
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'mixed.ts'),
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		// Should handle mixed line endings
-		t.truthy(result);
-		t.false(result.includes('Error'));
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial(
-	'read_file handles files with special characters in path',
-	async t => {
-		t.timeout(10000);
-		const testDir = join(process.cwd(), 'test-read-special-path-temp');
-
-		try {
-			mkdirSync(testDir, {recursive: true});
-			mkdirSync(join(testDir, 'dir-with-dash'), {recursive: true});
-			writeFileSync(
-				join(testDir, 'dir-with-dash', 'file_with_underscore.ts'),
-				'content',
-			);
-
-			const result = await readFileTool.tool.execute!(
-				{
-					path: join(testDir, 'dir-with-dash', 'file_with_underscore.ts'),
-				},
-				{toolCallId: 'test', messages: []},
-			);
-
-			t.truthy(result);
-			t.true(result.includes('content'));
-		} finally {
-			rmSync(testDir, {recursive: true, force: true});
-		}
-	},
-);
-
-test.serial('read_file handles files without extension', async t => {
-	t.timeout(10000);
-	const testDir = join(process.cwd(), 'test-read-no-ext-temp');
-
-	try {
-		mkdirSync(testDir, {recursive: true});
-		const content = 'line\n'.repeat(400);
-		writeFileSync(join(testDir, 'Makefile'), content);
-
-		const result = await readFileTool.tool.execute!(
-			{
-				path: join(testDir, 'Makefile'),
-			},
-			{toolCallId: 'test', messages: []},
-		);
-
-		// Should still provide metadata
-		t.regex(result, /File: .*Makefile/);
-		t.regex(result, /Total lines: \d+/); // Don't check exact number
-	} finally {
-		rmSync(testDir, {recursive: true, force: true});
-	}
-});
-
-test.serial(
-	'read_file returns formatted line numbers with padding',
-	async t => {
-		t.timeout(10000);
-		const testDir = join(process.cwd(), 'test-read-padding-temp');
-
-		try {
-			mkdirSync(testDir, {recursive: true});
-			writeFileSync(join(testDir, 'test.ts'), 'line1\nline2\nline3');
-
-			const result = await readFileTool.tool.execute!(
-				{
-					path: join(testDir, 'test.ts'),
-				},
-				{toolCallId: 'test', messages: []},
-			);
-
-			// Line numbers should be padded with spaces
-			t.regex(result, /^\s+1: line1/m);
-			t.regex(result, /^\s+2: line2/m);
-			t.regex(result, /^\s+3: line3/m);
-		} finally {
-			rmSync(testDir, {recursive: true, force: true});
-		}
-	},
-);
-
-// ============================================================================
-// Tests for read_file Tool Configuration
-// ============================================================================
-
-test('read_file tool has correct name', t => {
-	t.is(readFileTool.name, 'read_file');
-});
-
-test('read_file tool does not require confirmation', t => {
-	t.false(readFileTool.tool.needsApproval);
-});
-
-test('read_file tool has handler function', t => {
-	t.is(typeof readFileTool.tool.execute, 'function');
-});
-
-test('read_file tool has formatter function', t => {
-	t.is(typeof readFileTool.formatter, 'function');
-});
-
-test('read_file tool has validator function', t => {
-	t.is(typeof readFileTool.validator, 'function');
-});