explain-my-curl

explain-my-curl è una CLI locale per capire cosa fa un comando curl attraverso DNS, TLS e HTTP.

Questo repository attualmente include:

• Un comando CLI per analizzare e spiegare un input curl
• Una TUI iniziale per esplorazione interattiva
• Telemetria di esecuzione per DNS, connessione TCP, handshake TLS e time-to-first-byte
• Redazione di segreti per la visualizzazione dei comandi e stringhe di errore
• Etichette di evidenza (Observed, Inferred, Estimated) per supportare la trasparenza del protocollo
• Un contratto di trasparenza in docs/transparency-contract.md

Avvio Rapido

go mod tidy
go run ./cmd/explain-my-curl explain "curl https://example.com -I"
go run ./cmd/explain-my-curl tui
go run ./cmd/explain-my-curl doctor
go run ./cmd/explain-my-curl version

Controlli TUI

• Enter: esegue l'input curl corrente
• Esc: passa alla modalità ispezione
• Tab: commuta il focus tra input e ispezione
• i: focalizza la modalità input
• j/k o tasti freccia: sposta il passo della timeline selezionato
• Spazio: comprime/espande il passo della timeline selezionato
• Ctrl+R: attiva/disattiva il pannello di diagnostica della risposta
• Ctrl+B: attiva/disattiva la visibilità dell'anteprima del corpo della risposta
• q: esci

Rilasci

• I rilasci taggati (v*) vengono costruiti automaticamente con GoReleaser tramite GitHub Actions.
• La CI valida go test ./... su push e pull request.
• La CI esegue anche una build snapshot di GoReleaser per verificare continuamente la configurazione di rilascio.
• Gli artefatti vengono pubblicati per macOS/Linux/Windows su amd64 e arm64.
• I binari dei rilasci includono metadati di build incorporati (version, commit, date).
• Una formula Homebrew viene generata in Formula/ durante il rilascio (il tap utilizza questo stesso repository).

Stato Attuale

Telemetria di esecuzione locale, TUI a pannello diviso, redazione, test, contratto di trasparenza e automazione dei rilasci sono in atto.