cv-disk-audit

cv-disk-audit — riconciliazione disk↔DB sui CV

Bug #26 ha mostrato il pattern: lo Scrittore genera il PDF, viene killato (EMERGENZA freeze 2026-05-17 04:43) prima dell'UPDATE DB. Il file resta su /jht_user/cv/, ma applications.cv_pdf_path resta NULL. Sisal 7.5/10 (top PASS della finestra) era diventato "CV da scrivere" sulla dashboard utente — invisibile.

Il fix preventivo (atomic write in cv-structure skill) impedisce nuovi orfani. Questa audit ricuce quelli già esistenti e cattura ogni nuova divergenza che dovesse comparire (es. utente sposta a mano un PDF, watchdog uccide il Writer durante il rename).

Quando lanciarla

Trigger Dottore (end-of-round, fuori budget critico):

• Sempre nel primo giro dopo un EMERGENZA / kill di uno Scrittore.
• Altrimenti ~ogni 4 giri Dottore (≈2h, dato il giro 30 min).

Il Dottore esegue questa skill DOPO liveness-check e PRIMA di cache-prune — l'audit è informativo, non distruttivo.

Procedura

# 1. Snapshot disk
DISK_PDFS=$(find /jht_user/cv -maxdepth 1 -type f -name '*.pdf' 2>/dev/null | sort)

# 2. Snapshot DB (cv_pdf_path != NULL)
DB_PDFS=$(python3 /app/shared/skills/db_query.py cv-pdf-paths 2>/dev/null | sort)

# 3. Diff
ORFANI=$(comm -23 <(echo "$DISK_PDFS") <(echo "$DB_PDFS"))     # disk ma non DB
GHOST=$(comm -13 <(echo "$DISK_PDFS") <(echo "$DB_PDFS"))      # DB ma non disk

# 4. Report al Capitano (deterministico, niente LLM)
if [ -n "$ORFANI$GHOST" ]; then
  msg="[@dottore -> @capitano] [REPORT] CV audit mismatch — "
  msg="${msg}orfani=$(echo "$ORFANI" | grep -c .) "
  msg="${msg}ghost=$(echo "$GHOST" | grep -c .)"
  jht-tmux-send CAPITANO "$msg"
  # Log dettagli
  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
  echo "{\"ts\":\"$ts\",\"orfani\":$(echo "$ORFANI" | jq -R . | jq -s .),\"ghost\":$(echo "$GHOST" | jq -R . | jq -s .)}" \
    >> /jht_home/logs/cv-disk-audit.jsonl
fi

db_query.py cv-pdf-paths (da implementare): scrive 1 path per riga di tutte le applications con cv_pdf_path IS NOT NULL. Una linea script-friendly per il comm.