@gguf/coder 0.2.9 → 0.3.1

package/source/commands/export.tsx

@@ -0,0 +1,79 @@
+import path from 'path';
+import {SuccessMessage} from '@/components/message-box';
+import {Command, Message} from '@/types/index';
+import fs from 'fs/promises';
+import React from 'react';
+
+const formatMessageContent = (message: Message) => {
+	let content = '';
+	switch (message.role) {
+		case 'user':
+			content += `## User\n${message.content}`;
+			break;
+		case 'assistant':
+			content += `## Assistant\n${message.content || ''}`;
+			if (message.tool_calls) {
+				content += `\n\n[tool_use: ${message.tool_calls
+					.map(tc => tc.function.name)
+					.join(', ')}]`;
+			}
+			break;
+		case 'tool':
+			content +=
+				`## Tool Output: ${message.name}\n` +
+				'```\n' +
+				`${message.content}\n` +
+				'```\n';
+			break;
+		case 'system':
+			// For now, we don't include system messages in the export
+			return '';
+		default:
+			return '';
+	}
+	return content + '\n\n';
+};
+
+function Export({filename}: {filename: string}) {
+	return (
+		<SuccessMessage
+			hideBox={true}
+			message={`✔️ Chat exported to ${filename}`}
+		></SuccessMessage>
+	);
+}
+
+export const exportCommand: Command = {
+	name: 'export',
+	description: 'Export the chat history to a markdown file',
+	handler: async (
+		args: string[],
+		messages: Message[],
+		{provider, model, tokens},
+	) => {
+		const filename =
+			args[0] ||
+			`coder-chat-${new Date().toISOString().replace(/:/g, '-')}.md`;
+		const filepath = path.resolve(process.cwd(), filename); // nosemgrep
+
+		const frontmatter = `---
+session_date: ${new Date().toISOString()}
+provider: ${provider}
+model: ${model}
+total_tokens: ${tokens}
+---
+
+# Coder Chat Export
+
+`;
+
+		const markdownContent = messages.map(formatMessageContent).join('');
+
+		await fs.writeFile(filepath, frontmatter + markdownContent);
+
+		return React.createElement(Export, {
+			key: `export-${Date.now()}`,
+			filename,
+		});
+	},
+};

package/source/commands/help.tsx

@@ -0,0 +1,120 @@
+import {readFile} from 'node:fs/promises';
+import path from 'path';
+import {fileURLToPath} from 'url';
+import {commandRegistry} from '@/commands';
+import {TitledBox} from '@/components/ui/titled-box';
+import {useTerminalWidth} from '@/hooks/useTerminalWidth';
+import {useTheme} from '@/hooks/useTheme';
+import {Command} from '@/types/index';
+import {Box, Text} from 'ink';
+import React from 'react';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+let cachedVersion: string | null = null;
+
+async function getPackageVersion(): Promise<string> {
+	if (cachedVersion) {
+		return cachedVersion;
+	}
+
+	try {
+		const content = await readFile(
+			path.join(__dirname, '../../package.json'),
+			'utf8',
+		);
+		const packageJson = JSON.parse(content) as {version?: string};
+		cachedVersion = packageJson.version ?? '0.0.0';
+		return cachedVersion;
+	} catch (error) {
+		console.warn('Failed to read package version:', error);
+		cachedVersion = '0.0.0';
+		return cachedVersion;
+	}
+}
+
+function Help({
+	version,
+	commands,
+}: {
+	version: string;
+	commands: Array<{name: string; description: string}>;
+}) {
+	const boxWidth = useTerminalWidth();
+	const {colors} = useTheme();
+	return (
+		<TitledBox
+			title="/help"
+			width={boxWidth}
+			borderColor={colors.primary}
+			paddingX={2}
+			paddingY={1}
+			flexDirection="column"
+			marginBottom={1}
+		>
+			<Box marginBottom={1}>
+				<Text color={colors.primary} bold>
+					Coder – {version}
+				</Text>
+			</Box>
+
+			<Text color={colors.white}>
+				A local-first CLI coding agent that brings the power of agentic coding
+				tools like Claude Code and Gemini CLI to local models or controlled APIs
+				like OpenRouter.
+			</Text>
+
+			<Box marginTop={1}>
+				<Text color={colors.secondary}>
+					Always review model responses, especially when running code. Models
+					have read access to files in the current directory and can run
+					commands and edit files with your permission.
+				</Text>
+			</Box>
+
+			<Box marginTop={1}>
+				<Text color={colors.primary} bold>
+					Common Tasks:
+				</Text>
+			</Box>
+			<Text color={colors.white}>
+				{' '}
+				• Ask questions about your codebase {'>'} How does foo.py work?
+			</Text>
+			<Text color={colors.white}> • Edit files {'>'} Update bar.ts to...</Text>
+			<Text color={colors.white}> • Fix errors {'>'} cargo build</Text>
+			<Text color={colors.white}> • Run commands {'>'} /help</Text>
+
+			<Box marginTop={1}>
+				<Text color={colors.primary} bold>
+					Commands:
+				</Text>
+			</Box>
+			{commands.length === 0 ? (
+				<Text color={colors.white}> No commands available.</Text>
+			) : (
+				commands.map((cmd, index) => (
+					<Text key={index} color={colors.white}>
+						{' '}
+						• /{cmd.name} - {cmd.description}
+					</Text>
+				))
+			)}
+		</TitledBox>
+	);
+}
+
+export const helpCommand: Command = {
+	name: 'help',
+	description: 'Show available commands',
+	handler: async (_args: string[], _messages, _metadata) => {
+		const commands = commandRegistry.getAll();
+		const version = await getPackageVersion();
+
+		return React.createElement(Help, {
+			key: `help-${Date.now()}`,
+			version,
+			commands: commands,
+		});
+	},
+};

package/source/commands/index.ts

@@ -0,0 +1,17 @@
+export * from '@/commands/exit';
+export * from '@/commands/help';
+export * from '@/commands/clear';
+export * from '@/commands/model';
+export * from '@/commands/provider';
+export * from '@/commands/mcp';
+export * from '@/commands/lsp';
+export * from '@/commands/custom-commands';
+export * from '@/commands/init';
+export * from '@/commands/theme';
+export * from '@/commands/export';
+export * from '@/commands/update';
+export * from '@/commands/model-database';
+export * from '@/commands/status';
+export * from '@/commands/setup-config';
+export * from '@/commands/usage';
+export * from '@/commands/checkpoint';

package/source/commands/init.tsx

@@ -0,0 +1,339 @@
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { ErrorMessage } from '@/components/message-box';
+import { TitledBox } from '@/components/ui/titled-box';
+import { colors } from '@/config/index';
+import { useTerminalWidth } from '@/hooks/useTerminalWidth';
+import { AgentsTemplateGenerator } from '@/init/agents-template-generator';
+import { ExistingRulesExtractor } from '@/init/existing-rules-extractor';
+import { ProjectAnalyzer } from '@/init/project-analyzer';
+import { Command } from '@/types/index';
+import { Box, Text } from 'ink';
+import React from 'react';
+
+const DEFAULT_CODER_CONFIG = {
+	coder: {
+		providers: [
+			{
+				name: 'OpenRouter',
+				baseUrl: 'https://openrouter.ai/api/v1',
+				apiKey: 'your-openrouter-api-key-here',
+				models: ['openai/gpt-4o-mini', 'anthropic/claude-3-haiku'],
+			},
+			{
+				name: 'GitHub Models',
+				baseUrl: 'https://models.github.ai/inference',
+				apiKey: 'your-github-token-here',
+				models: ['openai/gpt-4o-mini', 'openai/gpt-4o'],
+			},
+			{
+				name: 'Local Ollama',
+				baseUrl: 'http://localhost:11434/v1',
+				models: ['llama3.2', 'qwen2.5-coder'],
+			},
+		],
+		mcpServers: [],
+	},
+};
+
+function InitSuccess({
+	created,
+	analysis,
+}: {
+	created: string[];
+	analysis?: {
+		projectType: string;
+		primaryLanguage: string;
+		frameworks: string[];
+		totalFiles: number;
+	};
+}) {
+	const boxWidth = useTerminalWidth();
+	return (
+		<TitledBox
+			title="Project Initialized"
+			width={boxWidth}
+			borderColor={colors.primary}
+			paddingX={2}
+			paddingY={1}
+			flexDirection="column"
+			marginBottom={1}
+		>
+			<Box marginBottom={1}>
+				<Text color={colors.primary} bold>
+					✓ Coder project initialized successfully!
+				</Text>
+			</Box>
+
+			{analysis && (
+				<>
+					<Box marginBottom={1}>
+						<Text color={colors.white} bold>
+							Project Analysis:
+						</Text>
+					</Box>
+					<Text color={colors.secondary}>• Type: {analysis.projectType}</Text>
+					<Text color={colors.secondary}>
+						• Primary Language: {analysis.primaryLanguage}
+					</Text>
+					{analysis.frameworks.length > 0 && (
+						<Text color={colors.secondary}>
+							• Frameworks: {analysis.frameworks.slice(0, 3).join(', ')}
+						</Text>
+					)}
+					<Text color={colors.secondary}>
+						• Files Analyzed: {analysis.totalFiles}
+					</Text>
+					<Box marginBottom={1} />
+				</>
+			)}
+
+			<Box marginBottom={1}>
+				<Text color={colors.white} bold>
+					Files Created:
+				</Text>
+			</Box>
+
+			{created.map((item, index) => (
+				<Text key={index} color={colors.secondary}>
+					• {item}
+				</Text>
+			))}
+
+			<Box marginTop={1} flexDirection="column">
+				<Box marginBottom={1}>
+					<Text color={colors.white}>
+						Your project is now ready for AI-assisted development!
+					</Text>
+				</Box>
+				<Text color={colors.secondary}>
+					The AGENTS.md file will help AI understand your project context.
+				</Text>
+			</Box>
+		</TitledBox>
+	);
+}
+
+function InitError({ message }: { message: string }) {
+	return <ErrorMessage hideBox={true} message={`✗ ${message}`} />;
+}
+
+// Enhanced example commands based on detected project type
+const getExampleCommands = (projectType: string, primaryLanguage: string) => {
+	const baseCommands = {
+		'review.md': `---
+description: Review code and suggest improvements
+aliases: [code-review, cr]
+parameters: [files]
+---
+
+Review the code in {{files}} and provide detailed feedback on:
+
+1. Code quality and best practices
+2. Potential bugs or issues
+3. Performance considerations
+4. Readability and maintainability
+5. Security concerns
+
+Provide specific, actionable suggestions for improvement.`,
+
+		'test.md': `---
+description: Generate comprehensive unit tests
+aliases: [unittest, test-gen]
+parameters: [filename]
+---
+
+Generate comprehensive unit tests for {{filename}}.
+
+Consider:
+1. Test all public functions and methods
+2. Include edge cases and error scenarios
+3. Use appropriate mocking where needed
+4. Follow existing test framework conventions
+5. Ensure good test coverage
+
+If no filename provided, suggest which files need tests.`,
+	};
+
+	// Add language/framework-specific commands
+	const additionalCommands: { [key: string]: string } = {};
+
+	if (primaryLanguage === 'JavaScript' || primaryLanguage === 'TypeScript') {
+		additionalCommands['refactor.md'] = `---
+description: Refactor JavaScript/TypeScript code
+aliases: [refactor-js, clean]
+parameters: [target]
+---
+
+Refactor {{target}} to improve:
+
+1. Code structure and organization
+2. Modern ES6+ syntax usage
+3. Performance optimizations
+4. Type safety (for TypeScript)
+5. Reusability and maintainability
+
+Follow current project conventions and patterns.`;
+	}
+
+	if (primaryLanguage === 'Python') {
+		additionalCommands['optimize.md'] = `---
+description: Optimize Python code for performance
+aliases: [perf, optimize-py]
+parameters: [file]
+---
+
+Analyze and optimize {{file}} for:
+
+1. Algorithm efficiency
+2. Memory usage
+3. Pythonic patterns
+4. Performance bottlenecks
+5. Code readability
+
+Follow PEP 8 and project conventions.`;
+	}
+
+	if (projectType.includes('Web')) {
+		additionalCommands['component.md'] = `---
+description: Create a new UI component
+aliases: [comp, ui]
+parameters: [name, type]
+---
+
+Create a new {{type}} component named {{name}} that:
+
+1. Follows project component patterns
+2. Includes proper TypeScript types
+3. Has responsive design considerations
+4. Includes basic styling structure
+5. Has proper prop validation
+
+Make it reusable and well-documented.`;
+	}
+
+	return { ...baseCommands, ...additionalCommands };
+};
+
+export const initCommand: Command = {
+	name: 'init',
+	description:
+		'Initialize coder configuration and analyze project structure. Use --force to regenerate AGENTS.md.',
+	handler: (args: string[], _messages, _metadata) => {
+		const cwd = process.cwd();
+		const created: string[] = [];
+		const forceRegenerate = args.includes('--force') || args.includes('-f');
+
+		try {
+			// Check if already initialized
+			const agentsPath = join(cwd, 'AGENTS.md');
+			const coderDir = join(cwd, '.coder');
+			const configPath = join(cwd, 'coder.config.json');
+
+			// Check for existing initialization
+			const hasAgents = existsSync(agentsPath);
+			const hasCoder = existsSync(coderDir);
+			const hasConfig = existsSync(configPath);
+
+			if (hasAgents && hasCoder && hasConfig && !forceRegenerate) {
+				return Promise.resolve(
+					React.createElement(InitError, {
+						key: `init-error-${Date.now()}`,
+						message:
+							'Project already initialized. Found AGENTS.md, .coder/ directory and coder.config.json. Use /init --force to regenerate.',
+					}),
+				);
+			}
+
+			// Show progress indicator for analysis
+			// Note: In a real implementation, we'd want to show this as a loading state
+			// For now, we'll do the analysis synchronously
+
+			// Analyze the project
+			const analyzer = new ProjectAnalyzer(cwd);
+			const analysis = analyzer.analyze();
+
+			// Extract existing AI configuration files
+			const rulesExtractor = new ExistingRulesExtractor(cwd);
+			const existingRules = rulesExtractor.extractExistingRules();
+
+			// Create AGENTS.md based on analysis and existing rules
+			if (!hasAgents || forceRegenerate) {
+				const agentsContent = AgentsTemplateGenerator.generateAgentsMd(
+					analysis,
+					existingRules,
+				);
+				writeFileSync(agentsPath, agentsContent);
+				created.push(hasAgents ? 'AGENTS.md (regenerated)' : 'AGENTS.md');
+
+				// Report found existing rules
+				if (existingRules.length > 0) {
+					const sourceFiles = existingRules.map(r => r.source).join(', ');
+					created.push(`↳ Merged content from: ${sourceFiles}`);
+				}
+			}
+
+			// Create .coder directory structure
+			if (!hasCoder) {
+				mkdirSync(coderDir, { recursive: true });
+				created.push('.coder/');
+			}
+
+			const commandsDir = join(coderDir, 'commands');
+			if (!existsSync(commandsDir)) {
+				mkdirSync(commandsDir, { recursive: true });
+				created.push('.coder/commands/');
+			}
+
+			// Create example custom commands based on project analysis
+			const exampleCommands = getExampleCommands(
+				analysis.projectType,
+				analysis.languages.primary?.name || 'Unknown',
+			);
+
+			for (const [filename, content] of Object.entries(exampleCommands)) {
+				const filePath = join(commandsDir, filename);
+				if (!existsSync(filePath)) {
+					writeFileSync(filePath, content);
+					created.push(`.coder/commands/${filename}`);
+				}
+			}
+
+			// Prepare analysis summary for display
+			const analysisSummary = {
+				projectType: analysis.projectType,
+				primaryLanguage: analysis.languages.primary?.name || 'Unknown',
+				frameworks: analysis.dependencies.frameworks.map(
+					(f: { name: string }) => f.name,
+				),
+				totalFiles: analysis.structure.scannedFiles,
+			};
+
+			// Create coder.config.json
+			if (!hasConfig || forceRegenerate) {
+				writeFileSync(
+					configPath,
+					JSON.stringify(DEFAULT_CODER_CONFIG, null, 2),
+				);
+				created.push(hasConfig ? 'coder.config.json (regenerated)' : 'coder.config.json');
+			}
+
+			return Promise.resolve(
+				React.createElement(InitSuccess, {
+					key: `init-success-${Date.now()}`,
+					created,
+					analysis: analysisSummary,
+				}),
+			);
+		} catch (error: unknown) {
+			const errorMessage =
+				error instanceof Error ? error.message : 'Unknown error';
+			return Promise.resolve(
+				React.createElement(InitError, {
+					key: `init-error-${Date.now()}`,
+					message: `Failed to initialize project: ${errorMessage}`,
+				}),
+			);
+		}
+	},
+};