Struct ControlBackend 

pub struct ControlBackend { /* private fields */ }

JSON-RPC client after a matching initialize.

Implementations

impl ControlBackend

pub fn connect( path: &Path, layout: &Layout, agent: &str, ) -> Result<Self, ControlAttachError>

Connect, initialize with a required agent, and refuse a root/prefix mismatch so mutations never hit the wrong vault.

pub fn connect_as( path: &Path, layout: &Layout, agent: &str, client: &str, ) -> Result<Self, ControlAttachError>

Same as Self::connect with an explicit initialize.client name.

Trait Implementations

impl BoardBackend for ControlBackend

fn layout(&self) -> &Layout

fn generation(&self) -> u64

fn revision(&self) -> u64

fn live(&self) -> BackendKind

fn identity(&self) -> &str

fn list(&self, q: ListQuery) -> Result<ListPage, Error>

fn ready(&self, project: Option<&str>) -> Result<ListPage, Error>

fn get(&self, id: &str) -> Result<IssueDetail, Error>

fn excerpt(&self, id: &str) -> Result<Excerpt, Error>

fn search(&self, query: &str, limit: usize) -> Result<Vec<SearchHit>, Error>

fn claims( &self, holder: Option<&str>, project: Option<&str>, ) -> Result<Vec<ClaimRow>, Error>

fn agenda( &self, days: i64, project: Option<&str>, ) -> Result<Vec<AgendaRow>, Error>

fn tree(&self, id: &str) -> Result<TreeNode, Error>

fn related( &self, id: &str, depth: usize, limit: usize, ) -> Result<Vec<RelatedHit>, Error>

fn projects(&self) -> Result<Vec<String>, Error>

fn claim(&self, id: &str, force: bool) -> Result<MutResult, Error>

fn note(&self, id: &str, text: &str) -> Result<MutResult, Error>

fn update(&self, req: UpdateReq) -> Result<MutResult, Error>

fn open(&self, id: &str) -> Result<IssueDetail, Error>

fn wait(&self, last: u64, timeout_ms: u64) -> Result<u64, Error>

Core: wait on the file generation. Control: wait for vault/changed.

fn last_since_revision(&self) -> Option<Option<u64>>

Last since_revision sent on list/ready. None means the field was omitted. Default is “not recorded”.

fn invalidate_since(&self)

Drop since_revision on the next list/ready. Serve unchanged is catalog-wide, so a pane or project change must fetch a full page.

fn refresh(&self) -> Result<(), Error>

Re-read the files. Core uses this after an out-of-band write such as ops::create. Control is a no-op; serve sees the file event.