Enum Error 

pub enum Error {
    InvalidInput(String),
    OperationFailed {
        operation: String,
        cause: String,
    },
    ContentBlocked {
        reason: String,
    },
    NotImplemented(String),
    FeatureNotEnabled(String),
    Unauthorized(String),
}

Error type for subcog operations.

Uses thiserror for automatic Display and Error trait implementations.

Error Variant Triggers

Variant	Raised When
InvalidInput	Missing required parameters, malformed JSON, invalid namespace names
OperationFailed	I/O errors, git operations fail, database queries fail
ContentBlocked	Secret patterns detected (API keys, tokens), PII detected
NotImplemented	Calling unfinished features (e.g., PostgreSQL consolidation)
FeatureNotEnabled	Using features requiring compile-time flags
Unauthorized	Invalid/missing JWT token in MCP HTTP transport

Variants

InvalidInput(String)

Invalid input was provided.

Raised when:

• Required parameters are missing (e.g., empty content in capture)
• JSON deserialization fails in MCP tool handlers
• Invalid namespace string is provided
• Prompt template has invalid variable syntax
• Search query is empty or malformed

OperationFailed

An operation failed.

Raised when:

• SQLite database operations fail
• Filesystem I/O errors occur
• Index backend is not configured
• Service container initialization fails

Fields

operation: String

The operation that failed.

cause: String

The underlying cause.

ContentBlocked

Content was blocked due to security concerns.

Raised when:

• Secret detection finds API keys, tokens, or credentials
• PII patterns are detected (configurable)
• Content fails security policy checks

See security::secrets for pattern definitions.

Fields

reason: String

The reason the content was blocked.

NotImplemented(String)

Feature not yet implemented.

Raised when:

• PostgreSQL consolidation is called
• Redis consolidation is called
• Other stub implementations are invoked

FeatureNotEnabled(String)

Feature not enabled (requires feature flag).

Raised when:

• Optional Cargo features are not compiled in
• Currently unused but reserved for future gated features

Unauthorized(String)

Authentication failed (SEC-H1).

Raised when:

• JWT token is missing in HTTP transport requests
• JWT token is expired or invalid
• JWT signature verification fails
• Insufficient entropy in JWT secret

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.