Installa TCAF

TCAF si installa una sola volta per computer come runtime versionato. Rimane fuori dai repository applicativi, così le istruzioni del framework restano separate dalle evidenze del progetto.

Prerequisiti

Servono:

• Python 3;
• una copia locale del repository della release TCAF;
• permessi di scrittura nelle directory utente usate per runtime e comando.

Dalla root della release TCAF esegui:

python install.py --adapter auto

L’installer valida la release prima di installarla.

Scegli un adapter

La selezione automatica è il default. Puoi anche registrare una preferenza:

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

Nella v0.4.0 l’uso nativo di Codex è verificato. Il percorso manual-envelope documentato per Cline è verificato con limitazioni. Le combinazioni più ampie con host generici non hanno ancora una copertura di accettazione equivalente.

Consulta Seleziona un adapter.

Percorsi di installazione predefiniti

Percorsi utente tipici:

Runtime Linux: ~/.local/share/tcaf
Runtime macOS: ~/Library/Application Support/tcaf
Comando:       ~/.local/bin/tcaf

Windows usa le directory dati applicativi locali e degli script Python dell’utente.

Puoi modificare esplicitamente le destinazioni:

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

Un runtime v0.4.0 viene salvato in una directory specifica per la versione, per esempio:

<runtime-home>/versions/0.4.0

Verifica l’installazione

Se necessario aggiungi la directory del comando al PATH, poi esegui:

tcaf version
tcaf doctor

Un’installazione corretta dovrebbe riportare PASS e identificare versione attiva, root del runtime e adapter.

Reinstalla la stessa versione

Per impostazione predefinita l’installer non sovrascrive una versione installata. Solo per una reinstallazione intenzionale:

python install.py --replace

Quando stai diagnosticando un problema non compreso, esegui prima tcaf doctor.

Installa una volta, poi lavora progetto per progetto

Per ogni progetto parti da uno di questi comandi:

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

Poi usa tcaf plan per lavoro da scomporre, tcaf task per una singola modifica delimitata e tcaf sync quando lo stato del progetto cambia fuori dall’esecuzione corrente.

Il normale materiale di progetto resta source evidence: non deve essere riscritto in un formato specifico TCAF prima di bootstrap o adoption.

Confine di sicurezza

Non copiare il framework installato dentro il repository applicativo e non trattare i template del framework come verità di progetto. Il runtime fornisce le regole TCAF; il progetto target fornisce le evidenze sul software.