Struct Intent 

pub struct Intent { /* private fields */ }

The entry point of every AI-assisted workflow.

An Intent captures both the verbatim user input (prompt) and the AI’s structured understanding of that input (content). It is created at step ② and completed at step ⑩ of the end-to-end flow. See module documentation for lifecycle position, status transitions, and conversational refinement.

Implementations

impl Intent

pub fn new( created_by: ActorRef, prompt: impl Into<String>, ) -> Result<Self, String>

Create a new intent in Draft status from a raw user prompt.

The content field is initially None — call set_content after the AI has analyzed the prompt.

pub fn header(&self) -> &Header

Returns a reference to the common header.

pub fn prompt(&self) -> &str

Returns the raw user prompt.

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

Returns the AI-analyzed content, if available.

pub fn set_content(&mut self, content: Option<String>)

Sets the AI-analyzed content.

pub fn parent(&self) -> Option<Uuid>

Returns the parent intent ID, if this is part of a refinement chain.

pub fn commit(&self) -> Option<&IntegrityHash>

Returns the result commit SHA, if the intent has been fulfilled.

pub fn status(&self) -> Option<&IntentStatus>

Returns the current lifecycle status (the last entry in the history).

Returns None only if statuses is empty, which should not happen for objects created via Intent::new (seeds with Draft), but may occur for malformed deserialized data.

pub fn statuses(&self) -> &[StatusEntry]

Returns the full chronological status history.

pub fn set_parent(&mut self, parent: Option<Uuid>)

Links this intent to a parent intent for conversational refinement.

pub fn set_commit(&mut self, sha: Option<IntegrityHash>)

Records the git commit SHA that fulfilled this intent.

pub fn plan(&self) -> Option<Uuid>

Returns the associated Plan ID, if a Plan has been derived from this intent.

pub fn set_plan(&mut self, plan: Option<Uuid>)

Associates this intent with a Plan.

pub fn set_status(&mut self, status: IntentStatus)

Transitions the intent to a new lifecycle status, appending to the history.

pub fn set_status_with_reason( &mut self, status: IntentStatus, reason: impl Into<String>, )

Transitions the intent to a new lifecycle status with a reason.

Trait Implementations

impl Clone for Intent

fn clone(&self) -> Intent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Intent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Intent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Intent

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

Formats the value using the given formatter.

impl ObjectTrait for Intent

fn from_bytes(data: &[u8], _hash: ObjectHash) -> Result<Self, GitError>

where Self: Sized,

Creates a new object from a byte slice.

fn get_type(&self) -> ObjectType

Returns the type of the object.

fn get_size(&self) -> usize

fn to_data(&self) -> Result<Vec<u8>, GitError>

fn from_buf_read<R: BufRead>(read: &mut ReadBoxed<R>, size: usize) -> Self

where Self: Sized,

Generate a new Object from a ReadBoxed<BufRead>. the input size,is only for new a vec with directive space allocation the input data stream and output object should be plain base object .

fn object_hash(&self) -> Result<ObjectHash, GitError>

Computes the object hash from serialized data.

impl Serialize for Intent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.