Struct Project 

pub struct Project { /* private fields */ }

A project (directory containing session JSONL files)

Implementations

impl Project

pub fn new(id: ProjectId, storage_dir: PathBuf) -> Project

Create a new project reference

pub fn load(storage_dir: &Path) -> Result<Project, Error>

Load project from storage directory

Errors

Returns error if the directory does not exist, is not a directory, has an invalid or non-UTF-8 name, or if the encoded path cannot be decoded.

pub fn id(&self) -> &ProjectId

Get project ID

pub fn storage_dir(&self) -> &Path

Get storage directory path

pub fn sessions(&self) -> Result<Vec<Session>, Error>

List all sessions in this project

Errors

Returns error if the project directory cannot be read.

pub fn has_sessions(&self) -> Result<bool, Error>

Check if project has any sessions

Errors

Returns error if the project directory cannot be read.

pub fn count_sessions(&self) -> Result<usize, Error>

Count sessions without loading them

Errors

Returns error if the project directory cannot be read.

pub fn count_sessions_split(&self) -> Result<(usize, usize), Error>

Count sessions by type using filename inspection only — no JSONL parsing.

Returns (main_sessions, agent_sessions). Agent sessions are identified by the agent- filename prefix; all other sessions are main sessions.

Performance

O(N) directory listing only. Suitable for status/stats commands that need session counts without entry-level detail.

Errors

Returns error if the project directory cannot be read.

pub fn all_sessions(&self) -> Result<Vec<Session>, Error>

List all sessions including agent sessions

Errors

Returns error if the project directory cannot be read.

pub fn project_stats(&self) -> Result<ProjectStats, Error>

Compute project statistics

Aggregates statistics from all sessions (main and agent) in this project.

Errors

Returns error if the project directory cannot be read or if a session file cannot be parsed.

pub fn sessions_filtered( &mut self, filter: &SessionFilter, ) -> Result<Vec<Session>, Error>

List sessions matching filter

Filtering Logic

Returns only sessions that match ALL filter conditions (AND logic):

• agent_only: Filter by agent/main session type
• min_entries: Minimum entry count
• session_id_substring: Session ID substring match (case-insensitive)

Examples

use claude_storage_core::{ Storage, SessionFilter };

let storage = Storage::new().unwrap();
let mut project = storage.list_projects().unwrap().into_iter().next().unwrap();

// Filter for agent sessions with 10+ entries
let filter = SessionFilter
{
  agent_only : Some( true ),
  min_entries : Some( 10 ),
  session_id_substring : None,
};

let sessions = project.sessions_filtered( &filter ).unwrap();

Errors

Returns error if the project directory cannot be read or if session filtering fails (e.g., cannot read a session file for entry count).

pub fn matches_filter(&self, filter: &ProjectFilter) -> Result<bool, Error>

Check if project matches filter

Filtering Logic

All filter conditions must match (AND logic):

• path_substring: Path substring match (case-insensitive)
• min_entries: Minimum total entries across all sessions
• min_sessions: Minimum session count

Examples

use claude_storage_core::{ Storage, ProjectFilter };

let storage = Storage::new().unwrap();
let project = storage.list_projects().unwrap().into_iter().next().unwrap();

let filter = ProjectFilter
{
  path_substring : Some( "myproject".to_string() ),
  min_entries : None,
  min_sessions : Some( 5 ),
};

assert!( project.matches_filter( &filter ).unwrap() );

Errors

Returns error if reading session counts or project statistics fails.

Trait Implementations

impl Debug for Project

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.