Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.3.3

Riferimento CLI

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

Contenuto: completeWorkflow: verified

Il comando tcaf espone operazioni pubbliche senza richiedere all’utente di selezionare manualmente i file del framework.

Operazioni di progetto

tcaf bootstrap --target <target> [--request <testo> | --input <risorsa>]
tcaf adopt --target <target> [--request <testo> | --input <risorsa>]
tcaf task --target <target> (--request <testo> | --input <risorsa>)
  • bootstrap prepara un nuovo progetto o target partendo da idea, analisi, scaffold, roadmap o primo task.
  • adopt osserva un progetto esistente e stabilisce evidenze canoniche.
  • task prepara un singolo task delimitato di sviluppo o documentazione. Richiede --request oppure --input.

Esecuzione diretta di un agente

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

Usa run soltanto per un agent ID pubblico registrato. Nell’uso normale preferisci le operazioni nominate.

Argomenti condivisi

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

Selettori sconosciuti o in numero superiore al massimo falliscono esplicitamente.

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 canonica del progetto.
  • doctor riporta validità, versione, root del runtime, adapter selezionato e stato di installazione.

Versioni

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

activate valida il runtime installato selezionato prima di modificarne lo stato attivo. Fallisce quando il launcher non è installato oppure la versione manca o non è valida.

Comportamento in uscita

Errori operativi o di validazione restituiscono un exit code non zero e stampano TCAF error oppure gli issue di validazione. Non interpretare il Markdown generato come prova che lo strumento host abbia eseguito il task: è la Run Envelope da trasportare nell’adapter selezionato.