From e741292724c72c583f9e489d870ffcba53b1baf6 Mon Sep 17 00:00:00 2001
From: "const.koutsakis@aurecongroup.com" <constantinos.koutsakis@gmail.com>
Date: Mon, 25 May 2026 23:35:03 +1000
Subject: [PATCH 1/2] docs: replace Jaeger screenshot TODO with section
 scaffold (#92)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The observability story in README has one visible loose end: a TODO
block where the Jaeger trace screenshot should go. The rest of the
section reads cleanly, so the TODO sticks out.

Promotes the placeholder to a real subsection ("Jaeger trace") with
the explanatory caption already written: what boots the stack, what
endpoint produces the trace, where to view it, and that span
attributes use only the constant-defined semconv keys from
src/observability/spans.py.

The image itself still needs to be captured. The original capture
recipe is preserved as an HTML comment so it remains discoverable,
and the comment includes the exact one-line markdown to paste in once
docs/images/jaeger-trace.png lands. Hiding the placeholder inside an
HTML comment (rather than a broken-image ref) keeps the rendered
README clean while the PNG is outstanding.

The image-capture step itself is a follow-up — needs the maintainer
to run docker compose locally and take the screenshot.

Closes #92 (capture step tracked separately as a single-line README
edit when the PNG is committed).
---
 README.md | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index a69899a..c222e0a 100644
--- a/README.md
+++ b/README.md
@@ -81,17 +81,23 @@ The scaffold's React page hits `/api/v1/health` on load and renders the version
 
 ![Hello page](docs/images/hello-page.png)
 
+### Jaeger trace (`docker compose up` + `/api/v1/health`)
+
+The full stack — backend, frontend, Jaeger collector — boots with `docker compose up`. Hitting `/api/v1/health` once produces an OpenTelemetry trace exported via OTLP/gRPC; the span hierarchy is visible at <http://localhost:16686> under the `harness-python-react` service, with `agent_span(...)` attributes attached using only the keys constant-defined at the top of [`src/observability/spans.py`](src/observability/spans.py).
+
 <!--
-TODO (#28): one capture left — Jaeger trace.
+Screenshot pending: docs/images/jaeger-trace.png
+
+Capture recipe (run once and commit the PNG to docs/images/):
+  1. docker compose up
+  2. curl http://localhost:8000/api/v1/health
+  3. open http://localhost:16686 -> select service "harness-python-react"
+  4. click the most recent trace
+  5. screenshot the span timeline, save as docs/images/jaeger-trace.png
 
-  docs/images/jaeger-trace.png
-    With the full stack running (`docker compose up`), hit /api/v1/health
-    once, then open http://localhost:16686, select service
-    `harness-python-react`, click the most recent trace, screenshot the
-    span timeline.
+When the PNG is committed, replace this whole comment with:
 
-When the PNG lands in docs/images/, replace this comment with a section
-analogous to "Hello page" above.
+    ![Jaeger trace — span timeline for GET /api/v1/health](docs/images/jaeger-trace.png)
 -->
 
 ## Why a harness

From 02bd1aa11681a4d855a1e4206d8feb4691567ddd Mon Sep 17 00:00:00 2001
From: "const.koutsakis@aurecongroup.com" <constantinos.koutsakis@gmail.com>
Date: Mon, 25 May 2026 23:48:25 +1000
Subject: [PATCH 2/2] chore: bump version to 0.2.11

---
 pyproject.toml | 2 +-
 uv.lock        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 8e2df15..3e2e858 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "harness-python-react"
-version = "0.2.16"
+version = "0.2.17"
 description = "Production-quality LLM-driven coding harness — Python (FastAPI) backend, Vite + React + TypeScript frontend."
 readme = "README.md"
 requires-python = ">=3.14"
diff --git a/uv.lock b/uv.lock
index 8e9e9f8..77c0d17 100644
--- a/uv.lock
+++ b/uv.lock
@@ -337,7 +337,7 @@ wheels = [
 
 [[package]]
 name = "harness-python-react"
-version = "0.2.16"
+version = "0.2.17"
 source = { virtual = "." }
 dependencies = [
     { name = "fastapi" },