fix: Timeline sparkline axis labels positioning & timezone handling

- daily_usage() now pre-fills the full date range with zeros (n_bars == days)
  so bars span the chart width proportionally instead of clustering left
- format_axis_labels() accepts n_bars param; positions first/mid/last labels
  at actual bar columns (1 + bar_index) matching Sparkline's 1-char-per-point
- format_hourly_axis_labels() rewritten to place labels at exact bar positions:
  0h→1, 6h→7, 12h→13, 18h→19, 23h→24 (no longer distributed across full width)
- Switched to SQLite 'localtime' modifier for date/hour grouping so users see
  wall-clock times in their timezone, not UTC
- All three Timeline chart titles now display UTC offset indicator (e.g. UTC+7)
- test_daily_usage updated to validate pre-fill: assert len == 365 and check
  today's record at daily.last().total_tokens

Fixes incorrect axis label positioning where sparse data (e.g. 10 days of records)
caused labels to appear at terminal edges while bars clustered at left 5%.

Author: riyhs

.agents/CONTEXT.md

@@ -12,13 +12,18 @@ Displays a Ratatui dashboard with HTML export. Pricing fetched live from models.
 
 ## State
 
-**Status:** Feature-complete -- 7 new features shipped; 34 tests passing
+**Status:** Feature-complete — v0.2.2 + Timeline axis fix; 34 tests passing, clippy clean
 **Branch:** main | **Worktree:** ./
-**Last completed:** Sessions tab (tab 6), CSV export (`c` key + `--csv` flag), hourly heatmap
-sparkline in Timeline, Avg/Req column in By Model, cache token extraction from OpenCode,
-`source_session_id` column for session grouping, `fmt_duration` helper, `write_csv()` in
-export.rs. Settings shifts to tab 7, `'6'` = Sessions, `'7'` = Settings.
-**Next:** Budget alerts, Zed sync (once Zed exposes token counts), auto-sync on startup daemon
+**Last completed (2026-04-04 session 4):**
+- Timeline sparkline axis label positioning corrected:
+  - `daily_usage()` pre-fills the full date range with zeros so n_bars == days and sparkline fills proportionally
+  - `format_axis_labels()` takes `n_bars` param; labels positioned at actual bar columns (`1 + bar_index`)
+  - `format_hourly_axis_labels()` rewritten; labels at exact bar cols: 0h→1, 6h→7, 12h→13, 18h→19, 23h→24
+- Timezone: `date(recorded_at, 'localtime')` and `strftime('%H', recorded_at, 'localtime')` for local wall-clock times
+- UTC offset label appended to all three Timeline chart titles (e.g. "UTC+7", "UTC-5", "UTC")
+- `test_daily_usage` updated to assert `daily.len() == 365` and check `daily.last().total_tokens`
+
+**Next:** Budget alerts, Zed sync (once Zed exposes token counts)
 
 ## Blockers
 
@@ -46,6 +51,9 @@ None.
 | 2026-04-04 | input/output_cost_usd at display time | Avoids DB migration on price changes; user overrides apply instantly |
 | 2026-04-04 | source_session_id separate from session_id | session_id is dedup key ("opencode:<msg_id>"); source_session_id is OpenCode session FK for grouping |
 | 2026-04-04 | cache tokens stored but not shown in By Model | Reserved for future UI; suppressed via #[allow(dead_code)] |
+| 2026-04-04 | add_price_override updates both pricing maps | immediate effect without TUI restart |
+| 2026-04-04 | settings_confirm_edit returns Option<&'static str> | allows caller to display error in status bar |
+| 2026-04-04 | startup sync via spawn_blocking + JoinHandle poll | non-blocking; polled each event loop tick via is_finished() |
 
 ## Architecture Notes
 
@@ -70,6 +78,15 @@ None.
 | 5     | Sessions   | 6   |
 | 6     | Settings   | 7   |
 
+## Settings Items (index → label → interaction)
+
+| Index | Label          | Interaction                                  |
+| ----- | -------------- | -------------------------------------------- |
+| 0     | OpenCode sync  | Space to toggle                              |
+| 1     | Report path    | Enter to edit text field                     |
+| 2     | Price override | Enter to enter model:in:out, updates config  |
+| 3     | Reset DB       | Enter (arm) → Enter again (execute), Esc=cancel |
+
 ## Sync Adapters
 
 | Source   | Status      | DB/File Location                         | Token Source       |
@@ -98,4 +115,8 @@ fresh data and update the cache.
 
 ---
 
-_Updated: 2026-04-04 (Sessions tab, CSV export, hourly heatmap, Avg/Req column, cache tokens, source_session_id)_
+| 2026-04-04 | Timeline axis labels use bar-column positioning | Labels distributed across widget width were wrong; now placed at `1 + bar_index` matching Sparkline's left-aligned 1-char-per-point rendering |
+| 2026-04-04 | daily_usage() pre-fills all days in range | Sparse SQL results left most bars at col ~1-10 while labels spanned full width |
+| 2026-04-04 | SQLite 'localtime' modifier for date/hour grouping | UTC dates/hours were misleading for users outside UTC |
+
+_Updated: 2026-04-04 (Timeline axis fix: bar-position labels, localtime, UTC offset in titles)_

Cargo.lock

@@ -1,9 +1,9 @@
 [package]
 name = "oxidetrack"
-version = "0.2.0"
+version = "0.2.2"
 edition = "2021"
-description = "Lightweight TUI for tracking AI token usage across OpenCode, Zed, and VS Code Copilot"
-authors = ["Riy"]
+description = "Lightweight TUI for tracking AI token usage in OpenCode"
+authors = ["Riyaldi Hasan"]
 
 [[bin]]
 name = "oxtrack"

Cargo.toml

@@ -42,14 +42,16 @@ pub struct App {
     pub hourly: Vec<HourlyBucket>,
 
     // Settings tab state
-    /// Currently selected settings item index (0-4)
+    /// Currently selected settings item index (0-3)
     pub settings_selected: usize,
     /// Whether we're in editing mode for a text field
     pub settings_editing: bool,
     /// Buffer for the text being edited
     pub settings_edit_buffer: String,
     /// Whether settings have unsaved changes
     pub settings_dirty: bool,
+    /// Pending "Reset DB" confirmation — first Enter arms, second Enter executes
+    pub settings_reset_pending: bool,
 
     // Status bar message
     pub status: String,
@@ -85,6 +87,7 @@ impl App {
             settings_editing: false,
             settings_edit_buffer: String::new(),
             settings_dirty: false,
+            settings_reset_pending: false,
             status: "Press ? for help  |  s = sync  |  e = export  |  c = csv  |  q = quit".into(),
             should_quit: false,
             needs_clear: false,
@@ -209,28 +212,34 @@ impl App {
 
     // ── Settings ──────────────────────────────────────────────────────────────
 
-    /// Total number of editable settings items:
-    /// 0 = OpenCode sync toggle, 1 = Report path text field.
-    pub const SETTINGS_COUNT: usize = 2;
+    /// Total number of navigable settings items:
+    /// 0 = OpenCode sync toggle, 1 = Report path, 2 = Price override, 3 = Reset DB.
+    pub const SETTINGS_COUNT: usize = 4;
 
     /// Toggle a boolean setting at the current index.
     pub fn settings_toggle(&mut self) {
         if self.settings_selected == 0 {
             self.config.sources.opencode = !self.config.sources.opencode;
             self.settings_dirty = true;
         }
-        // item 1 (Report path) is a text field — use Enter, not Space
+        // items 1-3 use Enter, not Space
     }
 
     /// Begin editing a text field at the current index.
     /// Returns false if the current item is not a text field.
     pub fn settings_start_edit(&mut self) -> bool {
-        if self.settings_selected == 1 {
-            self.settings_edit_buffer = self.config.export_path.clone().unwrap_or_default();
-            self.settings_editing = true;
-            true
-        } else {
-            false // booleans use Space, not Enter
+        match self.settings_selected {
+            1 => {
+                self.settings_edit_buffer = self.config.export_path.clone().unwrap_or_default();
+                self.settings_editing = true;
+                true
+            }
+            2 => {
+                self.settings_edit_buffer = String::new();
+                self.settings_editing = true;
+                true
+            }
+            _ => false, // booleans / actions use Space or Enter directly
         }
     }
 
@@ -241,14 +250,48 @@ impl App {
     }
 
     /// Confirm the current edit, writing the buffer value into config.
-    pub fn settings_confirm_edit(&mut self) {
+    ///
+    /// Returns `Some(&'static str)` with an error message on validation failure,
+    /// or `None` on success.
+    pub fn settings_confirm_edit(&mut self) -> Option<&'static str> {
         let val = self.settings_edit_buffer.trim().to_string();
-        if self.settings_selected == 1 {
-            self.config.export_path = if val.is_empty() { None } else { Some(val) };
-            self.settings_dirty = true;
+        match self.settings_selected {
+            1 => {
+                self.config.export_path = if val.is_empty() { None } else { Some(val) };
+                self.settings_dirty = true;
+            }
+            2 => {
+                // Parse "model:input_per_1m:output_per_1m"
+                let parts: Vec<&str> = val.splitn(3, ':').collect();
+                if parts.len() != 3 {
+                    self.settings_editing = false;
+                    self.settings_edit_buffer.clear();
+                    return Some("Format: model:in$/1M:out$/1M  e.g. gpt-4o:2.5:10.0");
+                }
+                let model = parts[0].trim().to_string();
+                let Ok(input_p) = parts[1].trim().parse::<f64>() else {
+                    self.settings_editing = false;
+                    self.settings_edit_buffer.clear();
+                    return Some("Invalid input price — must be a number");
+                };
+                let Ok(output_p) = parts[2].trim().parse::<f64>() else {
+                    self.settings_editing = false;
+                    self.settings_edit_buffer.clear();
+                    return Some("Invalid output price — must be a number");
+                };
+                if model.is_empty() {
+                    self.settings_editing = false;
+                    self.settings_edit_buffer.clear();
+                    return Some("Model name cannot be empty");
+                }
+                self.config.add_price_override(model, input_p, output_p);
+                self.settings_dirty = true;
+            }
+            _ => {}
         }
         self.settings_editing = false;
         self.settings_edit_buffer.clear();
+        None
     }
 
     /// Save the current config to disk.

src/app.rs

@@ -194,6 +194,15 @@ impl Config {
             .unwrap_or([0.0, 0.0])
     }
 
+    /// Add or overwrite a price override for `model`, taking effect immediately.
+    ///
+    /// Updates both `self.pricing` (persisted to config.toml on next save) and
+    /// `self.effective_pricing` (used by `model_pricing` / `calc_cost` right away).
+    pub fn add_price_override(&mut self, model: String, input: f64, output: f64) {
+        self.pricing.insert(model.clone(), [input, output]);
+        self.effective_pricing.insert(model, [input, output]);
+    }
+
     /// Calculate total cost in USD for a given model and token counts.
     pub fn calc_cost(&self, model: &str, input: i64, output: i64) -> f64 {
         let [in_price, out_price] = self.model_pricing(model);

src/config.rs

@@ -1,5 +1,5 @@
 use anyhow::Result;
-use chrono::{Duration, Utc};
+use chrono::{Duration, Local, NaiveDate, Utc};
 use rusqlite::{params, Connection};
 use serde::{Deserialize, Serialize};
 use std::path::Path;
@@ -334,6 +334,24 @@ impl Database {
         Ok(deleted)
     }
 
+    /// Delete ALL usage records and sync state, so the next sync re-imports
+    /// everything fresh. Returns the number of usage records deleted.
+    pub fn reset_records(&self) -> Result<usize> {
+        self.conn.execute_batch("BEGIN")?;
+        let result = (|| -> Result<usize> {
+            let deleted = self.conn.execute("DELETE FROM usage_records", [])?;
+            self.conn.execute("DELETE FROM sync_state", [])?;
+            Ok(deleted)
+        })();
+        match &result {
+            Ok(_) => self.conn.execute_batch("COMMIT")?,
+            Err(_) => {
+                let _ = self.conn.execute_batch("ROLLBACK");
+            }
+        }
+        result
+    }
+
     pub fn update_sync_state(&self, source: &str) -> Result<()> {
         self.conn.execute(
             "INSERT OR REPLACE INTO sync_state (source, last_sync) VALUES (?1, ?2)",
@@ -491,31 +509,48 @@ impl Database {
 
     pub fn daily_usage(&self, days: i64) -> Result<Vec<DailyUsage>> {
         let since = Self::since(days);
+        // Use 'localtime' modifier so dates match the user's wall-clock day.
         let mut stmt = self.conn.prepare(
-            "SELECT date(recorded_at) as day,
+            "SELECT date(recorded_at, 'localtime') as day,
                 SUM(input_tokens + output_tokens),
                 SUM(cost_usd)
              FROM usage_records
              WHERE recorded_at >= ?1
              GROUP BY day
              ORDER BY day ASC",
         )?;
-        let rows = stmt.query_map(params![since], |row| {
-            Ok(DailyUsage {
-                date: row.get(0)?,
-                total_tokens: row.get(1)?,
-                cost_usd: row.get(2)?,
-            })
-        })?;
-        Ok(rows
+        let found: std::collections::HashMap<String, (i64, f64)> = stmt
+            .query_map(params![since], |row| {
+                Ok((
+                    row.get::<_, String>(0)?,
+                    row.get::<_, i64>(1)?,
+                    row.get::<_, f64>(2)?,
+                ))
+            })?
             .filter_map(|r| match r {
-                Ok(row) => Some(row),
+                Ok((date, tokens, cost)) => Some((date, (tokens, cost))),
                 Err(e) => {
                     eprintln!("warn: skipped malformed daily row: {}", e);
                     None
                 }
             })
-            .collect())
+            .collect();
+
+        // Pre-fill every day in the range (local time) so that n_bars == days and
+        // the sparkline bars span the full chart width proportionally.
+        let today_local = Local::now().date_naive();
+        let mut result = Vec::with_capacity(days as usize);
+        for offset in (0..days).rev() {
+            let date: NaiveDate = today_local - Duration::days(offset);
+            let key = date.format("%Y-%m-%d").to_string();
+            let (total_tokens, cost_usd) = found.get(&key).copied().unwrap_or((0, 0.0));
+            result.push(DailyUsage {
+                date: key,
+                total_tokens,
+                cost_usd,
+            });
+        }
+        Ok(result)
     }
 
     pub fn by_source(&self, days: i64) -> Result<Vec<SourceRow>> {
@@ -607,8 +642,9 @@ impl Database {
     /// Returns a vec of 24 entries (one per hour), even if some hours are zero.
     pub fn hourly_usage(&self, days: i64) -> Result<Vec<HourlyBucket>> {
         let since = Self::since(days);
+        // Use 'localtime' modifier so hours match the user's wall-clock time.
         let mut stmt = self.conn.prepare(
-            "SELECT CAST(strftime('%H', recorded_at) AS INTEGER) AS hour,
+            "SELECT CAST(strftime('%H', recorded_at, 'localtime') AS INTEGER) AS hour,
                 SUM(input_tokens + output_tokens)
              FROM usage_records
              WHERE recorded_at >= ?1
@@ -770,8 +806,9 @@ mod tests {
         let records = vec![sample_record("s1", "claude-sonnet-4", 100, 200)];
         db.insert_records(&records).unwrap();
         let daily = db.daily_usage(365).unwrap();
-        assert!(!daily.is_empty());
-        assert_eq!(daily[0].total_tokens, 300);
+        // Pre-fill ensures exactly `days` entries; today's record is the last one.
+        assert_eq!(daily.len(), 365);
+        assert_eq!(daily.last().unwrap().total_tokens, 300);
     }
 
     #[test]