Installa TCAF

TCAF si installa una sola volta per computer come runtime versionato. Non deve essere copiato dentro ogni progetto e non dovrebbe essere aggiunto come seconda root del workspace accanto al software su cui stai lavorando.

Questa separazione mantiene indipendenti le istruzioni del framework e le evidenze del progetto, evitando che i file di TCAF vengano confusi con il codice target.

Prerequisiti

Prima dell’installazione verifica di avere:

• Python 3 disponibile come python o tramite il comando equivalente del tuo ambiente;
• una copia locale del repository della release TCAF;
• permessi di scrittura nelle directory utente usate per runtime e comando;
• la scelta dell’adapter da usare, oppure la possibilità di lasciare la selezione automatica.

Dalla root della release TCAF esegui:

python install.py

L’installer valida la release prima di copiarla. Una release non valida non viene installata.

Seleziona un adapter durante l’installazione

La selezione automatica è il comportamento predefinito:

python install.py --adapter auto

Puoi registrare un adapter specifico come preferenza attiva:

python install.py --adapter codex
python install.py --adapter cline
python install.py --adapter generic-cli
python install.py --adapter generic-chat

L’adapter non modifica il modello fondamentale di autorizzazione del framework. Cambia il modo in cui la Run Envelope raggiunge lo strumento host e il tipo di accesso diretto che quell’host può fornire.

Nella versione 0.3.3, il trasporto nativo Codex e Cline tramite la procedura documentata manual-envelope sono i percorsi verificati. Gli adapter generici sono rappresentati dal framework, ma non hanno ancora ricevuto la stessa copertura di accettazione.

Leggi Seleziona un adapter prima di scegliere un valore non predefinito.

Percorsi di installazione predefiniti

Se non specifichi override, l’installer usa percorsi a livello utente.

Su Linux e altri sistemi Unix-like:

Runtime home: ~/.local/share/tcaf
Comando:      ~/.local/bin/tcaf

Se XDG_DATA_HOME è impostata, il runtime viene collocato sotto quella directory.

Su macOS:

Runtime home: ~/Library/Application Support/tcaf
Comando:      ~/.local/bin/tcaf

Su Windows, TCAF usa la directory dati applicativi locale dell’utente e la directory degli script Python dell’utente.

Puoi modificare esplicitamente le destinazioni:

python install.py --home <runtime-home> --bin-dir <directory-comando>

Output atteso dell’installer

Un’installazione riuscita riporta:

• versione TCAF installata;
• percorso del runtime versionato attivo;
• percorso del launcher tcaf generato;
• eventuale azione necessaria sul PATH;
• tcaf doctor come controllo successivo.

Il runtime viene salvato in una directory specifica per la versione, invece di sostituire l’intera home di installazione:

<runtime-home>/versions/0.3.3

Questo permette di mantenere più versioni installate e attivarle esplicitamente.

Aggiungi la directory del comando al PATH quando richiesto

Se l’installer segnala un’azione sul PATH, aggiungi la directory del comando alla configurazione della shell e apri una nuova sessione del terminale.

In una tipica installazione Linux la directory è:

export PATH="$HOME/.local/bin:$PATH"

Rendi persistente la modifica nel file di configurazione appropriato per la tua shell, invece di applicarla soltanto al terminale corrente.

Verifica che il launcher sia visibile:

tcaf version

Verifica l’installazione

Esegui:

tcaf doctor

Un’installazione valida dovrebbe riportare PASS e identificare versione del framework, root del runtime, adapter selezionato e stato di installazione.

Continua con Esegui tcaf doctor per interpretazione e troubleshooting.

Reinstallare la stessa versione

Per impostazione predefinita l’installer rifiuta di sovrascrivere una versione già installata.

Usa --replace soltanto per una reinstallazione intenzionale della stessa versione:

python install.py --replace

Non usare --replace solo per nascondere un problema di installazione non compreso. Controlla prima la versione attiva ed esegui tcaf doctor.

Installa una volta, inizializza ogni progetto separatamente

L’installazione prepara il runtime sul computer. Non adotta e non avvia alcun progetto.

Per ogni progetto scegli un workflow iniziale:

tcaf bootstrap --target <nuovo-target> --request <richiesta-iniziale>
tcaf adopt --target <progetto-esistente>

Successivamente lo sviluppo ordinario procede tramite task delimitati.

Confine di sicurezza

Il framework installato deve rimanere fuori dal repository target. Non:

• copiare i moduli del framework nelle normali directory applicative;
• aggiungere il repository del framework come seconda root del workspace dell’editor;
• committare il runtime installato dentro un progetto;
• trattare i template del framework come evidenze correnti del progetto senza adoption o bootstrap.

Il progetto conserva le proprie evidenze canoniche. Il runtime installato fornisce le regole operative che le interpretano.