explain-my-curl

explain-my-curl — это локальный CLI для понимания того, что делает команда curl на уровнях DNS, TLS и HTTP.

В этот репозиторий в настоящее время входят:

• Команда CLI для разбора и объяснения ввода curl
• Запускаемый TUI для интерактивного исследования
• Телеметрия выполнения для DNS, TCP подключения, TLS рукопожатия и времени до первого байта
• Редактирование секретов при отображении команд и строк ошибок
• Метки достоверности (Observed, Inferred, Estimated) для поддержки прозрачности протокола
• Контракт прозрачности в docs/transparency-contract.md

Быстрый старт

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

Управление TUI

• Enter: выполнить текущий ввод curl
• Esc: переключиться в режим просмотра
• Tab: переключить фокус между вводом и просмотром
• i: фокус на режим ввода
• j/k или клавиши стрелок: переместить выбранный шаг временной шкалы
• Space: свернуть/развернуть выбранный шаг временной шкалы
• Ctrl+R: переключить панель диагностики ответа
• Ctrl+B: переключить видимость предварительного просмотра тела ответа
• q: выход

Релизы

• Тегированные релизы (v*) автоматически собираются с помощью GoReleaser через GitHub Actions.
• CI проверяет go test ./... при пушах и pull request'ах.
• CI также запускает сборку снимка GoReleaser для постоянной проверки конфигурации релиза.
• Артефакты публикуются для macOS/Linux/Windows на amd64 и arm64.
• Бинарные файлы релиза включают встроенные метаданные сборки (version, commit, date).
• Формула Homebrew генерируется в Formula/ во время релиза (tap использует этот же репозиторий).

Текущий статус

Локальная телеметрия выполнения, TUI с разделением панелей, редактирование, тесты, контракт прозрачности и автоматизация релизов реализованы.