Struct Buffer 

pub struct Buffer { /* private fields */ }

Manager for the retrospective buffer.

Implementations

impl Buffer

pub fn new(config: Config) -> Self

Create a new buffer manager.

pub fn is_enabled(&self) -> bool

Check if buffering is enabled.

pub fn init(&self) -> Result<()>

Initialize the buffer directory with secure permissions.

pub fn should_exclude(&self, cmd: &str) -> bool

Check if a command should be excluded from buffering.

Combines hooks.ignore_patterns and buffer.exclude_patterns.

pub fn start_entry( &self, cmd: &str, cwd: &str, session_id: &str, ) -> Result<Uuid>

Start a new buffer entry. Returns the entry ID for writing output.

pub fn complete_entry( &self, id: &Uuid, exit_code: i32, duration_ms: i64, ) -> Result<()>

Complete a buffer entry with exit code and duration.

pub fn write_complete_entry( &self, cmd: &str, cwd: &str, session_id: &str, exit_code: i32, duration_ms: Option<i64>, output: Option<&[u8]>, ) -> Result<Uuid>

Write a complete buffer entry at once (for shq save --to-buffer).

This is used when all data is available at once (command already completed).

pub fn list_entries(&self) -> Result<Vec<BufferEntry>>

List all buffer entries, sorted by start time (most recent first).

pub fn get_by_position(&self, position: usize) -> Result<Option<BufferEntry>>

Get a buffer entry by position (1 = most recent).

pub fn get_by_id(&self, id: &Uuid) -> Result<Option<BufferEntry>>

Get a buffer entry by ID.

pub fn read_output(&self, entry: &BufferEntry) -> Result<Vec<u8>>

Read output from a buffer entry.

pub fn delete_entry(&self, id: &Uuid) -> Result<()>

Delete a buffer entry.

pub fn clear(&self) -> Result<usize>

Clear all buffer entries.

pub fn rotate(&self) -> Result<usize>

Rotate buffer entries based on configured limits.