Struct StateApi 

pub struct StateApi {
    pub prune_throttle: PruneThrottle,
    /* private fields */
}

State management system calls.

All data persistence: file (JSON/Markdown) storage, session management.

Fields

prune_throttle: PruneThrottle

Throttle for auto-prune to avoid excessive disk scans.

Implementations

impl StateApi

pub fn new(state_store: Arc<StateStore>) -> Self

Create a new StateApi.

pub async fn save<T: Serialize>( &self, category: &str, name: &str, data: &T, ) -> Result<()>

Save JSON data.

pub async fn save_markdown( &self, category: &str, name: &str, content: &str, ) -> Result<()>

Save markdown content.

pub async fn load<T: DeserializeOwned>( &self, category: &str, name: &str, ) -> Result<Option<T>>

Load JSON data.

pub async fn load_markdown( &self, category: &str, name: &str, ) -> Result<Option<String>>

Load markdown content.

pub async fn delete(&self, category: &str, name: &str) -> Result<bool>

Delete a file.

pub async fn list_category(&self, category: &str) -> Result<Vec<String>>

List files in a category.

pub fn commit_all( &self, git: &GitLayer, message: &str, ) -> Result<Option<CommitInfo>>

Commit all changes to git via the provided GitLayer.

Returns:

• Ok(None) when git is disabled (no-op).
• Ok(Some(info)) on a successful commit.
• Err(...) when the commit fails — callers must not conflate this with “git disabled”, or a broken repo will silently look healthy.

pub async fn save_session(&self, session: &Session) -> Result<()>

Save session.

pub async fn load_session(&self, id: &SessionId) -> Result<Option<Session>>

Load session.

pub async fn list_sessions(&self) -> Result<Vec<SessionSummary>>

List sessions.

pub async fn load_all_sessions(&self) -> Result<Vec<Session>>

RFC-025 Phase 5: Load all sessions in full (for the promotion scanner).

pub async fn delete_session(&self, id: &SessionId) -> Result<bool>

Delete session.

pub async fn move_session_to_project( &self, id: &SessionId, project_id: Option<&str>, ) -> Result<bool>

RFC-025: Move a session to a different Project (drag-to-reparent).

pub fn workspace_path(&self) -> &Path

Get workspace base path.

pub fn store(&self) -> &Arc<StateStore>

Access the underlying StateStore (for backup/restore).

pub async fn prune_sessions(&self, config: &PruneConfig) -> Result<usize>

Prune sessions based on configuration.

Removes sessions that exceed TTL or exceed the maximum count.

pub fn should_auto_prune(&self) -> bool

Check if auto-prune should run (respects cooldown throttle).