Skip to content

Add metadelta:gitanalyze — Git integrity analysis with detectors, scoring, reports and optional AI#55

Open
NerioVillalobos wants to merge 4 commits intomasterfrom
codex/develop-git-repository-analysis-command
Open

Add metadelta:gitanalyze — Git integrity analysis with detectors, scoring, reports and optional AI#55
NerioVillalobos wants to merge 4 commits intomasterfrom
codex/develop-git-repository-analysis-command

Conversation

@NerioVillalobos
Copy link
Owner

Motivation

  • Proveer un comando profesional para analizar un repositorio Git local y detectar malas integraciones sin clonar ni usar red.
  • Implementar una arquitectura extensible con separación clara entre extractor, detectores, scoring, generador de reporte y módulo de IA.
  • Entregar salida lista para pipelines y CLI en JSON y Markdown y una alternativa standalone en Python.
  • Permitir explicaciones humanas mediante LLMs sin que la IA analice el repo directamente, usando datos estructurados.

Description

  • Añade el módulo src/git-integrity/ (y su versión compilada en lib/git-integrity/) con constants.js, git.js, extractor.js, detectores (directCommits, mergeCommits, largeCommits, suspiciousPatterns, historyRewrite), scoring.js, report.js y ai.js que implementan extracción de git log/reflog, detección de eventos y scoring explicable.
  • Agrega el comando CLI sf metadelta gitanalyze en src/commands/metadelta/gitanalyze.js (registrado en oclif.manifest.json) que produce JSON y/o Markdown y admite flags para umbrales y para habilitar IA (--ai y OPENAI_API_KEY).
  • Incorpora un script standalone Python scripts/git-integrity-standalone.py que replica las mismas reglas y salidas para entornos de CI que prefieren Python.
  • Documenta la arquitectura, el prompt reutilizable para IA, ejemplos de uso y la invocación standalone en README.md.

Testing

  • No se ejecutaron pruebas automatizadas como parte de este cambio.
  • Recomendación: ejecutar npm run build y luego probar localmente el comando con sf plugins link . y sf metadelta gitanalyze --repo . --output-dir reports/git para una verificación funcional.
  • Para validación de IA, exportar OPENAI_API_KEY y usar --ai en entorno controlado; el módulo IA exige OPENAI_API_KEY y --ai para realizar llamadas.
  • Recomiendo añadir en seguimiento tests unitarios para detectores y un test de integración que ejecute el flujo completo en un repositorio de ejemplo.

Codex Task

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant