Esegui tcaf doctor

Esegui tcaf doctor subito dopo l’installazione e ogni volta che possono essere cambiati runtime attivo, selezione dell’adapter o file del framework.

tcaf doctor

Il comando valida il runtime attivo del framework e descrive l’ambiente che TCAF userà per le operazioni successive.

Cosa controlla doctor

L’implementazione corrente riporta:

• se la validazione del framework è riuscita;
• versione attiva del framework;
• root del framework risolta dal launcher;
• adapter selezionato tramite la risoluzione automatica;
• se il comando viene eseguito da un launcher installato;
• versione installata attiva e elenco delle versioni disponibili;
• errori, warning e dettagli delle issue di validazione.

doctor valida il runtime del framework. Non valida la documentazione canonica di un progetto target.

Per validare anche un progetto usa:

tcaf validate --target <percorso-progetto>

Output testuale atteso

Un runtime valido inizia con:

PASS
Errors: 0  Warnings: 0

Un fallimento inizia con FAIL ed elenca ogni problema con livello, codice, messaggio e percorso pertinente quando disponibile.

Il comando restituisce un exit code diverso da zero quando la validazione fallisce, quindi può essere usato anche da script o controlli CI.

Output JSON

Per una diagnostica leggibile da altri strumenti esegui:

tcaf doctor --format json

Il risultato JSON contiene gli stessi dati su framework, adapter, installazione e issue senza la formattazione testuale destinata al developer.

Usa JSON quando un altro strumento deve elaborare l’esito. Usa il formato testuale per la verifica diretta.

Come viene selezionato l’adapter

doctor richiede la risoluzione automatica dell’adapter. Il registro valuta gli input in questo ordine:

1. adapter ID fornito dall’integrazione host;
2. variabile d’ambiente TCAF_ADAPTER;
3. rilevamento dell’ambiente;
4. adapter predefinito del registro.

L’adapter mostrato è quindi quello che TCAF sceglierebbe attualmente senza un override esplicito sul singolo comando.

Leggi Seleziona un adapter se il risultato non è quello atteso.

Categorie di errore comuni

Il comando tcaf non viene trovato

Probabilmente la directory del launcher non è nel PATH, oppure la sessione della shell è stata aperta prima della modifica alla configurazione.

Controlla la posizione del comando indicata dall’installer e apri un nuovo terminale dopo aver aggiornato la configurazione della shell.

La root del framework non è quella attesa

Il launcher può puntare a una home di installazione o a una versione attiva diversa da quella prevista.

Controlla:

tcaf version
tcaf versions

Poi, se necessario, attiva esplicitamente la versione installata corretta.

La validazione segnala file mancanti o incoerenti

Non ignorare il risultato procedendo con un task. Il runtime attivo può essere incompleto, modificato manualmente o non coerente con registri e manifest.

Reinstalla deliberatamente la release prevista, usando --replace soltanto dopo aver identificato la versione che stai sostituendo.

L’adapter non è quello previsto

Controlla:

• adapter fornito dall’integrazione host;
• variabile d’ambiente TCAF_ADAPTER;
• variabili usate per il rilevamento dell’ambiente;
• adapter registrato durante l’installazione;
• eventuale override --adapter sull’operazione che intendi eseguire.

Non cambiare adapter soltanto per rendere il risultato più familiare. Scegli quello coerente con l’host reale e con il trasporto verificato.

Cosa non dimostra doctor

Un risultato PASS conferma che il runtime corrente del framework è internamente valido. Non dimostra che:

• un progetto target abbia adottato correttamente TCAF;
• un modello seguirà ogni istruzione;
• un adapter disponga dell’accesso corretto al target;
• i comandi specifici del progetto passeranno;
• ogni workflow sia verificato per la combinazione corrente di modello e host.

Queste garanzie richiedono validazione del target, esecuzione delimitata, evidenze e review del developer.

Sequenza consigliata

Dopo l’installazione:

tcaf doctor
tcaf version
tcaf validate

Prima di lavorare su un progetto esistente:

tcaf validate --target <percorso-progetto>

Se la validazione del target fallisce perché il progetto non ha ancora adottato TCAF, usa il workflow di adozione invece di ricostruire manualmente i documenti di progetto affidandoti alla memoria.