Struct LogEntry 

pub struct LogEntry {
    pub timestamp: Option<String>,
    pub level: Option<String>,
    pub message: Option<String>,
    pub tag: Option<String>,
    pub fields: Map<String, Value>,
    pub raw: String,
}

A single structured log entry.

All four known fields are Option<String> because a JSON line may omit any of them and still be worth indexing — the parser’s contract per the milestone 1 spec is “missing optional fields use None not panic”.

fields holds only keys that are not among the known four. The parser is responsible for lifting known keys out of the JSON object and into their dedicated fields before populating this map.

Fields

timestamp: Option<String>

The entry’s timestamp as it appeared in the source line. Stored as a string rather than a parsed DateTime so unusual formats survive ingestion; time-range filtering is applied at query time.

level: Option<String>

Log severity (“error”, “warn”, “info”, …). Indexed column.

message: Option<String>

The human-readable message body.

tag: Option<String>

Optional source tag supplied at ingestion time (the --tag CLI flag, per the “Decisions log” entry on optional tags). None means “untagged” and such entries match queries without a tag filter.

fields: Map<String, Value>

Arbitrary additional keys from the JSON object. Serialized to the fields TEXT column and queried via SQLite’s json_extract().

raw: String

The original, unmodified source line. Feeds both the raw column and the blake3-based dedup hash.

Implementations

impl LogEntry

pub const KNOWN_KEYS: &'static [&'static str]

The set of top-level JSON keys that are promoted to first-class struct fields during parsing. Any key not in this set is preserved in LogEntry::fields.

Kept in a single place so the parser and any future schema-related code agree on which keys are “known”.

pub fn new(raw: impl Into<String>) -> Self

Construct a new entry from the raw source line, with all optional fields unset and an empty fields map. The parser uses this as a starting point and fills in the pieces it finds.

pub fn with_tag(self, tag: Option<String>) -> Self

Override the tag. Used by the indexer to apply the --tag flag supplied at ingestion time: if the source JSON did not carry its own tag, the CLI-provided one is substituted here.

Trait Implementations

impl Clone for LogEntry

fn clone(&self) -> LogEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LogEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LogEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LogEntry

fn eq(&self, other: &LogEntry) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LogEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for LogEntry

impl StructuralPartialEq for LogEntry