Struct PlanSession 

pub struct PlanSession { /* private fields */ }

An interactive planning session wrapping a ClaudeClient with the Planner profile for multi-turn feature planning conversations.

Usage

1. Create via PlanSession::new
2. Call send repeatedly for conversation turns
3. Call approve to formalize the approved design
4. Call finalize to write specs and create a worktree

Implementations

impl PlanSession

pub fn new( feature_slug: String, project_root: PathBuf, pm: &PromptManager, config: &CodaConfig, git: Arc<dyn GitOps>, ) -> Result<Self, CoreError>

Creates a new planning session for the given feature.

Initializes a ClaudeClient with the Planner profile and renders the planning system prompt with repository context.

Errors

Returns CoreError if the system prompt cannot be rendered.

pub async fn connect(&mut self) -> Result<(), CoreError>

Connects the underlying ClaudeClient to the Claude process.

Errors

Returns CoreError::AgentError if the connection fails.

pub async fn disconnect(&mut self)

Disconnects the underlying ClaudeClient.

Safe to call multiple times or when not connected.

pub async fn send(&mut self, message: &str) -> Result<String, CoreError>

Sends a user message and collects the agent’s response.

Automatically connects on the first call.

Errors

Returns CoreError::AgentError if the query or response streaming fails.

pub async fn approve(&mut self) -> Result<(String, String), CoreError>

Formalizes the approved design and generates a verification plan.

First asks the agent to produce a structured design specification document, then generates a verification plan based on the design. Both are stored so finalize can write them directly without re-generating.

Returns (design, verification) so the UI can display both.

Errors

Returns CoreError if template rendering or agent communication fails.

pub fn is_approved(&self) -> bool

Returns true if both design and verification have been approved via approve.

pub async fn finalize(&mut self) -> Result<PlanOutput, CoreError>

Finalizes the planning session by creating a worktree and writing specs.

This method:

1. Creates a git worktree from the base branch
2. Writes the approved design spec into the worktree
3. Writes the approved verification plan into the worktree
4. Writes the initial state.yml into the worktree

All feature artifacts are written under <worktree>/.coda/<slug>/ so they travel with the feature branch and merge cleanly into main.

Errors

Returns CoreError if git operations, directory creation, or file writes fail.

pub fn feature_dir_name(&self) -> &str

Returns the directory name for this feature (the slug itself).

pub fn feature_slug(&self) -> &str

Returns the feature slug.

Trait Implementations

impl Debug for PlanSession

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

Formats the value using the given formatter.