Enum Commands 

pub enum Commands {
    Ingest {
        input: Vec<PathBuf>,
        engram: PathBuf,
        manifest: PathBuf,
        verbose: bool,
    },
    Extract {
        engram: PathBuf,
        manifest: PathBuf,
        output_dir: PathBuf,
        verbose: bool,
    },
    Query {
        engram: PathBuf,
        query: PathBuf,
        hierarchical_manifest: Option<PathBuf>,
        sub_engrams_dir: Option<PathBuf>,
        k: usize,
        verbose: bool,
    },
    QueryText {
        engram: PathBuf,
        text: String,
        hierarchical_manifest: Option<PathBuf>,
        sub_engrams_dir: Option<PathBuf>,
        k: usize,
        verbose: bool,
    },
    BundleHier {
        engram: PathBuf,
        manifest: PathBuf,
        out_hierarchical_manifest: PathBuf,
        out_sub_engrams_dir: PathBuf,
        max_level_sparsity: usize,
        max_chunks_per_node: Option<usize>,
        embed_sub_engrams: bool,
        verbose: bool,
    },
    Update(UpdateCommands),
}

Variants

Ingest

Ingest files/directories into a holographic engram

Fields

input: Vec<PathBuf>

Input path(s) to ingest (directory or file). Can be provided multiple times.

engram: PathBuf

Output engram file containing holographic encoding

manifest: PathBuf

Output manifest file containing file metadata and chunk mappings

verbose: bool

Enable verbose output showing ingestion progress and statistics

Extract

Extract and reconstruct files from a holographic engram

Fields

engram: PathBuf

Input engram file to extract from

manifest: PathBuf

Input manifest file with metadata and chunk mappings

output_dir: PathBuf

Output directory where files will be reconstructed

verbose: bool

Enable verbose output showing extraction progress

Query

Query similarity between a file and engram contents

Fields

engram: PathBuf

Engram file to query

query: PathBuf

Query file to search for

hierarchical_manifest: Option<PathBuf>

Optional hierarchical manifest (enables selective unfolding search)

sub_engrams_dir: Option<PathBuf>

Directory containing bincode-serialized sub-engrams (used with –hierarchical-manifest)

k: usize

Top-k results to print for codebook/hierarchical search

verbose: bool

Enable verbose output showing similarity scores and details

QueryText

Query similarity using a literal text string (basic inference-to-vector)

Fields

engram: PathBuf

Engram file to query

text: String

Text to encode and search for

hierarchical_manifest: Option<PathBuf>

Optional hierarchical manifest (enables selective unfolding search)

sub_engrams_dir: Option<PathBuf>

Directory containing bincode-serialized sub-engrams (used with –hierarchical-manifest)

k: usize

Top-k results to print for codebook/hierarchical search

verbose: bool

Enable verbose output showing similarity scores and details

BundleHier

Build hierarchical retrieval artifacts (manifest + sub-engrams store)

Fields

engram: PathBuf

Input engram file

manifest: PathBuf

Input manifest file

out_hierarchical_manifest: PathBuf

Output hierarchical manifest JSON

out_sub_engrams_dir: PathBuf

Output directory to write bincode sub-engrams

max_level_sparsity: usize

Maximum sparsity per level bundle

max_chunks_per_node: Option<usize>

Optional cap on chunk IDs per node (enables deterministic sharding when exceeded)

embed_sub_engrams: bool

Embed sub-engrams in the manifest JSON (in addition to writing the directory)

verbose: bool

Enable verbose output

Update(UpdateCommands)

Incremental update operations (add/remove/modify files)

Trait Implementations

impl FromArgMatches for Commands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Commands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand