claude-smart 0.2.11

Cross-platform Claude Code smart session manager
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

//! Account pick + scoring public surface.
//!
//! This module is the entry-point for account-selection logic:
//!
//! - [`pick_account`] — choose the best profile to launch under (spec §2).
//! - [`current_usage`] — emit `(session_pct, week_all_pct)` for one profile.
//! - [`ProfileMap`] — re-exported profile→dir map loaded from `profiles.json`.
//!
//! Submodules:
//! - `profiles` — load `~/.config/claude-as/profiles.json` (REAL impl).
//! - `scoring`  — scoring/tie-break/exclusions (stub, Phase 6).
//! - `reset`    — parse `"Jun 4 at 9pm (Asia/Seoul)"` → UTC epoch (stub, Phase 6).

pub mod profiles;
pub mod reset;
pub mod scoring;

pub use profiles::ProfileMap;

use crate::usage::{self, UsageData};
use scoring::{ScoringError, ScoringResult};

/// Choose the best profile to switch to.
///
/// # Parameters
/// - `current_profile`: name of the currently active profile (from the leaf of
///   `CLAUDE_CONFIG_DIR`, or empty string when unset).
/// - `include_current`: when `true`, return `Ok(None)` if the winner equals
///   `current_profile` (no-op switch).
///
/// # Returns
/// - `Ok(Some(name))` — caller should switch `CLAUDE_CONFIG_DIR` to this profile.
/// - `Ok(None)` — winner is already current (`include_current` was `true`).
/// - `Err(ScoringError::AllSaturated)` — no viable candidate; caller warns and
///   keeps the current profile.
/// - `Err(ScoringError::FetchFailed(_))` — hub down / negative-cache active;
///   caller opens the hub-down interactive picker (spec §4a).
///
/// Applies the staleness gate (proactive / CLI path). For the reactive hook —
/// which must switch off an already-limited profile even on stale data — use
/// [`pick_account_gated`] with `apply_stale_gate=false`.
pub fn pick_account(current_profile: &str, include_current: bool) -> ScoringResult {
    pick_account_gated(current_profile, include_current, true)
}

/// [`pick_account`] with explicit control over the staleness gate.
///
/// `apply_stale_gate=true` is the proactive / CLI behaviour (refuse to score on
/// stale data → caller opens the picker). `apply_stale_gate=false` is the
/// reactive-hook behaviour: the hook fires because the current profile already
/// hit a limit and is non-interactive, so it scores even on stale numbers to
/// pick the freshest-known best rather than strand the user on the limited
/// profile. See [`scoring::pick_best`] for the gate rationale.
pub fn pick_account_gated(
    current_profile: &str,
    include_current: bool,
    apply_stale_gate: bool,
) -> ScoringResult {
    let data: UsageData = usage::fetch().map_err(ScoringError::FetchFailed)?;
    scoring::pick_best_gated(&data, current_profile, include_current, apply_stale_gate)
}

/// Return `(session_pct, week_all_pct)` for `profile`, or `None` when the
/// profile is errored, absent from the cache, or the fetch fails.
///
/// Spec §2: `current-usage <profile>` → `<session_pct> <week_all_pct>` on
/// stdout, or empty (errored profile ⇒ empty).
pub fn current_usage(profile: &str) -> Option<(i64, i64)> {
    let data = usage::fetch().ok()?;
    data.current_usage(profile)
}