prismqueer 0.1.0

The spectral-triple substrate — five operations (focus, project, split, shift, settle), the Prism trait, zero deps. The foundation.
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

//! `pq::Output` — the settle DSL.
//!
//! Per pq spec §5.3, `Output` is a discriminated union over the
//! settle step's settle target. Each variant is a distinct JSON
//! key-shape.

use serde::{Deserialize, Serialize};

use super::Reference;
use crate::Oid;

/// CAS-safe ref update payload — `{"old": "...", "new": "..."}`.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct CasUpdate {
    pub old: Oid,
    pub new: Oid,
}

/// Settle DSL. Each variant maps to a distinct JSON key-shape.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum Output {
    /// `{"to_path": "...", "message"?: "..."}` — commit to a path.
    /// `message` is omitted on the wire when `None`.
    ToPath {
        to_path: String,
        #[serde(skip_serializing_if = "Option::is_none", default)]
        message: Option<String>,
    },
    /// `{"ref": "..."}` — advance a ref (branch creation / update).
    Ref {
        #[serde(rename = "ref")]
        ref_: Reference,
    },
    /// `{"cas": {"old": "...", "new": "..."}}` — CAS-safe ref update.
    Cas { cas: CasUpdate },
    /// `{"to_ref": "..."}` — write merged result to a ref.
    ToRef { to_ref: Reference },
    /// `{"snapshot": true}` — crystallize without committing.
    Snapshot { snapshot: bool },
    /// `{"flush": true}` — shard flush to disk.
    Flush { flush: bool },
}