Module obs 

Structured observability hooks for AIVCS run lifecycle events.

This module provides:

• Run-scoped tracing spans via RunSpan RAII guard
• Emission functions for key lifecycle events: start, event append, finish, gate evaluation

Events are emitted at info! level (configurable via AIVCS_LOG env var). For JSON output, set AIVCS_LOG_FORMAT=json.

Structs

RunSpan

RAII guard that enters a run-scoped tracing span for the duration of a run.

Functions

emit_event_appended

Emit event: a single event appended to the run.

emit_gate_evaluated

Emit event: gate evaluation completed with pass rate and verdict.

emit_run_finalize_error

Emit event: run finalization error (warning level).

emit_run_finished

Emit event: run finished with duration, total events, and success status.

emit_run_started

Emit event: run started with agent name.