Struct VcsAgentConfig 

pub struct VcsAgentConfig {
    pub git_mode: String,
    pub p4_mode: String,
    pub init_baseline_commit: bool,
    pub ceiling_always: bool,
}

VCS environment isolation configuration for spawned agents (v0.13.17.3).

Controls how TA configures the agent’s VCS environment so it operates on the staging directory instead of the developer’s real repository.

[vcs.agent]
git_mode = "isolated"   # "isolated" | "inherit-read" | "none"
p4_mode = "shelve"      # "shelve" | "read-only" | "inherit"
init_baseline_commit = true
ceiling_always = true

Fields

git_mode: String

Git isolation mode.

• "isolated" (default): git init in staging with a baseline commit. Agent gets its own isolated .git. GIT_CEILING_DIRECTORIES blocks upward traversal into the developer’s real repo.
• "inherit-read": Sets GIT_CEILING_DIRECTORIES only. Agent can read parent git history (log, blame) but write operations are scoped away.
• "none": Sets GIT_DIR=/dev/null. All git operations fail immediately.

p4_mode: String

Perforce isolation mode.

• "shelve" (default): Agent uses a dedicated staging P4 workspace. Submit is blocked; shelve is allowed.
• "read-only": Injects P4CLIENT= (empty). No P4 writes possible.
• "inherit": Agent inherits the developer’s P4CLIENT. Only for workflows that explicitly need live P4 access.

init_baseline_commit: bool

Whether to create an initial “pre-agent” baseline commit in isolated git mode.

When true (default), git init + git add -A + git commit -m "pre-agent baseline" runs before the agent starts. The agent can then use git diff, git log, etc. against a clean history.

ceiling_always: bool

Whether to always set GIT_CEILING_DIRECTORIES regardless of mode.

When true (default), GIT_CEILING_DIRECTORIES is set to the staging dir’s parent even in inherit-read and isolated modes, preventing git from traversing into parent directories beyond the ceiling.

Trait Implementations

impl Clone for VcsAgentConfig

fn clone(&self) -> VcsAgentConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VcsAgentConfig

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

Formats the value using the given formatter.

impl Default for VcsAgentConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for VcsAgentConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for VcsAgentConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.