Modalità CLI compatibile con l’AI

L’output di testo predefinito di babel.exe non cambia e resta pienamente compatibile con le versioni precedenti: gli script di CI e le integrazioni dei clienti già esistenti non richiedono modifiche.

La modalità compatibile con l’AI si attiva con tre nuove opzioni globali:

• --format=text|json|ndjson: seleziona il formato del canale di output
• --quiet (alias -q): sopprime il banner del logo e termina subito con un errore davanti alle richieste interattive
• --strict-exit: attiva i codici di uscita semantici

Quando è selezionato --format=json o --format=ndjson, stdout trasporta il flusso strutturato e la diagnostica leggibile dalle persone viene indirizzata su stderr, così i due canali non si mescolano mai.

Opzioni

—format <format>

Seleziona il formato di output usato su stdout. Valori ammessi:

Esempi:

babel myapp.exe --format=json > result.json
babel myapp.exe --format=ndjson | jq -c 'select(.level=="error")'

—quiet (-q)

Sopprime il banner con copyright e logo e cambia il comportamento delle richieste interattive di password: invece di restare in attesa su Console.In, Babel termina subito con un errore esplicito. In questo modo --quiet è sicuro per le esecuzioni non presidiate avviate da runner di CI, passi di build nei container e agenti AI.

babel myapp.exe --quiet --keyfile mykey.pfx --keypwd env:KEY_PWD

--quiet è indipendente da --format: puoi combinarlo con l’output text tradizionale per mantenere log leggibili dalle persone senza il banner.

—strict-exit

Attiva per il processo i codici di uscita semantici. Senza questa opzione, Babel mantiene il contratto tradizionale, in cui 0 indica il successo e 1 qualsiasi errore.

La classificazione è riportata anche come exitReason nel record di risultato JSON/NDJSON (vedi Envelope del risultato), anche quando --strict-exit non è attivo, così i consumer possono distinguere le categorie di errore indipendentemente dal codice di uscita numerico.

babel myapp.exe --strict-exit --format=json
echo "exit=$?"

Schema: babel.cli.v1

Tutti i payload strutturati sono conformi allo schema versionato babel.cli.v1. All’interno di una versione principale dello schema sono ammesse le modifiche additive (nuovi campi, nuovi codici di evento, nuovi motivi di uscita); le modifiche incompatibili comportano un nuovo nome dello schema.

Record di evento

Ogni messaggio di diagnostica emesso durante un’esecuzione viene associato a un evento:

{
  "ts":      "2026-05-08T14:32:11.482Z",
  "level":   "info",
  "code":    "BAB1234",
  "message": "Renaming phase, elapsed time 00.082s",
  "data":    { "phase": "renaming", "elapsedMs": 82 }
}

Envelope del risultato

—format=json

Al termine dell’esecuzione viene scritto su stdout un unico oggetto JSON. Contiene il riepilogo dell’esecuzione e tutti gli eventi accumulati nel buffer durante l’esecuzione:

{
  "exitCode":   0,
  "exitReason": "success",
  "elapsedMs":  4218,
  "warnings":   1,
  "errors":     0,
  "events": [
    { "ts": "2026-05-08T14:32:09.500Z", "level": "info",    "code": null,      "message": "Babel Obfuscator 11.7.0.0", "data": null },
    { "ts": "2026-05-08T14:32:11.482Z", "level": "info",    "code": "BAB1234", "message": "Renaming phase ...",       "data": { "phase": "renaming" } },
    { "ts": "2026-05-08T14:32:13.012Z", "level": "warning", "code": "W00013",  "message": "Could not resolve ...",     "data": null }
  ]
}

—format=ndjson

Ogni evento viene scritto non appena è prodotto, su una riga a sé. Dopo l’ultimo evento viene aggiunta una riga finale con il risultato (senza l’array events, perché gli eventi sono già stati trasmessi):

{"ts":"2026-05-08T14:32:09.500Z","level":"info","code":null,"message":"Babel Obfuscator 11.7.0.0","data":null}
{"ts":"2026-05-08T14:32:11.482Z","level":"info","code":"BAB1234","message":"Renaming phase ...","data":{"phase":"renaming"}}
{"ts":"2026-05-08T14:32:13.012Z","level":"warning","code":"W00013","message":"Could not resolve ...","data":null}
{"exitCode":0,"exitReason":"success","elapsedMs":4218,"warnings":1,"errors":0}

—help leggibile dalle macchine

babel --help --format=json emette una descrizione completa di ogni opzione pubblica, adatta agli strumenti che devono esaminare l’interfaccia della CLI (completamento automatico della shell, agenti AI, generatori di documentazione):

{
  "version": "11.7.0.0",
  "usage":   "babel.exe <primary assembly source> [<other assemblies>...] [options]",
  "options": [
    {
      "name":        "controlflow",
      "aliases":     ["nocontrolflow", "no-controlflow", "control-flow", "no-control-flow", "i"],
      "description": "Enable ([no]disable) MSIL control flow obfuscation",
      "args":        null,
      "argRequired": false,
      "argOptional": false,
      "negatable":   true,
      "incremental": false,
      "container":   "scalar",
      "type":        "boolean",
      "group":       "- Code Obfuscation -",
      "details":     "Use this option to alter the method control flow ..."
    }
  ]
}

È supportata anche una forma limitata a una sola opzione. babel --help controlflow --format=json emette lo stesso envelope, che però contiene solo l’opzione controlflow (con i suoi details ricavati dalle risorse dell’opzione).

Le opzioni nascoste o interne non vengono mai restituite.

—version leggibile dalle macchine

babel --version --format=json emette le informazioni sul runtime e sulla piattaforma:

{
  "product":     "Babel Obfuscator",
  "version":     "11.7.0.0",
  "fileVersion": "11.7.0.0",
  "runtime":     ".NET 8.0.11",
  "platform":    "win-x64"
}

Il campo platform usa il RuntimeIdentifier (RID) di .NET quando l’esecuzione avviene su .NET 5 o versioni successive, e una stringa sintetica <os>-<arch> sui target precedenti (net472-x64, unix-x64, …).

Compatibilità con le versioni precedenti

• Il valore predefinito di --format è text; l’output testuale tradizionale, i codici di uscita e il comportamento non cambiano se non specifichi nessuna delle nuove opzioni.
• Senza --strict-exit, il processo continua a restituire 0 in caso di successo e 1 per qualsiasi errore: i controlli di CI esistenti che decidono in base a $? continuano a funzionare.
• --quiet è indipendente e può essere attivato senza abilitare l’output strutturato.