vik 0.1.0

Vik is an issue-driven coding workflow automation tool.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

//! Span factories.
//!
//! Each helper seeds a `phase` field plus any context fields known at
//! span open time. Fields not yet known are reserved as
//! [`tracing::field::Empty`] so downstream code can fill them in via
//! `Span::record` (e.g. `session_id` once the agent reports it).
//!
//! The `phase` field is the lowest-common-denominator filter for log
//! consumers — every emitted event must carry exactly one phase value.

use tracing::Span;
use tracing::field::Empty;

use super::phase::Phase;

pub fn dispatch_span() -> Span {
  tracing::info_span!("dispatch", phase = Phase::Dispatch.as_str(),)
}

pub fn stage_span(issue_identifier: &str, stage_name: &str, agent_profile: &str) -> Span {
  tracing::info_span!(
    "stage_run",
    phase = Phase::StageRun.as_str(),
    issue_identifier = issue_identifier,
    stage_name = stage_name,
    agent_profile = agent_profile,
    runtime = Empty,
    session_id = Empty,
    duration_ms = Empty,
  )
}

pub fn daemon_span() -> Span {
  tracing::info_span!("daemon", phase = Phase::Daemon.as_str(),)
}

#[cfg(test)]
mod tests {
  use super::*;

  use tracing::subscriber::with_default;
  use tracing_subscriber::Registry;

  #[test]
  fn stage_span_has_phase_field() {
    // Subscriber must be active for `info_span!` to record metadata;
    // otherwise the span is disabled and `metadata()` returns `None`.
    // The assertion is indirect (compilation + non-None metadata) but
    // catches a future refactor that drops the `phase` field.
    with_default(Registry::default(), || {
      let span = stage_span("ABC-1", "plan", "codex");
      let _ = span.metadata().expect("metadata present");
    });
  }
}