Struct Emitter 

pub struct Emitter { /* private fields */ }

Emits Events to core (NDJSON mode) or renders them for a human (standalone mode).

Construct with Emitter::from_env. The mode is chosen by protocol_mode; callers write the same code either way.

Implementations

impl Emitter

pub fn from_env() -> Self

pub fn log(&self, level: LogLevel, msg: impl Into<String>)

pub fn info(&self, msg: impl Into<String>)

pub fn warn(&self, msg: impl Into<String>)

pub fn error(&self, msg: impl Into<String>)

pub fn progress(&self, done: u64, total: Option<u64>, msg: impl Into<String>)

pub fn note(&self, relpath: impl Into<String>, action: NoteAction)

Announce a note at relpath (relative to the vault root) so core can index it. Prefer Emitter::write_note, which writes the file and emits this for you.

pub fn result_ok(&self, summary: Value)

Terminal success event with a JSON summary.

pub fn result_ok_no_index(&self, summary: Value)

Terminal success event that tells core not to index afterwards (e.g. --dry-run).

pub fn result_err(&self, summary: Value)

Terminal failure event.

pub fn write_note(&self, relpath: &str, body: &str) -> Result<PathBuf>

Write a Markdown note into the vault and emit the matching Event::Note.

Guards (contract): relpath must end in .md and must not escape the vault root. Parent directories are created. Returns the absolute path written.

pub fn append_note(&self, relpath: &str, body: &str) -> Result<PathBuf>

Append to (or create) a Markdown note and emit NoteAction::Append.

Trait Implementations

impl Default for Emitter

fn default() -> Self

Returns the “default value” for a type.