import { z } from 'zod';
import { runGitCommand } from '../utils/terminal-controller.js';
/**
* Tool: git-config
*
* DESCRIÇÃO:
* Gerenciamento de configuração Git (GitHub + Gitea) com múltiplas ações
*
* FUNCIONALIDADES:
* - Obter configurações
* - Definir configurações
* - Remover configurações
* - Listar configurações
* - Editar configuração
* - Mostrar configurações
*
* USO:
* - Para configurar usuário e email
* - Para configurar aliases
* - Para configurar branches padrão
* - Para configurar merge tools
* - Para configurar credenciais
*
* RECOMENDAÇÕES:
* - Use configurações globais para usuário
* - Use configurações locais para projeto
* - Documente configurações customizadas
*/
const GitConfigInputSchema = z.object({
action: z.enum(['get', 'set', 'unset', 'list', 'edit', 'show']),
// owner: obtido automaticamente do provider,
repo: z.string(),
provider: z.enum(['gitea', 'github']).describe('Provider to use (gitea or github)'),
projectPath: z.string().describe('Local project path for git operations'),
// Para get/set/unset
key: z.string().optional(),
value: z.string().optional(),
// Para set
scope: z.enum(['local', 'global', 'system']).optional(),
// Para list
pattern: z.string().optional(),
// Para show
show_origin: z.boolean().optional(),
});
export type GitConfigInput = z.infer<typeof GitConfigInputSchema>;
const GitConfigResultSchema = z.object({
success: z.boolean(),
action: z.string(),
message: z.string(),
data: z.any().optional(),
error: z.string().optional()
});
export type GitConfigResult = z.infer<typeof GitConfigResultSchema>;
export const gitConfigTool = {
name: 'git-config',
description: 'tool: Gerencia configurações Git para personalização do ambiente\n──────────────\naction get: obtém valor de configuração\naction get requires: repo, key, scope, provider\n───────────────\naction set: define valor de configuração\naction set requires: repo, key, value, scope, provider\n───────────────\naction unset: remove configuração\naction unset requires: repo, key, scope, provider\n───────────────\naction list: lista configurações\naction list requires: repo, pattern, scope, provider\n───────────────\naction edit: edita arquivo de configuração\naction edit requires: repo, scope, provider\n───────────────\naction show: mostra configurações com origem\naction show requires: repo, show_origin, provider',
inputSchema: {
type: 'object',
properties: {
action: {
type: 'string',
enum: ['get', 'set', 'unset', 'list', 'edit', 'show'],
description: 'Action to perform on config'
},
owner: { type: 'string', description: 'Repository owner' },
repo: { type: 'string', description: 'Repository name' },
provider: { type: 'string', enum: ['gitea', 'github'], description: 'Provider to use (gitea or github)' },
projectPath: { type: 'string', description: 'Local project path for git operations' },
key: { type: 'string', description: 'Config key' },
value: { type: 'string', description: 'Config value' },
scope: { type: 'string', enum: ['local', 'global', 'system'], description: 'Config scope' },
pattern: { type: 'string', description: 'Pattern for listing configs' },
show_origin: { type: 'boolean', description: 'Show origin of config values' }
},
required: ['action', 'repo', 'provider', 'projectPath']
},
async handler(input: GitConfigInput): Promise<GitConfigResult> {
try {
const validatedInput = GitConfigInputSchema.parse(input);
switch (validatedInput.action) {
case 'get':
return await this.get(validatedInput);
case 'set':
return await this.set(validatedInput);
case 'unset':
return await this.unset(validatedInput);
case 'list':
return await this.list(validatedInput);
case 'edit':
return await this.edit(validatedInput);
case 'show':
return await this.show(validatedInput);
default:
throw new Error(`Ação não suportada: ${validatedInput.action}`);
}
} catch (error) {
return {
success: false,
action: input.action,
message: 'Erro na operação de config',
error: error instanceof Error ? error.message : String(error)
};
}
},
async get(params: GitConfigInput): Promise<GitConfigResult> {
try {
if (!params.key) {
throw new Error('key é obrigatório para get');
}
const scope = params.scope || 'local';
const gitCommand = `config --${scope} ${params.key}`;
const result = await runGitCommand(
gitCommand,
params.projectPath,
'Obtendo configuração'
);
if (result.exitCode !== 0) {
throw new Error(`Falha ao obter configuração: ${result.output}`);
}
return {
success: true,
action: 'get',
message: `Configuração ${params.key} obtida com sucesso`,
data: {
key: params.key,
value: result.output.trim(),
scope,
output: result.output
}
};
} catch (error) {
throw new Error(`Falha ao obter configuração: ${error instanceof Error ? error.message : String(error)}`);
}
},
async set(params: GitConfigInput): Promise<GitConfigResult> {
try {
if (!params.key || !params.value) {
throw new Error('key e value são obrigatórios para set');
}
const scope = params.scope || 'local';
const gitCommand = `config --${scope} ${params.key} "${params.value}"`;
const result = await runGitCommand(
gitCommand,
params.projectPath,
'Definindo configuração'
);
if (result.exitCode !== 0) {
throw new Error(`Falha ao definir configuração: ${result.output}`);
}
return {
success: true,
action: 'set',
message: `Configuração ${params.key} definida com sucesso`,
data: {
key: params.key,
value: params.value,
scope,
output: result.output
}
};
} catch (error) {
throw new Error(`Falha ao definir configuração: ${error instanceof Error ? error.message : String(error)}`);
}
},
async unset(params: GitConfigInput): Promise<GitConfigResult> {
try {
if (!params.key) {
throw new Error('key é obrigatório para unset');
}
const scope = params.scope || 'local';
const gitCommand = `config --${scope} --unset ${params.key}`;
const result = await runGitCommand(
gitCommand,
params.projectPath,
'Removendo configuração'
);
if (result.exitCode !== 0) {
throw new Error(`Falha ao remover configuração: ${result.output}`);
}
return {
success: true,
action: 'unset',
message: `Configuração ${params.key} removida com sucesso`,
data: {
key: params.key,
scope,
output: result.output
}
};
} catch (error) {
throw new Error(`Falha ao remover configuração: ${error instanceof Error ? error.message : String(error)}`);
}
},
async list(params: GitConfigInput): Promise<GitConfigResult> {
try {
const scope = params.scope || 'local';
let gitCommand = `config --${scope} --list`;
if (params.pattern) {
gitCommand += ` | grep "${params.pattern}"`;
}
const result = await runGitCommand(
gitCommand,
params.projectPath,
'Listando configurações'
);
if (result.exitCode !== 0) {
throw new Error(`Falha ao listar configurações: ${result.output}`);
}
const configs = result.output.split('\n')
.filter(line => line.trim())
.map(line => {
const [key, ...valueParts] = line.split('=');
return { key, value: valueParts.join('=') };
});
return {
success: true,
action: 'list',
message: `Configurações ${scope} listadas com sucesso`,
data: {
scope,
pattern: params.pattern,
configs,
output: result.output
}
};
} catch (error) {
throw new Error(`Falha ao listar configurações: ${error instanceof Error ? error.message : String(error)}`);
}
},
async edit(params: GitConfigInput): Promise<GitConfigResult> {
try {
const scope = params.scope || 'local';
const gitCommand = `config --${scope} --edit`;
const result = await runGitCommand(
gitCommand,
params.projectPath,
'Editando configuração'
);
if (result.exitCode !== 0) {
throw new Error(`Falha ao editar configuração: ${result.output}`);
}
return {
success: true,
action: 'edit',
message: `Configuração ${scope} editada com sucesso`,
data: {
scope,
output: result.output
}
};
} catch (error) {
throw new Error(`Falha ao editar configuração: ${error instanceof Error ? error.message : String(error)}`);
}
},
async show(params: GitConfigInput): Promise<GitConfigResult> {
try {
const scope = params.scope || 'local';
let gitCommand = `config --${scope} --list`;
if (params.show_origin) {
gitCommand = `config --${scope} --show-origin --list`;
}
const result = await runGitCommand(
gitCommand,
params.projectPath,
'Mostrando configurações'
);
if (result.exitCode !== 0) {
throw new Error(`Falha ao mostrar configurações: ${result.output}`);
}
return {
success: true,
action: 'show',
message: `Configurações ${scope} mostradas com sucesso`,
data: {
scope,
show_origin: params.show_origin,
output: result.output
}
};
} catch (error) {
throw new Error(`Falha ao mostrar configurações: ${error instanceof Error ? error.message : String(error)}`);
}
}
};
