Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.4.0 · anteprima pubblica

Riferimento CLI

Riferimento per operazioni pubbliche, argomenti condivisi, diagnostica e comandi versione di TCAF 0.4.0.

Il comando tcaf espone operazioni nominate, così l’utente non deve selezionare manualmente file interni del framework.

Operazioni principali di progetto

tcaf bootstrap --target <target> [--request <testo> | --input <risorsa>]
tcaf adopt --target <target> [--request <testo> | --input <risorsa>]
tcaf plan --target <target> (--request <testo> | --input <risorsa>)
tcaf task --target <target> (--request <testo> | --input <risorsa>)
tcaf sync --target <target> [--request <testo> | --input <risorsa>]
  • bootstrap — stabilisce lo stato minimo utile di un nuovo progetto a partire dalla source evidence disponibile.
  • adopt — ispeziona un progetto esistente preservando codice applicativo, storia e materiale sorgente.
  • plan — scompone lavoro più ampio in un piano dependency-aware e revisionabile senza implementazione.
  • task — prepara un singolo Task Contract delimitato per review ed esecuzione approvata.
  • sync — rilegge le evidenze correnti e propone una riconciliazione delimitata dopo cambiamenti fuori dall’esecuzione.

Esecuzione diretta avanzata di un agente

tcaf run <agent-id> --target <target> [--request <testo> | --input <risorsa>]

Usa run soltanto con un agent ID pubblico registrato. Nell’uso normale preferisci le cinque operazioni di progetto nominate sopra.

Argomenti condivisi

  • --target — un solo target di progetto; usa la directory corrente come default quando consentito.
  • --request — richiesta inline.
  • --input — una risorsa sorgente supportata; mutuamente esclusiva con --request.
  • --context <selettore> — aggiunge un modulo di contesto opzionale dichiarato entro il limite del manifest dell’agente.
  • --adapter <id> — forza la selezione dell’adapter. Default: auto.
  • --format markdown|json — formato di output. Default: markdown.

Scoperta e validazione

tcaf list [--format text|json]
tcaf validate [--target <progetto>] [--format text|json]
tcaf doctor [--format text|json]
  • list mostra operazioni e agenti pubblici registrati.
  • validate controlla il framework attivo e, opzionalmente, la documentazione del progetto target.
  • doctor riporta validità del framework, versione, root del runtime, adapter e stato di installazione.

Versioni

tcaf version [--format text|json]
tcaf versions [--format text|json]
tcaf activate <versione>

activate valida il runtime installato prima di modificare la versione attiva.

Comportamento in uscita

Errori operativi o di validazione restituiscono un exit code non zero. Una Run Envelope generata non è prova che l’host abbia eseguito l’operazione; le evidenze realmente eseguite devono essere riportate separatamente.