Generalize Must for any value

[korya]

Problem

ha.Must only unwraps assertion constructors, so Go consumers cannot use the same concise error contract with other constructors.

The restriction is artificial: its behavior depends only on an (value, error) pair, not on the ha.Assertion interface.

Solution

Make ha.Must generic so it unwraps any (T, error) constructor without changing its panic-on-error contract.

Before:

assertion := ha.Must(ha.AssertJQ(`.status == "healthy"`))
// http.NewRequest cannot be passed to ha.Must.

After:

request := ha.Must(http.NewRequest(http.MethodGet, url, nil))
assertion := ha.Must(ha.AssertJQ(`.status == "healthy"`))

Existing assertion calls compile unchanged. Generic inference requires a typed value, so the uncommon ha.Must(nil, err) form must specify its intended type, such as ha.Must[*http.Request](nil, err).

The helper remains intended for static, programmer-owned input. Constructors fed by untrusted runtime input should return their errors normally instead of converting them into panics.

No visual change: this is a Go API and documentation update.

Other Changes

• Update the README library sample to construct the request inline.
• Add tests and an executable example covering both assertions and HTTP requests; both helper branches are covered.
• Record the generalized API in the unreleased changelog.

Related:

• Extract reusable HTTP assertion library #105

🤖 Generated with Claude Code