Enum TaskContext 

pub enum TaskContext {
    Staged {
        include_unstaged: bool,
    },
    Commit {
        commit_id: String,
    },
    Range {
        from: String,
        to: String,
    },
    Changelog {
        from: String,
        to: String,
        version_name: Option<String>,
        date: String,
    },
    Amend {
        original_message: String,
    },
    Discover,
}

Validated, structured context for agent tasks.

This enum represents the different modes of operation for code analysis, with validation built into the constructors.

Variants

Staged

Analyze staged changes (optionally including unstaged)

Fields

include_unstaged: bool

Whether to include unstaged changes in analysis

Commit

Analyze a single commit

Fields

commit_id: String

The commit ID (hash, branch name, or commitish like HEAD~1)

Range

Analyze a range of commits or branch comparison

Fields

from: String

Starting reference (exclusive)

to: String

Ending reference (inclusive)

Changelog

Generate changelog or release notes with version metadata

Fields

from: String

Starting reference (exclusive)

to: String

Ending reference (inclusive)

version_name: Option<String>

Explicit version name (e.g., “1.2.0”)

date: String

Release date in YYYY-MM-DD format

Amend

Amend the previous commit with staged changes The agent sees the combined diff from HEAD^1 to staged state

Fields

original_message: String

The original commit message being amended

Discover

Let the agent discover context via tools (default for gen command)

Implementations

impl TaskContext

pub fn for_gen() -> Self

Create context for the gen (commit message) command. Always uses staged changes only.

pub fn for_amend(original_message: String) -> Self

Create context for amending the previous commit. The agent will see the combined diff from HEAD^1 to staged state.

pub fn for_review( commit: Option<String>, from: Option<String>, to: Option<String>, include_unstaged: bool, ) -> Result<Self>

Create context for the review command with full parameter validation.

Validates:

• --from requires --to for explicit range comparison
• --to on its own compares <fallback-base>..to
• --commit is mutually exclusive with --from/--to
• --include-unstaged is incompatible with range comparisons

Errors

Returns an error when the provided flag combination is invalid.

pub fn for_review_with_base( commit: Option<String>, from: Option<String>, to: Option<String>, include_unstaged: bool, default_base: &str, ) -> Result<Self>

Create review context with an explicit default base for --to-only comparisons.

CLI and Studio should prefer a repo-aware base from GitRepo::get_default_base_ref(). This lets branch comparisons follow the repository’s actual primary branch instead of relying on the legacy "main" fallback.

Errors

Returns an error when the provided flag combination is invalid.

pub fn for_pr(from: Option<String>, to: Option<String>) -> Self

Create context for the PR command.

PR command is more flexible - all parameter combinations are valid:

• from + to: Explicit range/branch comparison
• from only: Compare from..HEAD
• to only: Compare <fallback-base>..to
• Neither: Compare <fallback-base>..HEAD

pub fn for_pr_with_base( from: Option<String>, to: Option<String>, default_base: &str, ) -> Self

Create PR context with an explicit default comparison base.

CLI and Studio should prefer a repo-aware base from GitRepo::get_default_base_ref().

pub fn for_changelog( from: String, to: Option<String>, version_name: Option<String>, date: Option<String>, ) -> Self

Create context for changelog/release-notes commands.

These always require a from reference; to defaults to HEAD. Automatically sets today’s date if not provided.

pub fn to_prompt_context(&self) -> String

Generate a human-readable prompt context string for the agent.

pub fn diff_hint(&self) -> String

Generate a hint for which git_diff call the agent should make.

pub fn is_range(&self) -> bool

Check if this context represents a range comparison (vs staged/single commit)

pub fn includes_unstaged(&self) -> bool

Check if this context involves unstaged changes

pub fn is_amend(&self) -> bool

Check if this is an amend operation

pub fn original_message(&self) -> Option<&str>

Get the original commit message if this is an amend context

Trait Implementations

impl Clone for TaskContext

fn clone(&self) -> TaskContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskContext

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

Formats the value using the given formatter.

impl Default for TaskContext

fn default() -> TaskContext

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TaskContext

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for TaskContext

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

Formats the value using the given formatter.

impl Serialize for TaskContext

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

where __S: Serializer,

Serialize this value into the given Serde serializer.