Struct WorkflowConfig 

pub struct WorkflowConfig {

    pub submit: SubmitConfig,
    pub source: SourceConfig,
    pub diff: DiffConfig,
    pub display: DisplayConfig,
    pub build: BuildConfig,
    pub gc: GcConfig,
    pub follow_up: FollowUpConfig,
    pub verify: VerifyConfig,
    pub shell: ShellConfig,
    pub notify: NotifyConfig,
    pub staging: StagingConfig,
    pub constitution: ConstitutionConfig,
    pub sandbox: SandboxConfig,
    pub audit: AuditConfig,
    pub governance: GovernanceConfig,
    pub vcs: VcsConfig,
    pub plan: PlanConfig,
    pub supervisor: SupervisorConfig,
    pub draft: DraftReviewConfig,
    pub workflow: WorkflowSection,
    pub required_checks: Vec<String>,
    pub apply: ApplyConfig,
    pub ta: TaPathConfig,
    pub commit: CommitConfig,
    pub project: ProjectSection,
    pub analysis: HashMap<String, AnalysisConfig>,
    pub security: SecurityConfig,
    pub agent_profiles: HashMap<String, AgentProfile>,
}

Top-level workflow configuration from .ta/workflow.toml

Fields

submit: SubmitConfig

Submit adapter configuration

source: SourceConfig

Source sync configuration (v0.11.1)

diff: DiffConfig

Diff viewing configuration

display: DisplayConfig

Display / output configuration

build: BuildConfig

Build configuration

gc: GcConfig

Garbage collection / lifecycle configuration

follow_up: FollowUpConfig

Follow-up goal behavior configuration

verify: VerifyConfig

Pre-draft verification gate configuration

shell: ShellConfig

Shell TUI configuration

notify: NotifyConfig

Desktop notification configuration

staging: StagingConfig

Staging directory management (v0.11.3)

constitution: ConstitutionConfig

Constitution / compliance checker configuration (v0.12.0)

sandbox: SandboxConfig

Agent sandboxing configuration (v0.14.0)

audit: AuditConfig

Audit log attestation configuration (v0.14.1)

governance: GovernanceConfig

Draft approval governance configuration (v0.14.2)

vcs: VcsConfig

VCS configuration (v0.13.17.3)

plan: PlanConfig

Plan file configuration (v0.14.12).

supervisor: SupervisorConfig

Supervisor agent configuration (v0.13.17.4)

draft: DraftReviewConfig

Draft review configuration (v0.15.4)

workflow: WorkflowSection

Workflow behavior configuration (v0.14.3)

required_checks: Vec<String>

Commands to run after agent exit to produce hard validation evidence (v0.13.17).

Each command is run in the staging workspace. Results are embedded in the DraftPackage as validation_log. Non-zero exit code blocks ta draft approve unless --override is passed.

Default (empty): no required checks. Set in .ta/workflow.toml:

required_checks = ["cargo build --workspace", "cargo test --workspace"]

apply: ApplyConfig

Per-file conflict resolution policy for ta draft apply (v0.14.3.5).

Specifies how conflicts are resolved when both the agent and an external commit touch the same file. Override globally or per-file/glob:

[apply.conflict_policy]
default = "merge"            # attempt 3-way merge first
"PLAN.md" = "keep-source"   # TA owns this — never let agents overwrite
"Cargo.lock" = "keep-source" # auto-generated, always regenerated by cargo
"docs/**" = "merge"
"src/**" = "abort"          # code conflicts need human review

Valid values: "abort", "merge", "keep-source", "force-overwrite". Default when section is absent: the --conflict-resolution CLI flag value.

ta: TaPathConfig

Config-driven TA project/local file classification (v0.14.3.5).

Specifies which .ta/ files belong to the project (committed to VCS) and which are machine-local only (gitignored). At ta init time, these are written with the defaults from partitioning.rs.

Example:

[ta.project]
include_paths = ["workflow.toml", "policy.yaml", "agents/"]

[ta.local]
exclude_paths = ["staging/", "goals/", "store/"]

commit: CommitConfig

Commit auto-staging configuration (v0.14.3.7).

Lists additional files/globs that are always staged alongside a draft apply commit, merged with the built-in lock file list. Use this for project-specific generated files that are always correct to include.

[commit]
auto_stage = [
    "Cargo.lock",
    ".ta/plan_history.jsonl",
    "docs/generated/**",
]

project: ProjectSection

Project metadata shown in TA Studio (v0.14.18).

[project]
name = "My Pipeline Project"

analysis: HashMap<String, AnalysisConfig>

Per-language static analysis configuration (v0.15.14.3).

Keys are language names (python, typescript, rust, go).

[analysis.python]
tool = "mypy"
args = ["--strict"]
on_failure = "agent"
max_iterations = 3

[analysis.rust]
tool = "cargo-clippy"
args = ["-D", "warnings"]
on_failure = "warn"

security: SecurityConfig

Security level profile configuration (v0.15.14.4).

Sets a named preset of security defaults. Individual settings always override the level preset.

[security]
level = "mid"   # "low" | "mid" | "high"

agent_profiles: HashMap<String, AgentProfile>

Named agent profiles that supervisor and workflow steps can reference.

[agent_profiles.supervisor]
framework = "claude"
model = "claude-sonnet-4-6"

Implementations

impl WorkflowConfig

pub fn load(path: &Path) -> Result<Self, Box<dyn Error>>

Load workflow config from .ta/workflow.toml, merging any local override file on top.

Override file resolution (first found wins):

1. <dir>/workflow.local.toml — canonical name
2. <dir>/local.workflow.toml — deprecated name (warns and falls back)

pub fn load_or_default(path: &Path) -> Self

Try to load config, returning default if file doesn’t exist

Trait Implementations

impl Clone for WorkflowConfig

fn clone(&self) -> WorkflowConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkflowConfig

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

Formats the value using the given formatter.

impl Default for WorkflowConfig

fn default() -> WorkflowConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WorkflowConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WorkflowConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.