agent-finance-cli 0.1.0 → 0.1.2

package/Cargo.lock

@@ -10,7 +10,7 @@ checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
 
 [[package]]
 name = "agent-finance-cli"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "anyhow",
  "base64",
@@ -19,6 +19,7 @@ dependencies = [
  "clap",
  "csv",
  "futures-util",
+ "iana-time-zone",
  "prost",
  "rustls",
  "scraper",

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "agent-finance-cli"
-version = "0.1.0"
+version = "0.1.2"
 edition = "2024"
 license = "MIT OR Apache-2.0"
 repository = "https://github.com/M4n5ter/agent-finance-cli"
@@ -29,3 +29,4 @@ zip = { version = "8.6.0", default-features = false, features = ["deflate"] }
 scraper = "0.27.0"
 wreq = { version = "6.0.0-rc.29", default-features = false, features = ["cookies", "deflate", "gzip", "json", "socks", "system-proxy", "tokio-rt", "webpki-roots"] }
 wreq-util = "3.0.0-rc.12"
+iana-time-zone = "0.1"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-finance-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "AI Agent-first CLI for no-key financial market data and research context.",
   "license": "MIT OR Apache-2.0",
   "repository": {
@@ -31,11 +31,11 @@
     "check:npm": "node npm/check-package.js"
   },
   "optionalDependencies": {
-    "agent-finance-cli-darwin-arm64": "0.1.0",
-    "agent-finance-cli-darwin-x64": "0.1.0",
-    "agent-finance-cli-linux-arm64": "0.1.0",
-    "agent-finance-cli-linux-x64": "0.1.0",
-    "agent-finance-cli-win32-x64": "0.1.0"
+    "agent-finance-cli-darwin-arm64": "0.1.2",
+    "agent-finance-cli-darwin-x64": "0.1.2",
+    "agent-finance-cli-linux-arm64": "0.1.2",
+    "agent-finance-cli-linux-x64": "0.1.2",
+    "agent-finance-cli-win32-x64": "0.1.2"
   },
   "keywords": [
     "finance",

package/src/app.rs

@@ -21,21 +21,27 @@ use crate::providers::{self, binance_futures, stooq};
 use crate::research;
 use crate::skills;
 use crate::stream;
+use crate::time::resolve_timezone;
 
 pub async fn run() -> Result<()> {
     let cli = Cli::parse();
     let proxy = cli.proxy.as_deref();
     let no_proxy = cli.no_proxy;
-    let timezone = cli.timezone.as_str();
+    let timezone = resolve_timezone(cli.timezone.as_deref())?;
+    let timezone = timezone.as_str();
     let timeout_seconds = cli.timeout_seconds;
     match cli.command {
         Command::Price(args) => run_price(args, proxy, no_proxy, timeout_seconds, timezone).await,
         Command::Sessions(args) => {
             run_sessions(args, proxy, no_proxy, timeout_seconds, timezone).await
         }
-        Command::History(args) => run_history(args, proxy, no_proxy, timeout_seconds).await,
+        Command::History(args) => {
+            run_history(args, proxy, no_proxy, timeout_seconds, timezone).await
+        }
         Command::Indicators(args) => run_indicators(args, proxy, no_proxy, timeout_seconds).await,
-        Command::Futures(args) => run_futures(args, proxy, no_proxy, timeout_seconds).await,
+        Command::Futures(args) => {
+            run_futures(args, proxy, no_proxy, timeout_seconds, timezone).await
+        }
         Command::Fundamentals(args) => {
             run_provider_quote_summary(
                 args,
@@ -193,6 +199,7 @@ async fn run_history(
     proxy: Option<&str>,
     no_proxy: bool,
     timeout_seconds: u64,
+    timezone: &str,
 ) -> Result<()> {
     let client = http_client(timeout_seconds, proxy, no_proxy)?;
     let provider = effective_history_provider(args.provider, args.session);
@@ -213,7 +220,7 @@ async fn run_history(
     if args.json {
         println!("{}", serde_json::to_string_pretty(&history)?);
     } else {
-        output::print_history_table(&history);
+        output::print_history_table(&history, timezone);
     }
     Ok(())
 }
@@ -291,6 +298,7 @@ async fn run_futures(
     proxy: Option<&str>,
     no_proxy: bool,
     timeout_seconds: u64,
+    timezone: &str,
 ) -> Result<()> {
     let client = http_client(timeout_seconds, proxy, no_proxy)?;
     let stats =
@@ -299,7 +307,7 @@ async fn run_futures(
     if args.json {
         println!("{}", serde_json::to_string_pretty(&stats)?);
     } else {
-        output::print_futures_stats(&stats);
+        output::print_futures_stats(&stats, timezone);
     }
 
     if stats.errors.is_empty() {

package/src/cli.rs

@@ -2,7 +2,6 @@ use std::path::PathBuf;
 
 use clap::{Parser, Subcommand, ValueEnum};
 
-use crate::time::DEFAULT_TIMEZONE;
 pub const HISTORY_INTERVAL_HELP: &str = "Bar interval. Provider-specific values: Yahoo 1m/2m/5m/15m/30m/60m/90m/1h/1d/5d/1wk/1mo/3mo; Robinhood 5m/10m/1h/1d/1w; Stooq live 1d/1w/1mo; Stooq bulk 5m/1h after sync; Binance klines 1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M.";
 
 #[derive(Parser, Debug)]
@@ -21,9 +20,10 @@ pub struct Cli {
     #[arg(long, global = true)]
     pub no_proxy: bool,
 
-    /// Human-output timezone. UTC is still preserved in JSON fields.
-    #[arg(long, global = true, default_value = DEFAULT_TIMEZONE)]
-    pub timezone: String,
+    /// Human-output timezone. Defaults to the machine's local IANA timezone.
+    /// UTC is still preserved in JSON fields.
+    #[arg(long, global = true)]
+    pub timezone: Option<String>,
 
     /// HTTP timeout in seconds.
     #[arg(long, global = true, default_value_t = 10)]

package/src/output.rs

@@ -7,6 +7,7 @@ use crate::model::{
     ResearchReport, SearchReport, StreamQuote,
 };
 use crate::page_read::PageReadReport;
+use crate::time::utc_to_local;
 
 pub fn print_price_summary(summary: &PriceSummary, show_all: bool) {
     println!(
@@ -72,7 +73,7 @@ pub fn print_price_summary(summary: &PriceSummary, show_all: bool) {
     }
 }
 
-pub fn print_history_table(history: &HistoryBatch) {
+pub fn print_history_table(history: &HistoryBatch, timezone: &str) {
     println!(
         "{} history via {} interval={} adjustment={} actions={} repair_requested={} repair_applied={}",
         history.symbol,
@@ -101,7 +102,7 @@ pub fn print_history_table(history: &HistoryBatch) {
         .iter()
         .map(|bar| {
             vec![
-                bar.open_time.clone(),
+                local_or_original(&bar.open_time, timezone),
                 money_value(bar.open),
                 money_value(bar.high),
                 money_value(bar.low),
@@ -157,10 +158,12 @@ pub fn print_indicator_table(indicators: &[DerivedIndicator], errors: &BTreeMap<
     print_table(&headers, &rows);
 }
 
-pub fn print_futures_stats(stats: &FuturesStats) {
+pub fn print_futures_stats(stats: &FuturesStats, timezone: &str) {
     println!(
         "{} futures stats via {} fetched_at={}",
-        stats.symbol, stats.provider, stats.fetched_at_utc
+        stats.symbol,
+        stats.provider,
+        local_or_original(&stats.fetched_at_utc, timezone)
     );
     if let Some(ticker) = stats.ticker_24h.as_ref() {
         println!(
@@ -182,14 +185,14 @@ pub fn print_futures_stats(stats: &FuturesStats) {
             money_value(mark.mark_price),
             money_value(mark.index_price),
             pct_value(mark.last_funding_rate.map(|value| value * 100.0)),
-            mark.next_funding_time.as_deref().unwrap_or("-")
+            local_or_original_optional(mark.next_funding_time.as_deref(), timezone)
         );
     }
     if let Some(open_interest) = stats.open_interest.as_ref() {
         println!(
             "open_interest: {} time={}",
             number_value(open_interest.open_interest),
-            open_interest.time.as_deref().unwrap_or("-")
+            local_or_original_optional(open_interest.time.as_deref(), timezone)
         );
     }
     if !stats.funding_rates.is_empty() {
@@ -200,7 +203,7 @@ pub fn print_futures_stats(stats: &FuturesStats) {
             .iter()
             .map(|row| {
                 vec![
-                    row.funding_time.clone().unwrap_or_else(|| "-".to_string()),
+                    local_or_original_optional(row.funding_time.as_deref(), timezone),
                     pct_value(row.funding_rate.map(|value| value * 100.0)),
                     money_value(row.mark_price),
                 ]
@@ -512,6 +515,16 @@ where
         .join("  ")
 }
 
+fn local_or_original_optional(value: Option<&str>, timezone: &str) -> String {
+    value
+        .map(|value| local_or_original(value, timezone))
+        .unwrap_or_else(|| "-".to_string())
+}
+
+fn local_or_original(value: &str, timezone: &str) -> String {
+    utc_to_local(Some(value), timezone).unwrap_or_else(|| value.to_string())
+}
+
 fn money_value(value: Option<f64>) -> String {
     match value {
         Some(value) => format!("${value:.2}"),

package/src/time.rs

@@ -1,7 +1,15 @@
+use anyhow::{Result, anyhow};
 use chrono::{DateTime, SecondsFormat, Utc};
 use chrono_tz::Tz;
 
-pub const DEFAULT_TIMEZONE: &str = "Asia/Singapore";
+const FALLBACK_TIMEZONE: &str = "UTC";
+
+pub fn resolve_timezone(value: Option<&str>) -> Result<String> {
+    match value {
+        Some(value) => parse_timezone_name(value).map(str::to_string),
+        None => Ok(system_timezone()),
+    }
+}
 
 pub fn utc_to_local(value: Option<&str>, timezone: &str) -> Option<String> {
     let value = value?;
@@ -14,8 +22,68 @@ pub fn now_local(timezone: &str) -> String {
 }
 
 pub fn format_local(datetime: DateTime<Utc>, timezone: &str) -> String {
-    let timezone = timezone.parse::<Tz>().unwrap_or(chrono_tz::Asia::Singapore);
+    let timezone = parse_timezone(timezone).expect("timezone must be resolved before formatting");
     datetime
         .with_timezone(&timezone)
         .to_rfc3339_opts(SecondsFormat::Secs, true)
 }
+
+fn system_timezone() -> String {
+    iana_time_zone::get_timezone()
+        .ok()
+        .and_then(|value| parse_timezone_name(&value).ok().map(str::to_string))
+        .unwrap_or_else(|| FALLBACK_TIMEZONE.to_string())
+}
+
+fn parse_timezone_name(value: &str) -> Result<&str> {
+    let value = value.trim();
+    if parse_timezone(value).is_ok() {
+        Ok(value)
+    } else {
+        Err(anyhow!("invalid IANA timezone: {value}"))
+    }
+}
+
+fn parse_timezone(value: &str) -> Result<Tz> {
+    value
+        .parse::<Tz>()
+        .map_err(|_| anyhow!("invalid IANA timezone: {value}"))
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn explicit_timezone_overrides_system_timezone() {
+        assert_eq!(resolve_timezone(Some("UTC")).unwrap(), "UTC");
+    }
+
+    #[test]
+    fn invalid_explicit_timezone_is_rejected() {
+        assert!(resolve_timezone(Some("Not/AZone")).is_err());
+    }
+
+    #[test]
+    fn default_timezone_uses_system_timezone_when_available() {
+        let expected = iana_time_zone::get_timezone()
+            .ok()
+            .and_then(|value| parse_timezone_name(&value).ok().map(str::to_string))
+            .unwrap_or_else(|| FALLBACK_TIMEZONE.to_string());
+
+        assert_eq!(resolve_timezone(None).unwrap(), expected);
+    }
+
+    #[test]
+    fn local_format_uses_explicit_timezone() {
+        let datetime = DateTime::parse_from_rfc3339("2026-06-21T00:00:00Z")
+            .unwrap()
+            .with_timezone(&Utc);
+
+        assert_eq!(format_local(datetime, "UTC"), "2026-06-21T00:00:00Z");
+        assert_eq!(
+            format_local(datetime, "America/New_York"),
+            "2026-06-20T20:00:00-04:00"
+        );
+    }
+}