docs: add git history tracking document

- Create comprehensive git history documentation
- Track all commits with dates, authors, and types
- Include sprint history section
- Add statistics and update instructions
- Maintainable format for future updates
This commit is contained in:
Luca Sacchi Ricciardi
2026-04-02 16:30:44 +02:00
parent 702f50cc30
commit a510d5fc68

175
docs/git-history.md Normal file
View File

@@ -0,0 +1,175 @@
# Git History - LogWhisperer AI
**Repository:** LogWhisperer AI
**Branch Principale:** `main`
**Ultimo Aggiornamento:** 2026-04-02
---
## Indice
- [Panoramica](#panoramica)
- [Commit Recenti](#commit-recenti)
- [Cronologia Completa](#cronologia-completa)
- [Statistiche](#statistiche)
---
## Panoramica
Questo documento traccia la storia dei commit del progetto LogWhisperer AI. Viene aggiornato periodicamente per riflettere l'evoluzione del codebase.
### Convenzioni di Commit
Questo progetto segue le [Conventional Commits](https://www.conventionalcommits.org/):
- `feat:` - Nuove funzionalità
- `fix:` - Correzioni di bug
- `docs:` - Documentazione
- `test:` - Test
- `refactor:` - Refactoring codice
- `chore:` - Manutenzione e configurazione
---
## Commit Recenti
### 🔖 Versione 0.1.0 (2026-04-02)
#### chore: add project configuration and agent skills
- **Hash:** `702f50c`
- **Autore:** Luca Sacchi Ricciardi
- **Data:** 2026-04-02
**Modifiche:**
- Aggiunto `requirements.txt` con dipendenze pytest e requests
- Aggiunta skill TDD Python Specialist per workflow test-driven
- Aggiunta skill Git & Changelog per conventional commits
- Configurata struttura directory `.opencode/skills/`
---
#### docs: add Sprint 1 verification report
- **Hash:** `7def307`
- **Autore:** Luca Sacchi Ricciardi
- **Data:** 2026-04-02
**Modifiche:**
- Creato rapporto verifica completo Sprint 1
- Documentati risultati test (12/12 superati)
- Inclusa checklist criteri di accettazione
- Aggiunti audit sicurezza e valutazione qualità codice
- Aggiornato CHANGELOG.md
---
#### feat(ingestion): implement log monitoring script with webhook integration
- **Hash:** `69f475e`
- **Autore:** Luca Sacchi Ricciardi
- **Data:** 2026-04-02
**Modifiche:**
- Implementato script `logwhisperer.sh` per monitoraggio log
- Aggiunto pattern matching per errori critici (FATAL, ERROR, OOM, segfault, disk full)
- Implementata generazione payload JSON con livelli di severità
- Aggiunto rate limiting (30s per source)
- Implementato offset tracking per evitare reprocessing
- Aggiunto dispatch HTTP POST a webhook configurabile
- Creata modalità dry-run per testing
- Supporto configurazione via file (`/etc/logwhisperer/config.env`)
- Implementati flag CLI: `--help`, `--validate`, `--config`, `--dry-run`, `--test-line`
- Creato script di installazione `install.sh`
---
## Cronologia Completa
| Hash | Data | Tipo | Messaggio | Autore |
|------|------|------|-----------|--------|
| `702f50c` | 2026-04-02 | chore | add project configuration and agent skills | Luca Sacchi Ricciardi |
| `7def307` | 2026-04-02 | docs | add Sprint 1 verification report | Luca Sacchi Ricciardi |
| `69f475e` | 2026-04-02 | feat | implement log monitoring script with webhook integration | Luca Sacchi Ricciardi |
| `34dbba1` | 2026-04-02 | docs | Update README.md | lucasacchi |
| `40abdd5` | 2026-04-02 | docs | Update README.md | lucasacchi |
| `d907738` | 2026-04-02 | docs | Update README.md | lucasacchi |
| `c669273` | 2026-04-02 | docs | Update README.md | lucasacchi |
| `7b2b7fc` | 2026-04-02 | docs | Update README.md | lucasacchi |
| `ed6185b` | 2026-04-02 | docs | Update README.md | lucasacchi |
| `adfdec4` | 2026-04-02 | chore | chores on README.md | Luca Sacchi Ricciardi |
| `7a3f084` | 2026-04-02 | docs | Update LICENSE.md | lucasacchi |
| `7da30cb` | 2026-04-02 | docs | added license.md | Luca Sacchi Ricciardi |
| `df75e51` | 2026-04-02 | setup | added venv, created and documented setup's procedure, added agents.md | Luca Sacchi Ricciardi |
| `e1fc873` | 2026-04-02 | chore | chores, add prompt for project management | Luca Sacchi Ricciardi |
| `1cf076b` | 2026-04-02 | docs | added prd.md | Luca Sacchi Ricciardi |
---
## Sprint History
### Sprint 1: Log Ingestion Script ✅
**Periodo:** 2026-04-02
**Status:** Completato
**Commit Principale:** `69f475e`
**Deliverable:**
- Script Bash di log ingestion
- Test suite Python (12 test)
- Specifica tecnica
- Script di installazione
**Verifica:** Documento `docs/sprint1_verification.md` (commit `7def307`)
---
## Statistiche
### Totale Commit: 15
**Per Tipo:**
- `feat:` 1 (7%)
- `docs:` 10 (67%)
- `chore:` 3 (20%)
- `setup:` 1 (7%)
**Per Autore:**
- Luca Sacchi Ricciardi: 9 commit (60%)
- lucasacchi: 6 commit (40%)
**Timeline:**
- **2026-04-02:** 15 commit (inizio progetto, setup, Sprint 1)
---
## Come Aggiornare Questo Documento
Per aggiornare questo documento dopo nuovi commit:
```bash
# Ottieni la storia aggiornata
git log --pretty=format:"%h|%ad|%s|%an" --date=short
# Aggiungi i nuovi commit in cima alla sezione "Cronologia Completa"
# Aggiorna la sezione "Commit Recenti"
# Aggiorna le statistiche
```
---
**Nota:** Questo documento viene mantenuto manualmente. Per la storia completa e dettagliata, usare:
```bash
# Storia completa
git log --all --graph --decorate --oneline
# Storia con file modificati
git log --stat
# Storia di un file specifico
git log --follow -- <file>
```
---
*Documento creato da OpenCode Agent*
*Ultima modifica: 2026-04-02*