Struct Roster 

pub struct Roster {
    workspace: Arc<Workspace>,
    pub projects: Vec<ProjectView>,
}

The projects and the per-project lists a view draws them from.

Fields

workspace: Arc<Workspace>

projects: Vec<ProjectView>

Every project in forge.toml, each carrying its catalog sessions; the same list Workspace::list_projects returns.

Implementations

impl Roster

pub(super) fn collect(workspace: Arc<Workspace>) -> Self

pub fn project_named(&self, name: &str) -> Option<&ProjectView>

The project name declares, or None for a name no project declares.

pub fn project_name_for_path(&self, cwd: &str) -> Option<String>

The declared project NAME that owns cwd, matched by the longest configured ancestor path.

pub fn chip_for(&self, project: &ProjectKey) -> Option<SessionChipInfo>

The account chip project renders beside its row, or None when no account would serve it.

pub fn would_bind(&self, project: &ProjectKey) -> bool

Whether a spawn in project would find an account.

pub fn has_domain(&self, slot: &SessionSlot) -> bool

Whether slot has a workspace-side domain registered.

pub fn has_agent(&self, slot: &SessionSlot) -> bool

Whether slot has a live agent handle.

pub fn claude_pid(&self, slot: &SessionSlot) -> Option<u32>

OS pid of slot’s claude subprocess, or None when the session has no live client.

pub fn config_dir(&self, slot: &SessionSlot) -> Option<PathBuf>

The config dir slot’s agent reads, or None when no agent is registered for it.

pub fn cwd_for(&self, slot: &SessionSlot) -> Option<PathBuf>

The directory slot’s agent works in: its project’s root, or the worktree a git worker was forked into.

A session that has not started still resolves. A lead’s directory comes from the project’s own declaration, so a declared-but-unstarted project answers its root; None is a slot naming no loaded project at all, which for a worker means no registry row either.

pub fn document_roots_for(&self, slot: &SessionSlot) -> Vec<PathBuf>

The extra document roots slot’s project declares in forge.toml; empty when it declares none.

pub fn tasks_for_project(&self, project: &str) -> Vec<Task>

The task rows declared under the project named project.

pub fn crons_for_project(&self, project: &str) -> Vec<CronEntry>

The durable cron rows declared under the project named project.