test: hardening CI path semantics per candidate depth-2, sources depth-3, support dataset

[matteocavo]

Closes #54

Cosa cambia

toolkit/core/config_models.py

• aggiunge repo_root come parametro opzionale in DatasetConfig
• se passato, valida che effective_root resti dentro la repo e fallisce con errore esplicito se esce
• docstring esplicito: il guard è pensato per caller esterni (CI di monorepo come dataset-incubator), non è un cambio di semantica globale del toolkit

toolkit/core/config.py

• espone repo_root tramite load_config(..., repo_root=...)

tests/test_config.py

• layout reali coperti: candidate depth-2, sources/* depth-3, support dataset
• path assoluto dentro repo: ammesso
• path fuori repo: fallisce con errore esplicito
• comportamento senza guard: invariato (retrocompatibilità)

Perché

Il bug post-rename in dataset-incubator (PR #52) ha dimostrato che la semantica di effective_root può rompersi silenziosamente. Il guard aggiunge enforcement opzionale nei contesti CI senza toccare il comportamento standard.

Il collegamento operativo lato dataset-incubator è tracciato in dataciviclab/dataset-incubator#82 (già implementato in PR #83).

Verifica

• pytest: 184 passed
• ruff: pulito

[matteocavo]

@Gabrymi93 pronta per review.

Il guard repo_root è opzionale — zero behavior change per i caller esistenti. Copre i layout reali dell'incubator (candidate depth-2, sources depth-3, support dataset).

Note pre-review:

• il codice reviewer interno ha segnalato 2 HIGH da valutare: doppia resolve in _ensure_root_within_repo e assenza di check is_dir() su repo_root. Possiamo fixarli prima o durante la review, come preferisci.

Closes #54

[matteocavo]

Review mirata su `repo_root` guard e test path semantics fatta.

Esito:

• nessun finding HIGH/CRITICAL su questo scope
• ok la rimozione della doppia `resolve()` dentro `_ensure_root_within_repo`
• ok il check esplicito `repo_root.is_dir()` alla call site
• copertura test sufficiente per:
  • candidate depth-2
  • sources depth-3
  • support_datasets
  • root assoluto valido dentro repo
  • root fuori repo con guard
  • retrocompatibilità senza guard

Verifiche locali:

• `pytest tests/test_config.py -q` → 57 passed
• `ruff check toolkit/core/config.py toolkit/core/config_models.py tests/test_config.py` → pulito

Nota non bloccante:

• manca un test dedicato al ramo `repo_root does not exist or is not a directory`, eventualmente da aggiungere dopo il merge

[Gabrymi93]

Top!