quiver-agent 0.1.3

Background daily-task agent that observes Claude Code sessions and writes hint files
Documentation 
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

//! Phase 6 — daily-task agent + learning loop.
//!
//! `run(cfg)` tails Claude Code session JSONL files, calls the recommender
//! whenever a new user message arrives, writes a hint markdown for the
//! current session, records the top-1 as a pending `agent_suggestion`, and
//! marks suggestions accepted when the user actually invokes the suggested
//! tool. `digest(cfg)` produces a markdown report for a sliding window.

pub mod classify;
pub mod digest;
pub mod hint;
pub mod recommend;
pub mod tail;

mod engine;

use std::path::PathBuf;
use std::sync::Arc;

pub use classify::{ClassifiedTask, HaikuClassifier, NoopClassifier, TaskClassifier};
pub use digest::digest;
pub use engine::run;

/// Runtime config for the agent loop.
#[derive(Clone)]
pub struct AgentConfig {
    /// SQLite path. Default: `default_db_path()` (caller-provided).
    pub db_path: PathBuf,
    /// Root containing `<dir>/<session>.jsonl` files. Default: `~/.claude/projects`.
    pub sessions_dir: PathBuf,
    /// Where to write `<session>.md` hint files. Default: `~/.claude/hints`.
    pub hints_dir: PathBuf,
    /// How long after a suggestion a matching `tool_use` still counts as
    /// "accepted". Default: 60 minutes.
    pub acceptance_window_minutes: i64,
    /// How often the engine recomputes `tool_scores` (seconds).
    pub score_recompute_interval_secs: u64,
    /// Number of recommendations to write into the hint file.
    pub top_k: usize,
    /// Optional task classifier. `None` ⇒ raw user text is sent to the
    /// recommender verbatim (default). When set, every `UserText` event is
    /// piped through the classifier first; non-task messages are dropped and
    /// real tasks are rewritten into a focused query before embedding.
    pub classifier: Option<Arc<dyn TaskClassifier>>,
}

impl AgentConfig {
    pub fn new(db_path: PathBuf, sessions_dir: PathBuf, hints_dir: PathBuf) -> Self {
        Self {
            db_path,
            sessions_dir,
            hints_dir,
            acceptance_window_minutes: 60,
            score_recompute_interval_secs: 60,
            top_k: 3,
            classifier: None,
        }
    }

    pub fn with_classifier(mut self, classifier: Arc<dyn TaskClassifier>) -> Self {
        self.classifier = Some(classifier);
        self
    }
}