Struct Plan 

pub struct Plan {

    pub id: String,
    pub short_id: Option<String>,
    pub project_id: String,
    pub project_path: String,
    pub title: String,
    pub content: Option<String>,
    pub status: PlanStatus,
    pub success_criteria: Option<String>,
    pub session_id: Option<String>,
    pub created_in_session: Option<String>,
    pub completed_in_session: Option<String>,
    pub source_path: Option<String>,
    pub source_hash: Option<String>,
    pub created_at: i64,
    pub updated_at: i64,
    pub completed_at: Option<i64>,
}

A plan in SaveContext.

Plans provide:

• PRD/specification storage
• Linkage to epics and issues
• Success criteria tracking
• Status progression (draft -> active -> completed)

Fields

id: String

Unique identifier (UUID format)

short_id: Option<String>

Short ID for easy reference (e.g., “PLAN-1”)

project_id: String

Project ID this plan belongs to

project_path: String

Project path for queries

title: String

Plan title

content: Option<String>

Plan content (markdown PRD/spec)

status: PlanStatus

Current status

success_criteria: Option<String>

Success criteria for completion

session_id: Option<String>

Session this plan is bound to (TTY-resolved)

created_in_session: Option<String>

Session where this plan was created (legacy metadata)

completed_in_session: Option<String>

Session where this plan was completed

source_path: Option<String>

Source file path (for multi-agent capture dedup)

source_hash: Option<String>

SHA-256 hash of source file content (for dedup)

created_at: i64

Creation timestamp (Unix milliseconds)

updated_at: i64

Last update timestamp (Unix milliseconds)

completed_at: Option<i64>

Completion timestamp (Unix milliseconds)

Implementations

impl Plan

pub fn new(project_id: String, project_path: String, title: String) -> Self

Create a new plan with default values.

pub fn with_content(self, content: &str) -> Self

Set the plan content.

pub fn with_status(self, status: PlanStatus) -> Self

Set the plan status.

pub fn with_success_criteria(self, criteria: &str) -> Self

Set the success criteria.

pub fn with_session(self, session_id: &str) -> Self

Bind to a session.

pub fn with_source(self, path: &str, hash: &str) -> Self

Set the source file path and content hash (for capture dedup).

Trait Implementations

impl Clone for Plan

fn clone(&self) -> Plan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Plan

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Plan

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Plan

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

where __S: Serializer,

Serialize this value into the given Serde serializer.