Struct CliContext 

pub struct CliContext {
    pub json: bool,
    pub quiet: bool,
    pub role: Role,
}

Global CLI state: shared flags + a lazily-initialized Engine.

Fields

json: bool

quiet: bool

User asked for quiet stderr (--quiet). The CLI runs the engine in-process and never installs a tracing_subscriber, so the flag is informational.

role: Role

The invocation-level declared role (--role, agent-trust plan 13), already validated at parse time. Stamped onto every engine this context constructs so mutations record it.

Implementations

impl CliContext

pub fn workspace_shape(&self) -> Option<(WorkspaceShape, PathBuf)>

Resolve the workspace flavour by walking up from cwd. Returns None when no .memstead/workspace.toml is found in any ancestor.

Post-rebuild the marker is shape-neutral — the same .memstead/workspace.toml carries both folder-only workspaces and mem-repo workspaces. The flavour tag comes from whether the workspace root also carries mem-repo/.git/ (mem-repo flavour) or not (folder-only flavour). The lean CLI uses this distinction to surface “this is the lean binary” when the operator points it at a workspace with git-branch mounts.

pub fn cli_engine(&self) -> Result<CliEngine>

Build a CliEngine from the current cwd. The workspace marker .memstead/workspace.toml resolves either flavour; the presence of mem-repo/.git/ switches the engine factory.

On the lean build (--no-default-features) the mem-repo branch surfaces a clear “not built into this binary” error so a user pointing the lean build at a mem-repo workspace gets an actionable signal rather than a confusing “no workspace” bail.

pub fn cli_engine_at(&self, root: &Path) -> Result<CliEngine>

Build a CliEngine rooted at an explicit workspace directory, skipping the cwd walk-up. The flavour is still derived from whether <root>/mem-repo/.git/ is present, so callers that already know the root (e.g. memstead publish --workspace) get the same factory selection as Self::cli_engine. The split also gives subcommands a chdir-free, unit-testable engine seam.

pub fn engine(&self) -> Result<BaseEngine>

Build the unified memstead_base::Engine for a mem-repo-shaped workspace. Delegates to engine_from_workspace_root which handles layout detection, mount enumeration, schema resolution, and readMems hydration in one pass.

Only compiled into the full build — the lean build never sees a mem-repo workspace because cli_engine() rejects it before reaching here.