interactive-git-versioneer 0.10.4__tar.gz

interactive_git_versioneer-0.10.4/.github/workflows/auto-tag.yml

@@ -0,0 +1,37 @@
+name: interactive-git-versioneer Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  tag:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+
+      - name: Install package
+        run: pip install -e .
+
+      - name: Configure API
+        run: |
+          python -m interactive_git_versioneer.main config set OPENAI.key "${{ secrets.GROQ_API_KEY }}"
+          python -m interactive_git_versioneer.main config set OPENAI.baseURL "https://api.groq.com/openai/v1"
+          python -m interactive_git_versioneer.main config set OPENAI.model "llama-3.3-70b-versatile"
+
+      - name: Dry run (validate)
+        run: python -m interactive_git_versioneer.main tag --auto --dry-run
+
+      - name: Create and push tags
+        if: success()
+        run: python -m interactive_git_versioneer.main tag --auto --push

interactive_git_versioneer-0.10.4/.gitignore

@@ -0,0 +1,17 @@
+# Python-specific
+__pycache__/
+*.egg-info/
+.pytest_cache
+
+# Build y distribución
+build/
+dist/
+
+# Credenciales
+.pypirc
+
+# Pyright configuration file
+pyrightconfig.json
+
+# VSCode settings folder
+.vscode/

interactive_git_versioneer-0.10.4/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+*Automatically generated with AI on 2026-02-05 23:59*
+
+## [v0.10.4] - 2026-02-05
+
+### 🔧 Cambios varios
+- Actualiza la visualización de la versión en la etiquetadora
+
+## [v0.10.3] - 2026-02-05
+
+Actualiza la documentación con el registro de cambios y la versión.
+
+## [v0.10.2] - 2026-02-05
+
+### 🔧 Cambios varios
+- Establecer la estructura y configuración inicial del proyecto
+
+## [v0.10.1] - 2026-02-05
+
+### Cambios importantes
+- Agrega una demostración rápida de IGV en formato GIF a la documentación.
+
+## [v0.10.0] - 2026-02-05
+
+Agrega una configuración de MkDocs para mejorar la documentación.
+
+## [v0.9.0] - 2026-02-05
+
+### Cambios clave
+- Agrega flujo de trabajo de autoetiquetado para la integración continua en la construcción.
+
+## [v0.8.2] - 2026-02-05
+
+### Mejoras y Cambios
+- Agrega pruebas para configuración, operaciones de git y modelos.
+
+## [v0.8.1] - 2026-02-05
+
+### Cambios importantes
+- Agregue documentación para los módulos principales.
+
+## [v0.8.0] - 2026-02-05
+
+### Nuevas Características
+- Agrega scripts de despliegue y configuración para igv en Jenkins
+
+## [v0.7.1] - 2026-02-05
+
+### Cambios importantes
+- Agrega documentación para Interactive Git Versioneer
+
+## [v0.7.0] - 2026-02-05
+
+### Nuevas Características
+- Agrega gestión de etiquetas interactiva y generación de etiquetas impulsada por inteligencia artificial.
+
+## [v0.6.0] - 2026-02-05
+
+- Agrega funcionalidad de gestión de lanzamientos y registro de cambios.
+
+## [v0.5.0] - 2026-02-05
+
+### Nuevas Características
+- Agrega funcionalidad central para interactive-git-versioneer
+
+## [v0.4.0] - 2026-02-05
+
+Agrega un módulo de configuración para interactive-git-versioneer.
+
+## [v0.3.0] - 2026-02-05
+
+- Agrega una interfaz de línea de comandos interactiva de Git Versioneer con funcionalidad de configuración y etiquetado.
+
+## [v0.2.0] - 2026-02-05
+
+Agrega la estructura y documentación inicial del proyecto.
+
+## [v0.1.0] - 2026-02-05
+
+Crea el repositorio con el commit inicial.
+
+---
+
+*This changelog was generated with AI and follows the format of [Keep a Changelog](https://keepachangelog.com/es/1.0.0/)*

interactive_git_versioneer-0.10.4/CITATION.cff

@@ -0,0 +1,8 @@
+cff-version: 1.2.0
+title: "interactive-git-versioneer"
+authors:
+  - family-names: "Millanao Lepileo"
+    given-names: "Alexis E."
+    orcid: "https://orcid.org/0009-0003-1768-7048"
+date-released: 2026-02-02
+version: "6.12.2"

interactive_git_versioneer-0.10.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexis E. Millanao Lepileo (alexis.millanao@protonmail.com)
+
+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.

interactive_git_versioneer-0.10.4/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: interactive-git-versioneer
+Version: 0.10.4
+Summary: InteractiveGitVersioneer - Gestor interactivo de versiones Git con soporte para tags, releases de GitHub y generación de mensajes con IA (Groq/OpenAI). Incluye modo CI/CD para pipelines automatizados.
+Author-email: amillanaol <alexis.millanao@protonmail.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Environment :: Console
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: GitPython>=3.1.0
+Requires-Dist: openai>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# InteractiveGitVersioneer
+
+[![PyPI version](https://img.shields.io/pypi/v/interactive-git-versioneer.svg)](https://pypi.org/project/interactive-git-versioneer/)
+[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Build Status](https://github.com/amillanaol/interactive-git-versioneer/actions/workflows/auto-tag.yml/badge.svg)](https://github.com/amillanaol/interactive-git-versioneer/actions/workflows/auto-tag.yml)
+
+CLI para gestión de versiones semánticas con IA. Crea tags, genera changelogs y publica releases en GitHub de forma interactiva o automatizada.
+## Quick Demo
+
+Aquí se mostrará un GIF animado ilustrando el flujo interactivo de `InteractiveGitVersioneer`.
+
+![Demostración Rápida](docs/_assets/igv-quick_demo.gif)
+
+Gestor interactivo de versiones Git con soporte para tags, releases de GitHub y generación de mensajes con IA (Groq/OpenAI). Incluye modo CI/CD para pipelines automatizados.
+
+## Características Principales
+
+- **Gestión de Tags**: Menú guiado para crear y gestionar etiquetas de versión
+- **Gestión de Releases**: Crear releases en GitHub, generar changelogs
+- **Inspección Automática**: Detecta commits sin tag
+- **Simulación Segura**: Modos "dry run" para previsualizar cambios
+- **Generación con IA**: Integración Groq/OpenAI para mensajes automáticos
+- **Arquitectura Modular**: Sistema de menús extensible
+
+## Instalación Rápida
+
+**Requisitos:** Python >= 3.7, GitPython >= 3.1.0, openai >= 1.0.0
+**Opcional:** GitHub CLI (`gh`) para funciones de releases
+
+```bash
+git clone https://github.com/amillanaol/interactive-git-versioneer.git
+cd interactive-git-versioneer
+pip install -e .
+```
+
+## Uso Básico
+
+```bash
+# Ejecutar menú interactivo principal
+igv
+```
+> Para más comandos consultar el [artículo de comandos disponibles](./docs/comandos-disponibles.md)
+
+**Navegación rápida:** `Supr`/`Esc` para volver, `q` para salir.
+
+## Estructura del Menú
+
+```
+GESTOR DE VERSIONES GIT
+├── 1. Gestionar Commits
+│   ├── Ver lista de commits
+│   ├── Procesar commits individualmente
+│   ├── Ver preview de tags pendientes
+│   ├── Auto-generar todos los tags con IA
+│   ├── Aplicar tags
+│   └── Volver
+├── 2. Gestionar Tags
+│   ├── Ver último tag
+│   ├── Ver tags locales
+│   ├── Ver tags remotos
+│   ├── Modificar tag (submenú paginado)
+│   ├── Eliminar tag local
+│   ├── Eliminar tag remoto
+│   ├── Sincronizar con repositorio remoto
+│   ├── Generar tags con IA
+│   └── Volver al menú principal
+├── 3. Gestionar Releases
+│   ├── Autenticar con GitHub
+│   ├── Crear release en GitHub
+│   ├── Generar changelogs
+│   ├── Ver releases existentes
+│   ├── Modificar un release existente
+│   ├── Eliminar un release existente
+│   ├── Sincronizar con remoto
+│   └── Volver al menú principal
+├── 4. Gestionar Changelogs
+│   ├── Previsualizar changelog
+│   ├── Continuar changelog (manualmente)
+│   ├── Continuar changelog (automático con IA)
+│   ├── Modificar changelogs
+│   ├── Reconstruir todos los changelogs (con IA)
+│   └── Volver
+├── 5. Configuración
+│   ├── Ver configuración actual
+│   ├── Configurar IA (Groq/OpenAI)
+│   ├── Añadir alias 'igv' al sistema
+│   ├── Ayuda - Comandos CLI
+│   └── Volver al menú principal
+└── 6. Salir
+```
+
+## Documentación Completa
+
+- [Resumen de Documentación](./docs/01-entrada-navegacion/RESUMEN-DOCUMENTACION.md)
+- [Mapa Visual de Documentación](./docs/01-entrada-navegacion/MAPA-VISUAL-DOCUMENTACION.md)
+- [Changelog Completo](./docs/03-desarrollo/CHANGELOG.md)
+- [Documentación de Completitud](./docs/05-referencia/DOCUMENTACION-COMPLETADA.md)
+- [Migración de Nomenclatura](./docs/05-referencia/MIGRACION-NOMENCLATURA.md)
+
+### Documentación por Audiencia
+
+- [Guía de Uso - Comandos Básicos](./docs/02-usuario/usuario-inicio-comandos-basicos.md)
+- [Integración IA - Configuración Groq](./docs/04-configuracion/configuracion-ia-groq-integracion.md)
+- [Referencia - Menú Interactivo](./docs/02-usuario/usuario-referencia-menu-opciones.md)
+
+### Guías de Ejecución
+
+- [Instrucciones de Ejecución Real](./docs/guia-ejecucion-simulacion/instrucciones-ejecucion-real.md)
+- [Simulación "Dry Run"](./docs/guia-ejecucion-simulacion/simulacion-dry-run.md)
+- [Simulación "Full Dry Run"](./docs/guia-ejecucion-simulacion/simulacion-full-dry-run.md)
+
+### Estrategia de Versionado
+
+- [Plan de Etiquetado de Versiones](./docs/plan-versionado-analisis/plan-etiquetado-versiones.md)
+- [Resumen Visual de Versiones](./docs/plan-versionado-analisis/resumen-visual-versiones.md)
+
+## Licencia
+
+Este proyecto se distribuye bajo la Licencia MIT. Consulte el archivo [LICENSE](./LICENSE) para más información.
+
+## Contribuciones
+
+Las contribuciones son bienvenidas. Por favor, abra un *issue* para discutir los cambios propuestos o envíe un *pull request*.

interactive_git_versioneer-0.10.4/README.md

@@ -0,0 +1,124 @@
+# InteractiveGitVersioneer
+
+[![PyPI version](https://img.shields.io/pypi/v/interactive-git-versioneer.svg)](https://pypi.org/project/interactive-git-versioneer/)
+[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Build Status](https://github.com/amillanaol/interactive-git-versioneer/actions/workflows/auto-tag.yml/badge.svg)](https://github.com/amillanaol/interactive-git-versioneer/actions/workflows/auto-tag.yml)
+
+CLI para gestión de versiones semánticas con IA. Crea tags, genera changelogs y publica releases en GitHub de forma interactiva o automatizada.
+## Quick Demo
+
+Aquí se mostrará un GIF animado ilustrando el flujo interactivo de `InteractiveGitVersioneer`.
+
+![Demostración Rápida](docs/_assets/igv-quick_demo.gif)
+
+Gestor interactivo de versiones Git con soporte para tags, releases de GitHub y generación de mensajes con IA (Groq/OpenAI). Incluye modo CI/CD para pipelines automatizados.
+
+## Características Principales
+
+- **Gestión de Tags**: Menú guiado para crear y gestionar etiquetas de versión
+- **Gestión de Releases**: Crear releases en GitHub, generar changelogs
+- **Inspección Automática**: Detecta commits sin tag
+- **Simulación Segura**: Modos "dry run" para previsualizar cambios
+- **Generación con IA**: Integración Groq/OpenAI para mensajes automáticos
+- **Arquitectura Modular**: Sistema de menús extensible
+
+## Instalación Rápida
+
+**Requisitos:** Python >= 3.7, GitPython >= 3.1.0, openai >= 1.0.0
+**Opcional:** GitHub CLI (`gh`) para funciones de releases
+
+```bash
+git clone https://github.com/amillanaol/interactive-git-versioneer.git
+cd interactive-git-versioneer
+pip install -e .
+```
+
+## Uso Básico
+
+```bash
+# Ejecutar menú interactivo principal
+igv
+```
+> Para más comandos consultar el [artículo de comandos disponibles](./docs/comandos-disponibles.md)
+
+**Navegación rápida:** `Supr`/`Esc` para volver, `q` para salir.
+
+## Estructura del Menú
+
+```
+GESTOR DE VERSIONES GIT
+├── 1. Gestionar Commits
+│   ├── Ver lista de commits
+│   ├── Procesar commits individualmente
+│   ├── Ver preview de tags pendientes
+│   ├── Auto-generar todos los tags con IA
+│   ├── Aplicar tags
+│   └── Volver
+├── 2. Gestionar Tags
+│   ├── Ver último tag
+│   ├── Ver tags locales
+│   ├── Ver tags remotos
+│   ├── Modificar tag (submenú paginado)
+│   ├── Eliminar tag local
+│   ├── Eliminar tag remoto
+│   ├── Sincronizar con repositorio remoto
+│   ├── Generar tags con IA
+│   └── Volver al menú principal
+├── 3. Gestionar Releases
+│   ├── Autenticar con GitHub
+│   ├── Crear release en GitHub
+│   ├── Generar changelogs
+│   ├── Ver releases existentes
+│   ├── Modificar un release existente
+│   ├── Eliminar un release existente
+│   ├── Sincronizar con remoto
+│   └── Volver al menú principal
+├── 4. Gestionar Changelogs
+│   ├── Previsualizar changelog
+│   ├── Continuar changelog (manualmente)
+│   ├── Continuar changelog (automático con IA)
+│   ├── Modificar changelogs
+│   ├── Reconstruir todos los changelogs (con IA)
+│   └── Volver
+├── 5. Configuración
+│   ├── Ver configuración actual
+│   ├── Configurar IA (Groq/OpenAI)
+│   ├── Añadir alias 'igv' al sistema
+│   ├── Ayuda - Comandos CLI
+│   └── Volver al menú principal
+└── 6. Salir
+```
+
+## Documentación Completa
+
+- [Resumen de Documentación](./docs/01-entrada-navegacion/RESUMEN-DOCUMENTACION.md)
+- [Mapa Visual de Documentación](./docs/01-entrada-navegacion/MAPA-VISUAL-DOCUMENTACION.md)
+- [Changelog Completo](./docs/03-desarrollo/CHANGELOG.md)
+- [Documentación de Completitud](./docs/05-referencia/DOCUMENTACION-COMPLETADA.md)
+- [Migración de Nomenclatura](./docs/05-referencia/MIGRACION-NOMENCLATURA.md)
+
+### Documentación por Audiencia
+
+- [Guía de Uso - Comandos Básicos](./docs/02-usuario/usuario-inicio-comandos-basicos.md)
+- [Integración IA - Configuración Groq](./docs/04-configuracion/configuracion-ia-groq-integracion.md)
+- [Referencia - Menú Interactivo](./docs/02-usuario/usuario-referencia-menu-opciones.md)
+
+### Guías de Ejecución
+
+- [Instrucciones de Ejecución Real](./docs/guia-ejecucion-simulacion/instrucciones-ejecucion-real.md)
+- [Simulación "Dry Run"](./docs/guia-ejecucion-simulacion/simulacion-dry-run.md)
+- [Simulación "Full Dry Run"](./docs/guia-ejecucion-simulacion/simulacion-full-dry-run.md)
+
+### Estrategia de Versionado
+
+- [Plan de Etiquetado de Versiones](./docs/plan-versionado-analisis/plan-etiquetado-versiones.md)
+- [Resumen Visual de Versiones](./docs/plan-versionado-analisis/resumen-visual-versiones.md)
+
+## Licencia
+
+Este proyecto se distribuye bajo la Licencia MIT. Consulte el archivo [LICENSE](./LICENSE) para más información.
+
+## Contribuciones
+
+Las contribuciones son bienvenidas. Por favor, abra un *issue* para discutir los cambios propuestos o envíe un *pull request*.

interactive_git_versioneer-0.10.4/docs/api.md

@@ -0,0 +1,11 @@
+# API Reference
+
+Esta página usa `mkdocstrings` para renderizar la documentación de la API a partir de los docstrings.
+
+::: interactive_git_versioneer
+
+Si deseas limitar módulos o personalizar la vista, copia esta página y usa `:::` apuntando a módulos concretos, por ejemplo:
+
+```md
+::: interactive_git_versioneer.core.git_ops
+```

interactive_git_versioneer-0.10.4/docs/index.md

@@ -0,0 +1,17 @@
+# Interactive Git Versioneer
+
+Bienvenido a la documentación de **Interactive Git Versioneer**.
+
+Este sitio contiene:
+
+- Guía de uso rápida
+- Referencia API generada desde los docstrings (con mkdocstrings)
+
+Para generar la documentación localmente, instala las dependencias y ejecuta:
+
+```bash
+pip install mkdocs mkdocstrings[python]
+mkdocs serve
+```
+
+Consulta la sección **API** para la referencia automática de la librería.

interactive_git_versioneer-0.10.4/docs/modules/core_ai.md

@@ -0,0 +1,24 @@
+# Core: AI Helpers
+
+Descripción: utilidades para integrar con APIs de IA (OpenAI/Groq). Contiene funciones
+para crear el cliente y generar mensajes/tipos de versión.
+
+Funciones clave:
+
+- `get_openai_client()` — Inicializa y devuelve el cliente configurado.
+- `generate_tag_message(commit_message, commit_diff, version_type, ...)` — Genera un mensaje de tag.
+- `determine_version_type(commit_message, commit_diff)` — Clasifica (major/minor/patch) y devuelve una razón.
+
+Ejemplo de uso:
+
+```python
+from interactive_git_versioneer.core.ai import generate_tag_message, determine_version_type
+
+vtype, reason = determine_version_type("Add feature X", "diff...")
+msg = generate_tag_message("Add feature X", "diff...", vtype)
+print(vtype, reason)
+print(msg)
+```
+
+Notas:
+- Requiere configuración `OPENAI.key` y `OPENAI.baseURL` en la configuración del proyecto.

interactive_git_versioneer-0.10.4/docs/modules/core_git_ops.md

@@ -0,0 +1,24 @@
+# Core: Git Operations
+
+Descripción: funciones de bajo nivel para interactuar con repositorios Git (envolviendo GitPython).
+
+Funciones clave:
+
+- `get_git_repo()` — Obtiene el `Repo` actual (lanza SystemExit si no es repo).
+- `parse_version(tag)` — Parsea una etiqueta en `(major, minor, patch)`.
+- `get_last_tag(repo)` — Devuelve el último tag disponible.
+- `get_untagged_commits(repo)` — Lista commits posteriores al último tag.
+- `get_commit_diff(repo, commit_hash)` — Obtiene el diff de un commit.
+
+Ejemplo de uso:
+
+```python
+from interactive_git_versioneer.core.git_ops import get_git_repo, get_untagged_commits
+
+repo = get_git_repo()
+commits = get_untagged_commits(repo)
+for c in commits:
+    print(c.hash, c.message)
+```
+
+Consulta la sección **API** para detalles generados desde docstrings.

interactive_git_versioneer-0.10.4/docs/modules/releases.md

@@ -0,0 +1,18 @@
+# Releases: Gestión de releases y changelogs
+
+Descripción: herramientas para integrar con releases remotos (p. ej. GitHub) y generar changelogs.
+
+Funciones y flujos principales:
+
+- `run_releases_menu(repo)` — Menú interactivo para releases.
+- `run_changelog_submenu(repo)` — Submenú para generación/edición/guardado de changelogs.
+- `action_generate_all_changelogs_with_ai(repo, rebuild=False)` — Regenera changelogs usando IA.
+
+Ejemplo de uso (interactivo):
+
+```python
+from interactive_git_versioneer.tags.tagger import run_interactive_tagger
+run_interactive_tagger()
+```
+
+Consejo: Usa `mkdocstrings` API para ver firma completa y ejemplos de cada función.

interactive_git_versioneer-0.10.4/docs/modules/tagger.md

@@ -0,0 +1,17 @@
+# Tags: Tagger interactivo
+
+Descripción: interfaz y utilidades para gestionar tags localmente y en remoto.
+
+Funciones y comandos relevantes:
+
+- `run_interactive_tagger(dry_run=False, push=False)` — Interfaz principal interactiva.
+- `run_auto_tagger(dry_run=False, push=False, version_type="auto")` — Modo no interactivo (CI).
+- `manage_tags_interactive(repo, dry_run=False, push=False)` — Submenú para modificar tags.
+
+Ejemplo (modo automático):
+
+```bash
+igv tag --auto --push
+```
+
+Para más detalles de parámetros y retornos, revisa la referencia API.

interactive_git_versioneer-0.10.4/docs/troubleshooting-cicd.md

@@ -0,0 +1,48 @@
+# Guía de Resolución de Problemas CI/CD - Interactive Git Versioneer
+
+## ¿Qué necesito? → ¿Dónde lo busco?
+
+| Necesidad | Ubicación |
+|-----------|-----------|
+| Configurar API keys en GitHub | Repository Settings → Secrets and variables → Actions |
+| Ver configuración del workflow | [.github/workflows/auto-tag.yml](../.github/workflows/auto-tag.yml) |
+| Validar configuración local | `python -m interactive_git_versioneer.main config set` |
+| Ejecutar prueba local | `python -m interactive_git_versioneer.main tag --auto --dry-run` |
+
+## Configuración de Secrets en GitHub
+
+| Secreto | Valor Requerido | Propósito |
+|---------|----------------|-----------|
+| GROQ_API_KEY | API key de Groq | Autenticación con servicio IA |
+| (opcional) OPENAI.key | API key de OpenAI | Alternativa a Groq |
+
+### Pasos de Configuración
+
+1. Navegar al repositorio en GitHub
+2. Settings → Secrets and variables → Actions
+3. New repository secret
+4. Ingresar nombre y valor del secreto
+5. Confirmar creación
+
+## Problema → Solución
+
+| Problema | Solución |
+|----------|----------|
+| "Configuración de IA incompleta" | Verificar que GROQ_API_KEY exista en secrets de GitHub |
+| "Error: Process completed with exit code 1" | Validar formato correcto del workflow en líneas 26-30 |
+| Falla en paso "Configure API" | Confirmar variables de entorno en el contenedor CI/CD |
+| No se ejecuta tagging automático | Revisar permisos: contents: write en línea 12 |
+
+## Referencias del Código
+
+| Funcionalidad | Archivo | Línea |
+|---------------|---------|-------|
+| Workflow CI/CD | `.github/workflows/auto-tag.yml` | 26-37 |
+| Configuración API | Módulo main | Líneas config |
+| Ejecución tagging | Módulo main | Líneas tag |
+
+## Versión
+
+| Versión | Generado | Estado | Comentarios |
+|---------|----------|--------|-------------|
+| 1.0 | 2025-02-05 | Activo | Guía inicial para problemas CI/CD con secrets de GitHub |

interactive_git_versioneer-0.10.4/docs/usage.md

@@ -0,0 +1,31 @@
+# Uso rápido
+
+## Instalación
+
+1. Clona el repositorio
+2. Instala el paquete en editable (recomendado para desarrollo):
+
+```bash
+pip install -e .
+```
+
+## Comandos principales
+
+- `igv` — interfaz principal (menú interactivo)
+- `igv tag` — subcomandos de tagging (si están expuestos)
+
+## Configuración de IA (opcional)
+
+Configura las claves con `igv config set`:
+
+- `OPENAI.key` — API key
+- `OPENAI.baseURL` — URL base del proveedor
+
+## Generar documentación
+
+Instala MkDocs y mkdocstrings y ejecuta:
+
+```bash
+pip install mkdocs mkdocstrings[python]
+mkdocs build
+```

interactive_git_versioneer-0.10.4/jenkins/configure-igv.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# =============================================================================
+# Script de configuración post-despliegue para igv
+# Credenciales de API (Groq/OpenAI)
+# =============================================================================
+
+set -e
+
+VENV_DIR="/opt/igv/venv"
+
+# Activar entorno virtual
+source "${VENV_DIR}/bin/activate"
+
+# Configurar Groq API (las variables vienen de Jenkins credentials)
+if [ -n "${GROQ_API_KEY}" ]; then
+    echo "Configurando Groq API..."
+    igv config set OPENAI.key "${GROQ_API_KEY}"
+    igv config set OPENAI.baseURL "https://api.groq.com/openai/v1"
+    igv config set OPENAI.model "llama-3.3-70b-versatile"
+    echo "Configuración de API completada"
+else
+    echo "ADVERTENCIA: GROQ_API_KEY no está definida"
+fi
+
+# Mostrar configuración actual (sin mostrar la key completa)
+echo ""
+echo "Configuración actual:"
+igv config list
+
+deactivate