desktop/src-tauri/crates/core/src/adapters/zcode/db_backfill.rs

Comment 1, line 1

//! Prefer local model_usage database snapshots. JSONL is a fallback only when

//! this root has never supplied a database. The source prunes after 30 days;

//! snapshots replace complete source/day partitions, never match time or tokens.

/// Backfill counts recorded in operation logs and the UI.

/// model_usage rows read with a nonnull completed_at; usage fields may be unknown.

/// Records in unchanged snapshots.

/// Newly inserted events.

/// Events updated under an existing key on repeat backfill.

/// Open cli/db/db.sqlite read-only and synchronize its snapshots. `instance_id`

/// must match the zcode JSONL instance, retaining common ownership/user routing.

// input_uncached = input - (cache_read + cache_write); invalid or missing operands

// leave it None, including cache exceeding input; never fill unknown values with zero.

/// Persist a snapshot and its aggregates in one transaction. Old details are

/// used only inside this transaction, then removed under the existing policy.

// Validate the complete snapshot before deleting any existing contribution.

// The source may already have removed the beginning of this day.

// Keep the previously captured complete contribution; never replace it

// with a partial snapshot or infer missing calls from token amounts.

/// Map db.query_source as modelio_v1 does; unverified compact remains unknown.

/// model_usage row selected by completed_at; optional usage fields remain optional.

/// Parser version identifying the backfill rule used by an event.