Struct SchemaConfig 

pub struct SchemaConfig {
    pub table: String,
    pub title: Option<String>,
    pub description: Option<String>,
    pub fields: Vec<FieldDef>,
    pub dump: Option<DumpConfig>,
}

The parsed contents of a schema.yaml file.

This struct is the runtime representation of the schema and acts as the single source of truth for all validation decisions. It is created once at daemon startup via load_from_path and passed to every CRUD operation.

Fields

• table: the SQLite table name (also used as a human-readable label).
• title: optional human-readable title for the table (short summary).
• description: optional long-form description for the table.
• fields: ordered list of field definitions.
• dump: optional write-only file-materialization configuration.

Fields

table: String

The logical table name declared in schema.yaml.

title: Option<String>

Optional human-readable title for the table (short summary, plain string).

description: Option<String>

Optional long-form description for the table. Plain string; CommonMark MAY be used by render tools (server stores it verbatim).

fields: Vec<FieldDef>

All field definitions, in declaration order.

dump: Option<DumpConfig>

Optional dump / file-materialization configuration.

When absent from schema.yaml, the field deserializes to None and the dump feature is disabled entirely (backward-compatible default).

Implementations

impl SchemaConfig

pub async fn write_to_path(&self, path: &Path) -> Result<(), MiniAppError>

Writes this schema to a YAML file using an atomic tmp+rename strategy.

The write is performed inside tokio::task::spawn_blocking to avoid blocking the async executor (K-110). The rename is performed with std::fs::rename, which is atomic on the same filesystem on Linux/macOS (POSIX rename(2) guarantee).

Algorithm

1. Serialise self to a YAML string via serde_yaml_bw::to_string.
2. Write to <path>.tmp (same directory, so same filesystem).
3. Atomically rename <path>.tmp to <path>.

Arguments

• path: destination path for schema.yaml (the final file, not .tmp).

Returns

Ok(()) on success.

Errors

• MiniAppError::Schema if serialisation fails.
• MiniAppError::Io if the write or rename fails.
• MiniAppError::Backup if the spawn_blocking task panics.

pub fn validate(&self, value: &Value) -> Result<(), MiniAppError>

Validates a JSON object against this schema.

Rules (applied in order, iterating over [self.fields]):

1. If field.required is true and the key is absent from value (or its value is null), return MiniAppError::Validation with reason = "required field missing".
2. If the key is present and non-null but its JSON type does not match field.ty, return MiniAppError::Validation with a descriptive reason.
3. Unknown keys (present in value but not in self.fields) are silently accepted — Agent-First extensibility.

Arguments

• value: the JSON object to validate. Must be a serde_json::Value::Object; if it is not, a Validation error is returned immediately.

Errors

Returns MiniAppError::Validation on the first validation failure encountered.

Trait Implementations

impl Clone for SchemaConfig

fn clone(&self) -> SchemaConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SchemaConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SchemaConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SchemaConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.