Makefile: add hx-* targets (deps, run, lint, fmt, test, test-integration,
check, clean) that delegate into hxprobe/ via uv; fold hx-test and hx-check
into the umbrella test/check/clean targets; add HX_DIR variable and a note
that hxprobe is intentionally standalone (no cross-imports from python/).
CLAUDE.md: add "Implementation Summaries" convention — after each feature,
save a summary under docs/summaries/ with the same timestamp+slug naming as
plans. Add note about copying plan-mode scratch files into docs/plans/ before
starting implementation.
.gitignore: add *.egg-info/, .pytest_cache/, .ruff_cache/ for the hxprobe
uv+ruff+pytest toolchain.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds the complete Python port of the Go latprobe tool plus diagnostic
verbose output that the Go version does not yet have.
Package (python/latprobe/):
- probe.py: raw-socket HTTP timing with CertInfo/VerboseDetail dataclasses;
TTFB loop accumulates to \r\n\r\n so headers are parseable without changing
t_first_byte semantics; captures resolved IP, TLS version/cipher/bits,
verified cert (via getpeercert()), and all response headers when verbose=True
- aggregate.py: summarize() → per-phase min/avg/max PhaseStats
- cli.py: injectable run(args,stdout,stderr)->int; argparse with injected
streams; ThreadPoolExecutor concurrency across URLs; four text-rendering
branches; JSON output; worst-exit-code accumulation; -v/--verbose flag
appends IP/TLS/cert/header block after every timing table; JSON extended
with "verbose" object (omitted when flag absent)
- duration.py: parse Go-style duration strings (10s, 500ms, 2m, bare seconds)
- Exit codes: 0 ok, 1 usage, 2 dns, 3 connect, 4 timeout, 5 tls, 6 http≥400
Tests:
- test_probe.py: 18 hermetic tests (success, 404, DNS/connect/timeout/scheme
failures, partial-phase invariants, verbose detail fields)
- test_cli.py: 38 hermetic tests (usage errors, single/aggregate/failure text,
worst-code, --fail, JSON schema/ordering/grouping, verbose text and JSON)
- test_integration.py: 45 tests against live internet services (badssl.com for
TLS errors, real cert/IP/header validation in verbose mode)
Makefile: PYTHONPATH fix, fnmatch pattern test_[!i]*.py to exclude
integration tests from py-test, new py-test-integration target
Docs: docs/usage/py-latprobe.md, python/configs/usage-latprobe.md (runnable
reference with captured output), plans for both the package and verbose feature
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Namespaced go-* targets (build, run, test, test-verbose, check, cover,
fmt, vet, tidy, install, lint, clean) plus umbrella targets that delegate
to them. help is the default. py-* targets will slot in during the Python
port. Updates .gitignore with coverage artifacts.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
