Struct ProjectView 

pub struct ProjectView {
    pub key: ProjectKey,
    pub name: String,
    pub org: String,
    pub path: PathBuf,
    pub display_path: String,
    pub accounts: Vec<String>,
    pub fallback_accounts: Vec<String>,
    pub has_model: bool,
    pub sessions: Vec<SessionView>,
}

One project from the catalog plus its sessions, sorted last- activity descending. sessions[0] is the lead. Empty sessions means the project has no on-disk history yet.

Fields

key: ProjectKey

name: String

The toml name field from forge.toml. Distinct from key, which is the canonicalised on-disk project key derived from the project’s path. Callers wanting to address a project via crate::SessionTarget::Named use this value; callers keying a HashMap of in-process Agent handles use Self::key.

org: String

Name of the org this project belongs to (from [[orgs]].name in forge.toml). Drives the org-grouping in the Projects pane tree render.

path: PathBuf

Filesystem-resolved project root (~ expanded). This is the path callers should hand to filesystem APIs - cwd_raw for the spawning bucket, file_index::restart, the git-context watcher, etc. Use Self::display_path for human-readable rendering instead.

display_path: String

Human-readable rendering of the project’s root path (e.g. ~/Projects/forge, with ~ left in place rather than expanded). Display-only - not a path you can open().

accounts: Vec<String>

Account display_names this project may spawn under, inherited from the project’s [[orgs]] entry. Non-empty (the config loader enforces).

fallback_accounts: Vec<String>

Fallback display_names inherited from the project’s [[orgs]] entry, alongside accounts. Empty when the org names none.

has_model: bool

true when the project declares model. A spawn under a project without one is refused, so the launchpad’s row needs to tell the two reasons no spawn can run apart: no model to match on, or no account that could serve it.

sessions: Vec<SessionView>

Implementations

impl ProjectView

pub fn new_for_test( key: ProjectKey, name: impl Into<String>, display_path: impl Into<String>, sessions: Vec<SessionView>, ) -> Self

Test-only constructor for cross-crate fixtures (a view’s Projects pane snapshot tests). Behind the test-helpers Cargo feature to keep test-only construction out of the production API.

pub fn new_for_test_with_org( key: ProjectKey, name: impl Into<String>, display_path: impl Into<String>, org: impl Into<String>, accounts: Vec<String>, fallback_accounts: Vec<String>, sessions: Vec<SessionView>, ) -> Self

Variant of Self::new_for_test that lets the fixture supply an org + accounts list.

Trait Implementations

impl Clone for ProjectView

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProjectView

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProjectView

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProjectView

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.