HelixObs / client-python / 26639119768

95%

push

github

feat: deferred entity_id on operate(), tel.trace(), set_entity_id()

- operate() now accepts entity_id=None (optional). Start the trace
  immediately and call token.set_entity_id(id) once the entity is known
  mid-operation. Spans that close without entity_id are forwarded as
  plain OTel traces; a WARNING is logged.
- Add Token.set_entity_id() convenience method. set_attribute() on
  helix.entity.id also resolves the flag and suppresses the warning.
- Add Instrument.trace() for plain OTel spans with no entity semantics.
  Use for infrastructure work (HTTP handlers, loops) where log
  correlation by trace ID is needed but no entity is being tracked.
  child_span() calls inside a trace() block inherit context automatically.
- Add import logging at module level (was incorrectly deferred inline).
- Tests: TestOperateDeferred (7 cases) and TestTrace (10 cases).
- Docs: USER_GUIDE, helixobs/AGENT.md, client-python/AGENT.md updated.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

22 of 22 new or added lines in 1 file covered. (100.0%)

361 of 372 relevant lines covered (97.04%)

0.97 hits per line