Struct LsNode 

pub struct LsNode {
    pub id: usize,
    pub name: String,
    pub path: String,
    pub pack_type: String,
    pub synthetic: bool,
    pub unsynced: bool,
    pub error: Option<LsNodeError>,
    pub children: Vec<LsNode>,
}

One node in the structured ls tree.

id is a stable in-walk counter so JSON consumers can address a specific node without path-string parsing. synthetic = true marks plain-git children whose pack manifest was synthesised in-memory by the walker (no .grex/pack.yaml on disk); type is always "scripted" for synthetic nodes per the v1.1.1 design.

The flags synthetic, unsynced, and error are mutually exclusive — at most one is set per node. A successfully loaded real manifest leaves all three at their default (false/None).

Fields

id: usize

Stable in-walk identifier (depth-first, root = 0).

name: String

Pack name (manifest name: for real packs, child path for synthetic / unsynced / errored ones).

path: String

Absolute on-disk path of the pack root.

pack_type: String

Pack flavour discriminator. Snake-case label from PackType::as_str — "meta", "declarative", or "scripted".

synthetic: bool

True iff the manifest was synthesised in-memory (plain-git child). See man/reference/pack-spec.md §“Plain-git children”.

unsynced: bool

True iff the child is declared in its parent’s manifest but its destination directory is absent on disk. Distinguishes a fresh-checkout state (which pre-FIX-4 was rendered as an empty tree) from a fully-synced workspace. Skipped from JSON output when false so the v1.1.1 baseline JSON shape is unchanged for the common case.

error: Option<LsNodeError>

Some when the child’s manifest exists but failed to read or parse. Surfaces partial-corruption to JSON consumers without aborting the entire walk. Skipped from JSON output when None.

children: Vec<LsNode>

Recursively walked children. Empty for leaves (declarative and scripted packs and synthetic plain-git children).

Trait Implementations

impl Clone for LsNode

fn clone(&self) -> LsNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LsNode

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

Formats the value using the given formatter.

impl Serialize for LsNode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.