Doc cli README

Copia di cli/README.md — torna a Documenti · Home

Triad CLI

CLI unificata per gli strumenti di sviluppo del progetto Triad 2.0.

Installazione

cd cli
npm install

Per usare la CLI da qualsiasi directory, aggiungi bin/ al PATH e usa i launcher bin/triad-cli (POSIX) o bin\triad-cli.cmd (Windows): al primo avvio eseguono npm install in cli/ se manca node_modules. In alternativa npm link (Linux/macOS).

Eseguibile standalone

triad-cli.exe (Windows) e triad-cli (Linux) sono allegati alla release beta: contengono Node.js e la CLI, quindi non serve npm install. Copiali nella root del repository o in bin/ (oppure imposta TRIAD_HOME): la CLI trova il progetto risalendo da TRIAD_HOME, dalla posizione dell'eseguibile e dalla cartella corrente. test, seed generate richiedono comunque node nel PATH, perché eseguono conformance/run.mjs e seed/dev/*.js.

Per ricostruirli (Node.js >= 20; il binario Node passato decide la piattaforma):

cd cli
npm install
npm run build:exe                         # eseguibile per la piattaforma corrente
node build-exe.mjs path/to/win/node.exe   # triad-cli.exe per Windows (anche da Linux)

Comandi

Status

Mostra lo stato del progetto e informazioni sull'ambiente:

triad-cli status

Output esempio:

Triad 2.0 CLI Status

Environment:
  Node.js: v24.22.0
  Platform: win32
  Seed: C:\Users\xbos\Documents\progetti\triad2.0\seed\windows-x86_64\seed.exe

Project:
  Root: C:\Users\xbos\Documents\progetti\triad2.0

Seed Generation

Genera i seed binari per Windows o Linux:

triad-cli seed generate windows    # Genera seed Windows
triad-cli seed generate linux      # Genera seed Linux

Opzioni:

• -o, --output <path> - Percorso di output del file hex (default: seed/<platform>-x86_64/seed.hex)

AI Verification

Verifica le soluzioni generate da LLM contro i test golden:

triad-cli ai verify

Opzioni:

• -t, --tasks <dir> - Directory dei task (default: ai/tasks)
• -v, --verbose - Output dettagliato

Build Standalone

Compila l'eseguibile standalone di Triad:

triad-cli build standalone

Test

Esegue i test unitari:

triad-cli test run

Opzioni:

• -v, --verbose - Output dettagliato

Esegue la conformance suite:

triad-cli test conformance

Opzioni:

• -u, --update - Aggiorna i golden output (solo sviluppo)
• -c, --cases <path> - Directory specifica dei casi

Requisiti

• Node.js ≥ 18.0.0
• Seed in codice macchina (runtime predefinito per .triad)

Architettura

La CLI è strutturata in moduli:

cli/
├── triad-cli.mjs           # Entry point principale
├── package.json            # Dipendenze Node.js
├── lib/
│   ├── utils.mjs           # Funzioni utility (trova seed, esegui script)
│   └── commands/
│       ├── seed.mjs        # Generazione seed
│       ├── ai.mjs          # Verifica AI
│       ├── build.mjs       # Build standalone
│       └── test.mjs        # Test e conformance
└── README.md               # Questa documentazione

Vantaggi

• Interfaccia unificata: Un singolo comando per tutte le operazioni di sviluppo
• Cross-platform: Node.js gestisce differenze Windows/Linux/macOS
• Estensibile: Facile aggiungere nuovi comandi
• Non invasivo: Non modifica i tool esistenti, li wrappa solo

Note

• Il runtime per eseguire programmi Triad è il seed in codice macchina (o bin/triad-native); usa triad/triad.cmd o triad-cli per le operazioni di sviluppo