AI Commit Writer

Genera mensajes de commit en estilo Conventional Commits basados en los cambios preparados (staged) de tu repositorio Git. Funciona 100% local, sin servicios externos.

Características

• Comando: AI Commit Writer: Generate Commit.
• Obtiene git diff --cached del proyecto actual.
• Sugiere un mensaje de commit en estilo Conventional Commits (heurística local).
• Permite editar el mensaje antes de confirmar.
• Ejecuta git commit -m "mensaje" automáticamente.
• Maneja errores si Git no está inicializado o si no hay cambios preparados.

Requisitos

• Tener Git instalado y disponible en la variable de entorno PATH.
• Abrir una carpeta de proyecto en VS Code que sea un repositorio Git (o inicializarlo con git init).

Instalación (desarrollo)

1. Clona o descarga este repositorio.
2. Instala dependencias:

   npm install
   

   • Al instalar, se generará automáticamente un icono por defecto en images/AI-Commit-Writer.png si no existe.
3. Compila el proyecto:

   npm run build
   

4. Abre la carpeta en VS Code y presiona F5 para iniciar en Modo Extensión. Se abrirá una segunda ventana de VS Code para pruebas.

Uso

1. Prepara cambios con git add.
2. Ejecuta el comando AI Commit Writer: Generate Commit desde la paleta (Ctrl+Shift+P o Cmd+Shift+P).
3. Revisa/edita el mensaje sugerido en el input.
4. Confirma para crear el commit.

Detalles de generación de mensaje

La función generateCommitMessage(diff: string): string aplica una heurística sencilla:

• Determina el tipo (feat, fix, refactor, docs, test, chore).
• Deriva un scope opcional en base al primer directorio afectado.
• Resume adiciones y eliminaciones.
• Lista hasta 5 archivos afectados.

Ejemplo de salida:

feat(core): nueva funcionalidad

- 12 adición(es), 3 eliminación(es)
- Archivos afectados:
- src/index.ts
- src/utils/helpers.ts

Nota: La heurística es intencionalmente simple para evitar dependencias externas. Puedes mejorarla a conveniencia.

Personalizar imagen/icono

• Icono de la extensión: coloca tu archivo PNG en images/AI-Commit-Writer.png (256x256 recomendado). Si no existe, se genera uno por defecto en la instalación. VS Code usará esa ruta definida en package.json (campo icon).
• Capturas en README: guarda tus imágenes adicionales en images/ y referencia con rutas relativas, por ejemplo: ![Ejemplo](https://github.com/AntonioSysPro/AI-Commit-Writer/raw/HEAD/images/screenshot-commit.png)

Scripts

• npm run build: compila TypeScript a dist.
• npm run watch: compila en modo observación.

Contribución

• Aceptamos mejoras en heurística, configuración, internacionalización y soporte a más casos de uso.

Licencia

MIT