Struct Vision

pub struct Vision { /* private fields */ }

A Vision document represents the high-level direction and goals

Implementations

impl Vision

pub fn new( title: String, tags: Vec<Tag>, archived: bool, ) -> Result<Self, DocumentValidationError>

Create a new Vision document with content rendered from template

pub fn from_parts( title: String, metadata: DocumentMetadata, content: DocumentContent, tags: Vec<Tag>, archived: bool, ) -> Self

Create a Vision document from existing data (used when loading from file)

pub async fn from_file<P: AsRef<Path>>( path: P, ) -> Result<Self, DocumentValidationError>

Create a Vision document by reading and parsing a file

pub fn from_content(raw_content: &str) -> Result<Self, DocumentValidationError>

Create a Vision document from raw file content string

pub async fn to_file<P: AsRef<Path>>( &self, path: P, ) -> Result<(), DocumentValidationError>

Write the Vision document to a file

pub fn to_content(&self) -> Result<String, DocumentValidationError>

Convert the Vision document to its markdown string representation using templates

Trait Implementations

impl Debug for Vision

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

Formats the value using the given formatter.

impl Document for Vision

fn document_type(&self) -> DocumentType

Get the document type

fn title(&self) -> &str

Get the document title

fn metadata(&self) -> &DocumentMetadata

Get the document metadata

fn content(&self) -> &DocumentContent

Get the document content

fn core(&self) -> &DocumentCore

Get access to the core document data

fn can_transition_to(&self, phase: Phase) -> bool

Check if this document can transition to the given phase

fn parent_id(&self) -> Option<&DocumentId>

Get the parent document ID if this document has a parent

fn blocked_by(&self) -> &[DocumentId]

Get IDs of documents that block this one

fn validate(&self) -> Result<(), DocumentValidationError>

Validate the document according to its type-specific rules

fn exit_criteria_met(&self) -> bool

Check if exit criteria are met

fn template(&self) -> DocumentTemplate

Get the template for rendering this document type

fn frontmatter_template(&self) -> &'static str

Get the frontmatter template for this document type

fn content_template(&self) -> &'static str

Get the content template for this document type

fn acceptance_criteria_template(&self) -> &'static str

Get the acceptance criteria template for this document type

fn transition_phase( &mut self, target_phase: Option<Phase>, ) -> Result<Phase, DocumentValidationError>

Transition to the next phase in sequence, or to a specific phase if provided

fn core_mut(&mut self) -> &mut DocumentCore

Get mutable access to the document core (needed for updates)

fn id(&self) -> DocumentId

Get the unique identifier for this document (derived from title)

fn tags(&self) -> &[Tag]

Get the document tags

fn phase(&self) -> Result<Phase, DocumentValidationError>

Get the current phase of the document (parsed from tags)

fn update_section( &mut self, content: &str, heading: &str, append: bool, ) -> Result<(), DocumentValidationError>

Update a specific section (H2 heading) in the document content

fn update_content_body( &mut self, new_body: String, ) -> Result<(), DocumentValidationError>

Helper method for update_section to actually mutate the content

fn archived(&self) -> bool

Check if this document is archived