Struct CommandTrace 

pub struct CommandTrace { /* private fields */ }

Mutable trace builder for a single CLI command invocation.

Construction starts the clock; calling CommandTrace::ok or CommandTrace::err emits the line and consumes the value.

The builder fields are accumulated as the command progresses and figures out what it’s doing (browser resolution, route selection, tab binding). Anything not set defaults to an empty string in the emitted log line so the schema is stable.

Implementations

impl CommandTrace

pub fn new(command: &'static str) -> Self

Start a trace. The clock starts here. command is the static command name ("eval", "fetch", "tab-open", …) — keep it kebab-cased so log consumers can match on a stable string.

pub fn browser(&mut self, s: impl Into<String>) -> &mut Self

pub fn engine(&mut self, e: Engine) -> &mut Self

pub fn route(&mut self, r: &'static str) -> &mut Self

Set the routing path. Suggested values:

• "scratch" — scratch-tab recovery wrapper
• "named-tab" — <browser>/<tab> via tabs registry
• "target-regex" — legacy --target <regex> selector
• "attach-for-origin" — fetch default (origin-matched tab)
• "direct" — external URL fall-through
• "registry" — registry-only ops (cookies, wait, etc.)

pub fn tab_name(&mut self, s: impl Into<String>) -> &mut Self

pub fn target_id(&mut self, s: impl Into<String>) -> &mut Self

pub fn ok<T>(self, val: T) -> T

Emit the closing log line with outcome=ok and return val unchanged. Use at the success exit of every command: Ok(trace.ok(value)).

pub fn err(self, err: Error) -> Error

Emit the closing log line with outcome=err and return err unchanged. Use at the error exit: Err(trace.err(e)).

pub fn finish(self, result: Result<()>) -> Result<()>

Combinator collapsing the match result { Ok => ok; Err => err } boilerplate every command’s entry point used to repeat. Emits the closing line with the matching outcome and returns result unchanged: trace.finish(run_inner(...).await).