Enum Command 

pub enum Command {
    Init {
        space: String,
    },
    Ingest {
        path: PathBuf,
        space: String,
    },
    Sync {
        path: PathBuf,
        space: String,
    },
    Stats,
    Spaces,
    Doctor,
    Backup {
        no_projection: bool,
        no_cache: bool,
        out: Option<PathBuf>,
    },
    Restore {
        backup: PathBuf,
    },
    Ask {
        question: String,
        space: String,
    },
    Entity {
        command: EntityCmd,
    },
    Timeline {
        entity_id: String,
        space: String,
    },
    Why {
        statement_id: String,
        space: String,
        dropped: bool,
        min_confidence: f32,
    },
    Contradictions {
        space: String,
    },
    Page {
        entity: Option<String>,
        space: String,
        kind: String,
        topic: Option<String>,
    },
    Reproject,
    Redact {
        target: String,
        space: String,
        dry_run: bool,
        reason: String,
    },
    Export {
        out: Option<PathBuf>,
    },
    Import {
        file: PathBuf,
    },
    ImportOxios {
        db: PathBuf,
        space: String,
    },
    Token {
        command: TokenCmd,
    },
    Serve {
        socket: Option<PathBuf>,
        http: Option<String>,
        require_token: bool,
        daemon: bool,
        ui_dir: Option<PathBuf>,
    },
    Predicate {
        command: PredicateCmd,
    },
    Extract {
        episode_id: String,
        space: String,
    },
    Reextract {
        space: String,
    },
    Model {
        command: ModelCmd,
    },
    Eval {
        suite: String,
    },
    Declare {
        json: String,
        space: String,
    },
    Source {
        command: SourceCmd,
    },
}

Variants

Init

Initialize a new brain store.

Fields

space: String

Ingest

Ingest a file or stdin as an episode.

Fields

path: PathBuf

File path, or - for stdin.

space: String

Sync

Sync a directory of markdown notes into a space. Idempotent: unchanged files are skipped; new and modified files are ingested with occurred_at = file mtime.

Fields

path: PathBuf

Directory to scan recursively for .md files.

space: String

Stats

Show store statistics.

Spaces

List all spaces with counts. Read-only; safe with a running daemon.

Doctor

Health check.

Backup

Back up the store.

Fields

no_projection: bool

no_cache: bool

out: Option<PathBuf>

Output directory (default: sibling of store dir).

Restore

Restore from a backup.

Fields

backup: PathBuf

Ask

Ask a question (hybrid query).

Fields

question: String

space: String

Entity

Entity management (DESIGN §12.4: entity show|merge|split|alias).

Fields

command: EntityCmd

Timeline

Fields

entity_id: String

space: String

Why

Provenance for a statement.

Fields

statement_id: String

space: String

dropped: bool

Print what rank discarded for a query instead of provenance. statement_id is then the query text (DESIGN §11.8).

min_confidence: f32

Confidence floor for –dropped (default 0). Raises it to see BelowConfidenceFloor drops.

Contradictions

List contradicted statements.

Fields

space: String

Page

Render a page (brief) with followable links. --kind entity is the default; --kind space shows counts + top entities; --kind topic keyword-searches entity surfaces (--topic is the keyword).

Fields

entity: Option<String>

Entity id (when –kind entity, default), or ignored for space/topic.

space: String

kind: String

Target kind: entity (default), space, or topic.

topic: Option<String>

Keyword for –kind topic.

Reproject

Reproject the store.

Redact

Redact (the only true delete).

Fields

target: String

space: String

dry_run: bool

reason: String

Export

Export to JSONL.

Fields

out: Option<PathBuf>

Import

Import from JSONL.

Fields

file: PathBuf

ImportOxios

Import from an oxios-memory SQLite database (DESIGN §16.3).

Fields

db: PathBuf

Path to the oxios-memory memory.db file.

space: String

Target space (default: personal).

Token

Token management (DESIGN §12.4: token issue|list|revoke).

Fields

command: TokenCmd

Serve

Fields

socket: Option<PathBuf>

Listen on a Unix-domain socket path instead of stdio.

http: Option<String>

Listen on loopback HTTP (e.g. 127.0.0.1:8080) instead of stdio.

require_token: bool

Require token authentication on socket connections (DESIGN §11.2).

daemon: bool

Run as a background daemon: write a PID file and shut down gracefully on SIGTERM/SIGINT (DESIGN §4.3, §15). External supervision (launchd) handles backgrounding; this flag does not fork.

ui_dir: Option<PathBuf>

Serve the desktop brain UI from this directory (GET requests). Dev override — defaults to the embedded bundle (see ADR-008).

Predicate

Predicate registry (DESIGN §12.4: predicate add|list).

Fields

command: PredicateCmd

Extract

Extract a single episode (calls the LLM, validates, projects).

Fields

episode_id: String

Episode ID to extract.

space: String

Reextract

Re-extract all primary episodes with the configured extractor.

Fields

space: String

Model

Model artifact management (§8.4: model list|pull|verify|use).

Fields

command: ModelCmd

Eval

Run the extraction evaluation suite (DESIGN §14.2).

Fields

suite: String

Suite: fast (fixture-replayed, no network) or full (live provider).

Declare

Declare a statement from raw JSON (power-user path).

Fields

json: String

Canonical declaration JSON.

space: String

Source

Source management.

Fields

command: SourceCmd

Trait Implementations

impl Debug for Command

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

Formats the value using the given formatter.

impl FromArgMatches for Command

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 Command

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