Struct RepositoryView 

pub struct RepositoryView<C = CommitInfo> {
    pub versions: Option<VersionInfo>,
    pub explanation: FieldExplanation,
    pub working_directory: WorkingDirectoryInfo,
    pub remotes: Vec<RemoteInfo>,
    pub ai: AiInfo,
    pub branch_info: Option<BranchInfo>,
    pub pr_template: Option<String>,
    pub pr_template_location: Option<String>,
    pub branch_prs: Option<Vec<PullRequest>>,
    pub commits: Vec<C>,
}

Root node of the YAML output produced by view, info, check, and the branch subcommands.

Field presence is runtime-dependent: optional fields are populated only when the active command and repository state require them, and the embedded FieldExplanation reports which fields are actually present in this serialization. See ADR-0013 for the field-presence contract.

Generic over the commit type so the same shape serves both human-facing output (CommitInfo) and AI-facing output (RepositoryViewForAI, using CommitInfoForAI).

Fields

versions: Option<VersionInfo>

Version information for the omni-dev tool.

explanation: FieldExplanation

Explanation of field meanings and structure.

working_directory: WorkingDirectoryInfo

Working directory status information.

remotes: Vec<RemoteInfo>

List of remote repositories and their main branches.

ai: AiInfo

AI-related information.

branch_info: Option<BranchInfo>

Branch information (only present when using branch commands).

pr_template: Option<String>

Pull request template content (only present in branch commands when template exists).

pr_template_location: Option<String>

Location of the pull request template file (only present when pr_template exists).

branch_prs: Option<Vec<PullRequest>>

Pull requests created from the current branch (only present in branch commands).

commits: Vec<C>

List of analyzed commits with metadata and analysis.

Implementations

impl RepositoryView

pub fn update_field_presence(&mut self)

Updates the present field for all field documentation entries based on actual data.

pub fn to_yaml_output(&mut self) -> Result<String>

Serializes this view to YAML, calling update_field_presence first.

Use this instead of calling update_field_presence followed by crate::data::to_yaml separately. Keeping the two steps together prevents the explanation section from being stale in the output.

pub fn single_commit_view(&self, commit: &CommitInfo) -> Self

Creates a minimal view containing a single commit for parallel dispatch.

Strips metadata not relevant to per-commit AI analysis (versions, working directory status, remotes, PR templates) to reduce prompt size. Only retains branch_info (for scope context) and the single commit.

impl<C> RepositoryView<C>

pub fn map_commits<D>( self, f: impl FnMut(C) -> Result<D>, ) -> Result<RepositoryView<D>>

Transforms commits while preserving all other fields.

impl RepositoryView<CommitInfoForAI>

pub fn from_repository_view(repo_view: RepositoryView) -> Result<Self>

Converts from basic RepositoryView by loading diff content for all commits.

pub fn from_repository_view_with_options( repo_view: RepositoryView, fresh: bool, ) -> Result<Self>

Converts from basic RepositoryView with options.

If fresh is true, clears original commit messages to force AI to generate new messages based solely on the diff content.

impl RepositoryView<CommitInfo<CommitAnalysisFromCommits>>

pub fn from_repository_view(repo_view: RepositoryView) -> Self

Converts a RepositoryView into the commit-message-only view.

No diff content is read; only pre-computed analysis metadata (detected_type, detected_scope) is retained alongside the commit hash, author, date, and message.

The schema-documentation FieldExplanation is stripped here: the default explanation lists diff-related field names (e.g. commits[].analysis.diff_file) that this view never carries, and the user prompt explicitly tells the AI what shape the payload has — leaving the documentation in would be misleading.

Trait Implementations

impl<C: Clone> Clone for RepositoryView<C>

fn clone(&self) -> RepositoryView<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C: Debug> Debug for RepositoryView<C>

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

Formats the value using the given formatter.

impl<'de, C> Deserialize<'de> for RepositoryView<C>

where C: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<C> Serialize for RepositoryView<C>

where C: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.