Struct GCCWorkspace 

pub struct GCCWorkspace { /* private fields */ }

Manages the .GCC/ directory structure for one agent project.

Implements the four GCC commands from arXiv:2508.00031v2:

• COMMIT (§3.2): milestone checkpointing
• BRANCH (§3.3): isolated reasoning workspace
• MERGE (§3.4): synthesise divergent paths
• CONTEXT (§3.5): hierarchical memory retrieval

Implementations

impl GCCWorkspace

pub fn new(project_root: impl AsRef<Path>) -> Self

pub fn init(&mut self, project_roadmap: &str) -> Result<()>

Initialise a new GCC workspace.

pub fn load(&mut self) -> Result<()>

Load an existing GCC workspace.

pub fn log_ota( &self, observation: &str, thought: &str, action: &str, ) -> Result<OTARecord>

Append an OTA step to the current branch’s log.md. The paper logs continuous Observation–Thought–Action cycles.

pub fn commit( &self, contribution: &str, previous_summary: Option<&str>, update_roadmap: Option<&str>, ) -> Result<CommitRecord>

COMMIT command (paper §3.2).

Persists a milestone checkpoint to commit.md with fields: Branch Purpose, Previous Progress Summary, This Commit’s Contribution.

pub fn branch(&mut self, name: &str, purpose: &str) -> Result<()>

BRANCH command (paper §3.3).

Creates isolated workspace: B_t^(name) = BRANCH(M_{t-1}). Initialises empty OTA trace and commit.md; metadata records intent.

pub fn merge( &mut self, branch_name: &str, summary: Option<&str>, target: &str, ) -> Result<CommitRecord>

MERGE command (paper §3.4).

Integrates a completed branch back into target (default: main), merging summaries and execution traces into a unified state.

pub fn context(&self, branch: Option<&str>, k: usize) -> Result<ContextResult>

CONTEXT command (paper §3.5).

Retrieves historical context at K-commit resolution. Paper experiments use K=1 (only most recent commit revealed).

pub fn current_branch(&self) -> &str

pub fn switch_branch(&mut self, name: &str) -> Result<()>

pub fn list_branches(&self) -> Vec<String>