Struct BeadStore 

pub struct BeadStore { /* private fields */ }

SQLite-backed bead store

BeadStore provides persistent storage for beads (tasks/issues) using SQLite. It handles creation, retrieval, updating, and deletion of beads, as well as managing their dependencies and status transitions.

The store is located at ~/.pawan/beads.db by default.

Features

• Create, read, update, and delete beads
• Query beads by status, priority, or search term
• Manage bead dependencies
• Track bead history and transitions
• Efficient indexing for large numbers of beads

Implementations

impl BeadStore

pub fn open() -> Result<Self>

Open or create the bead store

pub fn with_conn(conn: Connection) -> Result<Self>

Open with custom connection (for testing)

pub fn create( &self, title: &str, description: Option<&str>, priority: u8, ) -> Result<Bead>

Create a new bead

pub fn get(&self, id: &BeadId) -> Result<Bead>

Get a bead by ID

pub fn update( &self, id: &BeadId, title: Option<&str>, status: Option<BeadStatus>, priority: Option<u8>, ) -> Result<()>

Update a bead’s fields

pub fn close(&self, id: &BeadId, reason: Option<&str>) -> Result<()>

Close a bead with optional reason

pub fn delete(&self, id: &BeadId) -> Result<()>

Delete a bead

pub fn list( &self, status: Option<&str>, max_priority: Option<u8>, ) -> Result<Vec<Bead>>

List beads with optional filters

pub fn dep_add(&self, bead_id: &BeadId, depends_on: &BeadId) -> Result<()>

Add a dependency: bead_id depends on depends_on

pub fn dep_remove(&self, bead_id: &BeadId, depends_on: &BeadId) -> Result<()>

Remove a dependency

pub fn deps(&self, bead_id: &BeadId) -> Result<Vec<BeadId>>

Get dependencies of a bead

pub fn ready(&self) -> Result<Vec<Bead>>

Ready beads: Open beads whose ALL dependencies are Closed

pub fn memory_decay(&self, max_age_days: u64) -> Result<usize>

Memory decay: summarize closed beads older than max_age_days into archive