Struct Path 

pub struct Path {
    pub path: PathIdentity,
    pub steps: Vec<Step>,
    pub meta: Option<PathMeta>,
}

An ordered sequence of steps forming a DAG — for example, a pull request.

path.head names the step ID at the tip of the active branch. Steps link to their parents via StepIdentity::parents, forming a DAG. Steps present in steps but not on the ancestry of head are considered dead ends — abandoned approaches that are preserved for provenance but did not contribute to the final result.

path.base optionally anchors the path to a repository and ref (e.g. "github:org/repo" at commit "abc123").

JSON shape

{
  "path": {
    "id": "pr-42",
    "base": { "uri": "github:org/repo", "ref": "main" },
    "head": "step-004"
  },
  "steps": [
    { "step": { "id": "step-001", "actor": "human:alex", … }, "change": { … } },
    { "step": { "id": "step-002", "parents": ["step-001"], … }, "change": { … } }
  ]
}

Fields

path: PathIdentity

steps: Vec<Step>

meta: Option<PathMeta>

Implementations

impl Path

pub fn new( id: impl Into<String>, base: Option<Base>, head: impl Into<String>, ) -> Self

Create a new path with the given ID, base, and head

Trait Implementations

impl Clone for Path

fn clone(&self) -> Path

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Path

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Path

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Path

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

where __S: Serializer,

Serialize this value into the given Serde serializer.