coda-core 0.1.0

Core execution engine for CODA — orchestrates AI-driven feature development workflows
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! Error types for the core engine.
//!
//! Defines `CoreError` as the primary error type for all operations
//! within `coda-core`.

use thiserror::Error;

/// Error type for coda-core operations.
///
/// Variants are grouped by subsystem: agent, git/gh external CLI, planning
/// workflow, state management, I/O, serialization, and configuration.
#[derive(Debug, Error)]
#[non_exhaustive]
pub enum CoreError {
    /// An error from the Claude Agent SDK or agent execution.
    ///
    /// Covers both SDK-level failures (connection, streaming) and
    /// logical agent errors (empty responses, unexpected phases).
    #[error("Agent error: {0}")]
    AgentError(String),

    /// An error from the prompt template manager.
    #[error("Prompt error: {0}")]
    PromptError(#[from] coda_pm::PromptError),

    /// An I/O error from file system operations.
    #[error("IO error: {0}")]
    IoError(#[from] std::io::Error),

    /// A configuration error (invalid or missing config).
    #[error("Config error: {0}")]
    ConfigError(String),

    /// A state file error (invalid or missing state).
    #[error("State error: {0}")]
    StateError(String),

    /// A planning workflow error (e.g. finalizing without approval).
    #[error("Plan error: {0}")]
    PlanError(String),

    /// A git/gh external CLI operation error.
    #[error("Git error: {0}")]
    GitError(String),

    /// A YAML serialization/deserialization error.
    #[error("YAML error: {0}")]
    YamlError(#[from] serde_yaml::Error),

    /// A generic error from anyhow.
    #[error(transparent)]
    AnyhowError(#[from] anyhow::Error),
}