Skip to content

Commit 920260e

Browse files
docs(examples): honest unversioned fallback for the lineage tutorial's AGENT_VERSION
Greptile P1: a fixed 0.1.0 default would stamp every unlabeled build with a real-looking version, misattributing traces across commits. The fallback is now the explicit sentinel 'unversioned'. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 7891559 commit 920260e

2 files changed

Lines changed: 6 additions & 4 deletions

File tree

examples/tutorials/00_sync/080_lineage/Dockerfile

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,9 @@ ENV PYTHONPATH=/app
4747
ENV AGENT_NAME=s080-lineage
4848

4949
# The agent build version stamped onto every span as __agent_version__.
50-
# Real deployments pass the image tag or git SHA at build time.
51-
ARG AGENT_VERSION=0.1.0
50+
# Pass the image tag or git SHA at build time; the fallback is an explicit
51+
# sentinel so an unlabeled build never fabricates a version.
52+
ARG AGENT_VERSION=unversioned
5253
ENV AGENT_VERSION=${AGENT_VERSION}
5354

5455
# Run the agent using uvicorn

examples/tutorials/00_sync/080_lineage/README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,9 @@ lineage service; edges are derived later from materialized traces
3232

3333
- **`__agent_version__`** — the SGP tracing processor stamps the
3434
`AGENT_VERSION` env var onto every span. The Dockerfile sets it from a
35-
build arg; real deployments pass the image tag or git SHA. For
36-
`agentex agents run`, export it or put it in this directory's `.env`.
35+
build arg (pass the image tag or git SHA; unlabeled builds fall back to
36+
the explicit sentinel `unversioned` rather than a fabricated version).
37+
For `agentex agents run`, export it or put it in this directory's `.env`.
3738

3839
Ref namespaces must use the canonical URI forms from the lineage identifier
3940
conventions (`packages/sgp-lineage/docs/event-contract.md` in `scaleapi`);

0 commit comments

Comments
 (0)