chore(release): bump version to 0.2.0 and draft release notes

Author: lesnik512

planning/specs/2026-06-03-release-notes-0.2.0.md

@@ -0,0 +1,45 @@
+# httpware 0.2.0 — thin httpx2 wrapper
+
+**0.2.0 is a breaking rewrite.** The framework is now a thin opinionated wrapper around `httpx2`: it re-exports `httpx2.Request`/`httpx2.Response`, adds a middleware chain, typed response decoding, and a status-keyed exception tree raised automatically on 4xx/5xx.
+
+## Breaking changes from 0.1.0
+
+- **Removed value types.** `httpware.Request`, `httpware.Response`, `httpware.StreamResponse`, `httpware.Limits`, `httpware.Timeout`, and `httpware.ClientConfig` are gone. Use `httpx2.Request`, `httpx2.Response`, `httpx2.Limits`, `httpx2.Timeout` directly.
+- **Removed transport abstraction.** `httpware.Transport`, `httpware.Httpx2Transport`, and `httpware.RecordedTransport` are gone. Tests should inject `httpx2.MockTransport` via the new `httpx2_client=` kwarg.
+- **Removed auth coercion.** Pass `httpx2.Auth` (e.g., `httpx2.BasicAuth`) directly to the client.
+- **`with_options` removed.** Construct a separate `AsyncClient` wrapping a shared `httpx2.AsyncClient` instead.
+- **`StatusError` simplified.** Subclasses no longer accept `status` / `body` / `headers` / `json` / `request_method` / `request_url` kwargs. Construct with a single `response: httpx2.Response` argument and read fields from `exc.response.*`.
+- **CI invariant retired.** The "no `httpx2` imports outside `transports/httpx2.py`" rule is gone. `httpx2` is part of the public surface.
+
+## What still works
+
+- `AsyncClient.get/post/put/patch/delete/head/options/request` with `response_model=...` for typed decoding.
+- `PydanticDecoder` (default) and `MsgspecDecoder` (opt-in via `pip install httpware[msgspec]`).
+- Middleware protocol with `@before_request`, `@after_response`, `@on_error` decorators.
+- Status-keyed exception tree (`NotFoundError`, `RateLimitedError`, etc.) raised automatically on 4xx/5xx.
+
+## Migration
+
+```python
+# Before (0.1.0)
+import httpware
+
+async with httpware.AsyncClient(base_url="https://api.example.com", auth="my-token") as client:
+    user = await client.get("/users/1", response_model=User)
+```
+
+```python
+# After (0.2.0)
+import httpx2
+import httpware
+
+async with httpware.AsyncClient(
+    base_url="https://api.example.com",
+    headers={"Authorization": "Bearer my-token"},
+) as client:
+    user = await client.get("/users/1", response_model=User)
+```
+
+## What's next
+
+Epic 3 (resilience middleware — retry, timeout, bulkhead) and Epic 5 (observability) ship in subsequent minor releases. See `planning/engineering.md` section 8 for the post-pivot roadmap.

pyproject.toml

@@ -26,7 +26,7 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
     "Framework :: AsyncIO",
 ]
-version = "0"
+version = "0.2.0"
 dependencies = [
     "httpx2>=2.0.0,<3.0",
     "pydantic>=2.0,<3.0",