autogit-ai 0.1.0__tar.gz

autogit_ai-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Instalar uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Sincronizar dependencias
+        run: uv sync --extra dev
+
+      - name: Lint (ruff)
+        run: uv run ruff check .
+
+      - name: Formato (ruff format)
+        run: uv run ruff format --check .
+
+      - name: Tipado (mypy)
+        run: uv run mypy
+
+      - name: Tests (pytest)
+        run: uv run pytest

autogit_ai-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Publicar en PyPI
+
+# Se dispara al empujar un tag de versión, por ejemplo v0.1.0.
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Instalar uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+
+      - name: Construir el paquete (wheel + sdist)
+        run: uv build
+
+      - name: Guardar los artefactos
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    # El 'environment' permite exigir aprobaciones antes de publicar.
+    environment: pypi
+    permissions:
+      # Necesario para 'trusted publishing' vía OIDC (sin tokens).
+      id-token: write
+    steps:
+      - name: Descargar los artefactos
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publicar en PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

autogit_ai-0.1.0/.gitignore

@@ -0,0 +1,38 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Virtual environments / uv
+.venv/
+venv/
+env/
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+.tox/
+
+# Type / lint caches
+.mypy_cache/
+.ruff_cache/
+.dmypy.json
+
+# IDE / OS
+.idea/
+.vscode/
+.DS_Store
+Thumbs.db
+
+# AutoGit local config / secrets
+.autogit/
+*.env
+.env

autogit_ai-0.1.0/.python-version

@@ -0,0 +1 @@
+3.10

autogit_ai-0.1.0/.smartgit.toml

@@ -0,0 +1 @@
+language = "en"

autogit_ai-0.1.0/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+Todas las novedades notables de este proyecto se documentan en este archivo.
+
+El formato se basa en [Keep a Changelog](https://keepachangelog.com/es/1.1.0/)
+y el proyecto sigue [Versionado Semántico](https://semver.org/lang/es/).
+
+## [No publicado]
+
+## [0.1.0] - 2026-07-07
+
+### Añadido
+- **Capa Git**: adaptador sobre el binario `git` (`GitRunner`), interfaz
+  `GitRepository` e implementación `GitCommandRepository` con `status`, `diff`,
+  `add`, `commit`, `push` y `discover`. Parser puro de `git status --porcelain`.
+- **Configuración por capas** validada con Pydantic: valores por defecto →
+  archivo global (`~/.autogit/config.toml`) → archivo de proyecto
+  (`.autogit.toml`) → variables de entorno (`AUTOGIT_*`).
+- **Capa IA**: interfaz `AIProvider`, constructor de prompts con recorte de
+  diffs, proveedor `fake` (offline), proveedor `ollama` (vía httpx) y una
+  fábrica de proveedores extensible.
+- **Núcleo (core)**: `ChangeAnalyzer` y `CommitService` que orquestan el
+  análisis de cambios y la generación del commit.
+- **CLI**: comandos `commit`, `status`, `analyze`, `config` (show/set/path),
+  `doctor` y `version`, con experiencia interactiva basada en Rich.
+- Suite de tests, configuración de calidad (ruff, mypy) y CI en GitHub Actions.
+
+[No publicado]: https://github.com/OptimScul/autogit-ai/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/OptimScul/autogit-ai/releases/tag/v0.1.0

autogit_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OptimScul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

autogit_ai-0.1.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: autogit-ai
+Version: 0.1.0
+Summary: CLI que analiza tu repositorio Git y genera commits profesionales con IA (Conventional Commits).
+Project-URL: Homepage, https://github.com/OptimScul/autogit-ai
+Project-URL: Repository, https://github.com/OptimScul/autogit-ai
+Project-URL: Issues, https://github.com/OptimScul/autogit-ai/issues
+Author: OptimScul
+License: MIT
+License-File: LICENSE
+Keywords: ai,cli,commit,conventional-commits,devtools,git
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.7
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli>=2.0.1; python_version < '3.11'
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# AutoGit AI
+
+**AutoGit AI** analiza automáticamente los cambios de tu repositorio Git, los
+agrupa de forma inteligente y usa IA para generar mensajes de commit
+profesionales siguiendo **Conventional Commits**.
+
+```bash
+autogit commit   # o el alias corto: ag commit
+```
+
+> ⚠️ Proyecto en desarrollo temprano (Alpha). La API y los comandos pueden cambiar.
+
+## Características
+
+- Detecta el repositorio Git actual y lee su estado (añadidos, modificados,
+  eliminados, renombrados y sin seguimiento).
+- Construye el contexto (diffs y estadísticas por archivo) y lo envía a la IA.
+- Genera el mensaje, muestra una vista previa y te deja **confirmar, editar o
+  cancelar**.
+- Configuración flexible por capas y varios proveedores de IA intercambiables.
+
+## Instalación
+
+Requisitos: [uv](https://docs.astral.sh/uv/) y Git.
+
+```bash
+git clone https://github.com/OptimScul/autogit-ai.git
+cd autogit-ai
+uv sync --extra dev
+uv run autogit version
+```
+
+Una vez publicado en PyPI podrás instalarlo con `pip install autogit-ai`.
+
+## Uso rápido
+
+```bash
+autogit status     # ver los cambios del repositorio
+autogit analyze    # analizar y previsualizar el mensaje sin commitear
+autogit commit     # generar el commit con IA (menú Sí / Editar / Cancelar)
+autogit commit -p  # además hacer push tras el commit
+```
+
+## Comandos
+
+| Comando           | Descripción                                             |
+| ----------------- | ------------------------------------------------------- |
+| `autogit commit`  | Analiza los cambios y genera el commit con IA           |
+| `autogit status`  | Estado del repositorio en formato enriquecido           |
+| `autogit analyze` | Analiza y previsualiza el mensaje sin hacer commit      |
+| `autogit config`  | Gestiona proveedor, modelo, API key, idioma, etc.       |
+| `autogit doctor`  | Diagnóstico del entorno (git, config, proveedor de IA)  |
+| `autogit version` | Muestra la versión instalada                            |
+
+## Configuración
+
+La configuración se resuelve combinando, de menor a mayor prioridad:
+
+1. Valores por defecto.
+2. Archivo global del usuario: `~/.autogit/config.toml`.
+3. Archivo del proyecto: `.autogit.toml` en la raíz del repo.
+4. Variables de entorno: `AUTOGIT_PROVIDER`, `AUTOGIT_MODEL`, `AUTOGIT_API_KEY`,
+   `AUTOGIT_LANGUAGE`, `AUTOGIT_COMMIT_STYLE`, `AUTOGIT_MAX_MESSAGE_LENGTH`.
+
+```bash
+autogit config show                  # ver la configuración efectiva
+autogit config path                  # ver dónde viven los archivos
+autogit config set provider ollama   # fijar un valor (se valida antes de guardar)
+autogit config set model llama3
+```
+
+> La API key es más segura como variable de entorno (`AUTOGIT_API_KEY`) que
+> escrita en un archivo.
+
+### Proveedores de IA
+
+| Proveedor    | Estado           | Notas                                  |
+| ------------ | ---------------- | -------------------------------------- |
+| `fake`       | ✅ Disponible    | Determinista y offline (desarrollo)    |
+| `ollama`     | ✅ Disponible    | Modelos locales, sin API key           |
+| `openai`     | ⏳ Planificado   |                                        |
+| `claude`     | ⏳ Planificado   |                                        |
+| `gemini`     | ⏳ Planificado   |                                        |
+| `openrouter` | ⏳ Planificado   |                                        |
+
+## Desarrollo
+
+```bash
+uv run pytest              # tests
+uv run ruff check .        # lint
+uv run ruff format .       # formato
+uv run mypy                # tipado estático
+```
+
+## Arquitectura
+
+Clean Architecture con capas desacopladas:
+
+```
+src/autogit/
+├── cli/        # Interacción de terminal (Typer + Rich)
+├── commands/   # Un módulo por subcomando
+├── core/       # Casos de uso y reglas de negocio (dominio)
+├── git/        # Adaptador sobre el binario git
+├── ai/         # Interfaz AIProvider + implementaciones + fábrica
+├── config/     # Carga y validación de configuración (Pydantic)
+├── models/     # Modelos de datos tipados
+└── utils/      # Utilidades transversales
+```
+
+## Licencia
+
+MIT

autogit_ai-0.1.0/README.md

@@ -0,0 +1,113 @@
+# AutoGit AI
+
+**AutoGit AI** analiza automáticamente los cambios de tu repositorio Git, los
+agrupa de forma inteligente y usa IA para generar mensajes de commit
+profesionales siguiendo **Conventional Commits**.
+
+```bash
+autogit commit   # o el alias corto: ag commit
+```
+
+> ⚠️ Proyecto en desarrollo temprano (Alpha). La API y los comandos pueden cambiar.
+
+## Características
+
+- Detecta el repositorio Git actual y lee su estado (añadidos, modificados,
+  eliminados, renombrados y sin seguimiento).
+- Construye el contexto (diffs y estadísticas por archivo) y lo envía a la IA.
+- Genera el mensaje, muestra una vista previa y te deja **confirmar, editar o
+  cancelar**.
+- Configuración flexible por capas y varios proveedores de IA intercambiables.
+
+## Instalación
+
+Requisitos: [uv](https://docs.astral.sh/uv/) y Git.
+
+```bash
+git clone https://github.com/OptimScul/autogit-ai.git
+cd autogit-ai
+uv sync --extra dev
+uv run autogit version
+```
+
+Una vez publicado en PyPI podrás instalarlo con `pip install autogit-ai`.
+
+## Uso rápido
+
+```bash
+autogit status     # ver los cambios del repositorio
+autogit analyze    # analizar y previsualizar el mensaje sin commitear
+autogit commit     # generar el commit con IA (menú Sí / Editar / Cancelar)
+autogit commit -p  # además hacer push tras el commit
+```
+
+## Comandos
+
+| Comando           | Descripción                                             |
+| ----------------- | ------------------------------------------------------- |
+| `autogit commit`  | Analiza los cambios y genera el commit con IA           |
+| `autogit status`  | Estado del repositorio en formato enriquecido           |
+| `autogit analyze` | Analiza y previsualiza el mensaje sin hacer commit      |
+| `autogit config`  | Gestiona proveedor, modelo, API key, idioma, etc.       |
+| `autogit doctor`  | Diagnóstico del entorno (git, config, proveedor de IA)  |
+| `autogit version` | Muestra la versión instalada                            |
+
+## Configuración
+
+La configuración se resuelve combinando, de menor a mayor prioridad:
+
+1. Valores por defecto.
+2. Archivo global del usuario: `~/.autogit/config.toml`.
+3. Archivo del proyecto: `.autogit.toml` en la raíz del repo.
+4. Variables de entorno: `AUTOGIT_PROVIDER`, `AUTOGIT_MODEL`, `AUTOGIT_API_KEY`,
+   `AUTOGIT_LANGUAGE`, `AUTOGIT_COMMIT_STYLE`, `AUTOGIT_MAX_MESSAGE_LENGTH`.
+
+```bash
+autogit config show                  # ver la configuración efectiva
+autogit config path                  # ver dónde viven los archivos
+autogit config set provider ollama   # fijar un valor (se valida antes de guardar)
+autogit config set model llama3
+```
+
+> La API key es más segura como variable de entorno (`AUTOGIT_API_KEY`) que
+> escrita en un archivo.
+
+### Proveedores de IA
+
+| Proveedor    | Estado           | Notas                                  |
+| ------------ | ---------------- | -------------------------------------- |
+| `fake`       | ✅ Disponible    | Determinista y offline (desarrollo)    |
+| `ollama`     | ✅ Disponible    | Modelos locales, sin API key           |
+| `openai`     | ⏳ Planificado   |                                        |
+| `claude`     | ⏳ Planificado   |                                        |
+| `gemini`     | ⏳ Planificado   |                                        |
+| `openrouter` | ⏳ Planificado   |                                        |
+
+## Desarrollo
+
+```bash
+uv run pytest              # tests
+uv run ruff check .        # lint
+uv run ruff format .       # formato
+uv run mypy                # tipado estático
+```
+
+## Arquitectura
+
+Clean Architecture con capas desacopladas:
+
+```
+src/autogit/
+├── cli/        # Interacción de terminal (Typer + Rich)
+├── commands/   # Un módulo por subcomando
+├── core/       # Casos de uso y reglas de negocio (dominio)
+├── git/        # Adaptador sobre el binario git
+├── ai/         # Interfaz AIProvider + implementaciones + fábrica
+├── config/     # Carga y validación de configuración (Pydantic)
+├── models/     # Modelos de datos tipados
+└── utils/      # Utilidades transversales
+```
+
+## Licencia
+
+MIT

autogit_ai-0.1.0/pyproject.toml

@@ -0,0 +1,83 @@
+[project]
+name = "autogit-ai"
+dynamic = ["version"]
+description = "CLI que analiza tu repositorio Git y genera commits profesionales con IA (Conventional Commits)."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "OptimScul" }]
+keywords = ["git", "cli", "ai", "commit", "conventional-commits", "devtools"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = [
+    "typer>=0.12",
+    "click>=8.1",
+    "pydantic>=2.7",
+    "tomli>=2.0.1; python_version < '3.11'",
+    "httpx>=0.27",
+    "rich>=13.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/OptimScul/autogit-ai"
+Repository = "https://github.com/OptimScul/autogit-ai"
+Issues = "https://github.com/OptimScul/autogit-ai/issues"
+
+# Dos nombres para el mismo entry point: el largo y el alias corto.
+[project.scripts]
+autogit = "autogit.cli.app:main"
+ag = "autogit.cli.app:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.6",
+    "mypy>=1.11",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+# La versión se lee dinámicamente de src/autogit/__init__.py (fuente única).
+[tool.hatch.version]
+path = "src/autogit/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/autogit"]
+
+# --- Herramientas de calidad --------------------------------------------------
+
+[tool.ruff]
+line-length = 88
+src = ["src", "tests"]
+target-version = "py310"
+
+[tool.ruff.lint]
+# E/F: pyflakes+pycodestyle, I: isort, UP: pyupgrade, B: bugbear,
+# SIM: simplificaciones, C4: comprehensions, PTH: usar pathlib.
+select = ["E", "F", "I", "UP", "B", "SIM", "C4", "PTH"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+files = ["src", "tests"]
+# El plugin de Pydantic ensena a mypy a entender los modelos (campos, validadores).
+plugins = ["pydantic.mypy"]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]
+pythonpath = ["src"]

autogit_ai-0.1.0/src/autogit/__init__.py

@@ -0,0 +1,8 @@
+"""AutoGit AI — herramienta CLI para generar commits profesionales con IA.
+
+El número de versión se define aquí como única fuente de verdad y se expone
+al empaquetado a través de ``pyproject.toml`` (``[tool.hatch...]`` o lectura
+dinámica). Ver ``autogit.cli.app`` para el punto de entrada.
+"""
+
+__version__ = "0.1.0"

autogit_ai-0.1.0/src/autogit/__main__.py

@@ -0,0 +1,6 @@
+"""Permite ejecutar el paquete con ``python -m autogit``."""
+
+from autogit.cli.app import main
+
+if __name__ == "__main__":
+    main()

autogit_ai-0.1.0/src/autogit/ai/__init__.py

@@ -0,0 +1,6 @@
+"""Capa IA: interfaz ``AIProvider`` e implementaciones intercambiables.
+
+Cada proveedor (OpenAI, Claude, Gemini, Ollama, OpenRouter) implementa el
+mismo contrato. El dominio depende de la abstracción, no de un proveedor
+concreto (Inversión de Dependencias).
+"""

autogit_ai-0.1.0/src/autogit/ai/base.py

@@ -0,0 +1,41 @@
+"""Contrato de la capa IA: la abstracción ``AIProvider`` y sus errores.
+
+Todo el resto de la aplicación depende de esta interfaz, NO de un proveedor
+concreto (OpenAI, Ollama, ...). Cambiar de proveedor será cuestión de elegir
+otra implementación en la configuración, sin tocar el dominio ni la CLI.
+"""
+
+from __future__ import annotations
+
+from typing import Protocol
+
+from autogit.config.schema import AutoGitConfig
+from autogit.models.commit import CommitContext, CommitMessage
+
+
+class AIError(Exception):
+    """Error base de la capa IA."""
+
+
+class AIConfigurationError(AIError):
+    """Configuración inválida o incompleta (por ejemplo, falta la API key)."""
+
+
+class AIRequestError(AIError):
+    """La petición al proveedor falló (red, autenticación, respuesta inválida)."""
+
+
+class AIProvider(Protocol):
+    """Genera un mensaje de commit a partir del contexto de cambios."""
+
+    name: str
+    """Identificador legible del proveedor (para logs y diagnóstico)."""
+
+    def generate(self, context: CommitContext, config: AutoGitConfig) -> CommitMessage:
+        """Produce un ``CommitMessage`` a partir del contexto y la configuración.
+
+        Raises:
+            AIConfigurationError: Si al proveedor le falta algo para operar.
+            AIRequestError: Si la comunicación con el proveedor falla.
+        """
+        ...

autogit_ai-0.1.0/src/autogit/ai/factory.py

@@ -0,0 +1,39 @@
+"""Fábrica de proveedores de IA.
+
+Traduce el ``Provider`` de la configuración a una implementación concreta de
+``AIProvider``. Usamos un diccionario de constructores (patrón *registry*): el
+día que implementemos OpenAI o Claude, bastará con añadir una entrada, sin
+tocar el resto del código. Los proveedores aún no implementados fallan con un
+mensaje claro en lugar de un error críptico.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+
+from autogit.ai.base import AIConfigurationError, AIProvider
+from autogit.ai.providers.fake import FakeProvider
+from autogit.ai.providers.ollama import OllamaProvider
+from autogit.config.schema import AutoGitConfig, Provider
+
+# Cada proveedor soportado se registra aquí con una función que lo construye.
+_FACTORIES: dict[Provider, Callable[[AutoGitConfig], AIProvider]] = {
+    Provider.OLLAMA: lambda _config: OllamaProvider(),
+    Provider.FAKE: lambda _config: FakeProvider(),
+}
+
+
+def create_provider(config: AutoGitConfig) -> AIProvider:
+    """Devuelve el proveedor de IA correspondiente a la configuración.
+
+    Raises:
+        AIConfigurationError: Si el proveedor elegido aún no está implementado.
+    """
+    factory = _FACTORIES.get(config.provider)
+    if factory is None:
+        disponibles = ", ".join(p.value for p in _FACTORIES)
+        raise AIConfigurationError(
+            f"El proveedor '{config.provider.value}' todavía no está implementado. "
+            f"Disponibles: {disponibles}."
+        )
+    return factory(config)