78 lines
2.3 KiB
Markdown
78 lines
2.3 KiB
Markdown
|
---
|
||
|
|
description: Legge il report di step 6, mostra le fix pianificate e le applica su approvazione tramite fix_chunks.py.
|
||
|
|
allowed-tools: Read Bash Grep
|
||
|
|
argument-hint: <stem>
|
||
|
|
---
|
||
|
|
|
||
|
|
Leggi e interpreta `step-6/$ARGUMENTS/report.json`.
|
||
|
|
|
||
|
|
**Report:**
|
||
|
|
!`cat step-6/$ARGUMENTS/report.json 2>/dev/null || echo "ERRORE: report.json non trovato — esegui prima: python step-6/verify_chunks.py --stem $ARGUMENTS"`
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
In base al contenuto del report, segui le istruzioni qui sotto.
|
||
|
|
|
||
|
|
## Se verdict == "ok"
|
||
|
|
|
||
|
|
Non c'è nulla da fare. Comunica all'utente che può procedere:
|
||
|
|
|
||
|
|
```
|
||
|
|
✅ Nessun problema — procedi con la vettorizzazione:
|
||
|
|
python step-8/ingest.py --stem $ARGUMENTS
|
||
|
|
```
|
||
|
|
|
||
|
|
## Se verdict == "warnings_only" o "blocked"
|
||
|
|
|
||
|
|
### Passo 1 — Mostra le fix pianificate (dry-run)
|
||
|
|
|
||
|
|
Esegui il dry-run e mostra l'output all'utente:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
source .venv/bin/activate && python step-6/fix_chunks.py --stem $ARGUMENTS --dry-run
|
||
|
|
```
|
||
|
|
|
||
|
|
Spiega brevemente cosa farà ogni operazione:
|
||
|
|
- **rimuovi chunk vuoti**: elimina chunk senza testo
|
||
|
|
- **aggiungi prefisso**: inserisce `[sezione > titolo]` dove manca
|
||
|
|
- **fondi incompleti**: unisce i chunk con frase spezzata al chunk successivo
|
||
|
|
- **fondi troppo corti**: unisce chunk < 200 char con il successivo
|
||
|
|
- **spezza troppo lunghi**: divide chunk > 1200 char al confine di paragrafo/frase
|
||
|
|
|
||
|
|
### Passo 2 — Chiedi conferma
|
||
|
|
|
||
|
|
Chiedi all'utente: **"Applico le correzioni?"**
|
||
|
|
|
||
|
|
Applica solo su approvazione esplicita.
|
||
|
|
|
||
|
|
### Passo 3 — Applica e ri-verifica
|
||
|
|
|
||
|
|
```bash
|
||
|
|
source .venv/bin/activate
|
||
|
|
python step-6/fix_chunks.py --stem $ARGUMENTS
|
||
|
|
python step-6/verify_chunks.py --stem $ARGUMENTS
|
||
|
|
```
|
||
|
|
|
||
|
|
Leggi il nuovo `step-6/$ARGUMENTS/report.json` e comunica:
|
||
|
|
- Il nuovo verdict
|
||
|
|
- Quanti warning/blockers residui rimangono
|
||
|
|
- Se il verdict è `ok` o `warnings_only` senza blockers: comunica che si può procedere con step-8
|
||
|
|
|
||
|
|
## Dopo le correzioni
|
||
|
|
|
||
|
|
Se il verdict finale è `ok`:
|
||
|
|
|
||
|
|
```
|
||
|
|
✅ chunks.json pulito salvato in step-6/$ARGUMENTS/
|
||
|
|
Procedi con la vettorizzazione:
|
||
|
|
python step-8/ingest.py --stem $ARGUMENTS
|
||
|
|
```
|
||
|
|
|
||
|
|
Se rimangono warning minori (too_short/too_long non risolvibili perché testo non spezzabile):
|
||
|
|
|
||
|
|
```
|
||
|
|
🟡 X warning residui non risolvibili automaticamente (testo non spezzabile).
|
||
|
|
Puoi procedere comunque con la vettorizzazione:
|
||
|
|
python step-8/ingest.py --stem $ARGUMENTS
|
||
|
|
```
|