Enum Command 

pub enum Command {
    Compile {
        path: PathBuf,
        output: Option<PathBuf>,
        exclude: Vec<String>,
        include_tests: bool,
        coverage_report: Option<PathBuf>,
    },
    Info {
        file: PathBuf,
    },
    Query {
        file: PathBuf,
        query_type: String,
        name: Option<String>,
        unit_id: Option<u64>,
        depth: u32,
        limit: usize,
    },
    Get {
        file: PathBuf,
        unit_id: u64,
    },
    Completions {
        shell: Shell,
    },
    Health {
        file: PathBuf,
        limit: usize,
    },
    Gate {
        file: PathBuf,
        unit_id: u64,
        max_risk: f32,
        depth: u32,
        require_tests: bool,
    },
    Budget {
        file: PathBuf,
        max_bytes: u64,
        horizon_years: u32,
    },
}

Top-level subcommands.

Variants

Compile

Compile a repository into an .acb graph file.

Recursively scans the source directory, parses all supported languages (Python, Rust, TypeScript, Go), performs semantic analysis, and writes a compact binary .acb file for fast querying.

Examples: acb compile ./src acb compile ./src -o myapp.acb acb compile ./src –exclude=“test” –exclude=“vendor”

Fields

path: PathBuf

Path to the source directory to compile.

output: Option<PathBuf>

Output file path (default: .acb in current dir).

exclude: Vec<String>

Glob patterns to exclude from parsing (may be repeated).

include_tests: bool

Include test files in the compilation (default: true).

coverage_report: Option<PathBuf>

Write ingestion coverage report JSON to this path.

Info

Display summary information about an .acb graph file.

Shows version, unit/edge counts, language breakdown, and file size. Useful for verifying a compilation was successful.

Examples: acb info project.acb acb info project.acb –format json

Fields

file: PathBuf

Path to the .acb file.

Query

Run a query against a compiled .acb graph.

Available query types: symbol Find code units by name (–name required) deps Forward dependencies of a unit (–unit-id required) rdeps Reverse dependencies (who depends on this unit) impact Impact analysis with risk scoring calls Call graph exploration similar Find structurally similar code units prophecy Predict which units are likely to break stability Stability score for a specific unit coupling Detect tightly coupled unit pairs test-gap Identify high-risk units without adequate tests hotspots Detect high-change concentration units dead-code List unreachable or orphaned units

Examples: acb query project.acb symbol –name “UserService” acb query project.acb deps –unit-id 42 –depth 5 acb query project.acb impact –unit-id 42 acb query project.acb prophecy –limit 10

Fields

file: PathBuf

Path to the .acb file.

query_type: String

Query type: symbol, deps, rdeps, impact, calls, similar, prophecy, stability, coupling, test-gap, hotspots, dead-code.

name: Option<String>

Search string for symbol queries.

unit_id: Option<u64>

Unit ID for unit-centric queries (deps, impact, calls, etc.).

depth: u32

Maximum traversal depth (default: 3).

limit: usize

Maximum results to return (default: 20).

Get

Get detailed information about a specific code unit by ID.

Displays all metadata, edges, and relationships for the unit. Use acb query ... symbol first to find the unit ID.

Examples: acb get project.acb 42 acb get project.acb 42 –format json

Fields

file: PathBuf

Path to the .acb file.

unit_id: u64

Unit ID to look up.

Completions

Generate shell completion scripts.

Outputs a completion script for the specified shell to stdout. Source it in your shell profile for tab completion.

Examples: acb completions bash > ~/.local/share/bash-completion/completions/acb acb completions zsh > ~/.zfunc/_acb acb completions fish > ~/.config/fish/completions/acb.fish

Fields

shell: Shell

Shell type (bash, zsh, fish, powershell, elvish).

Health

Summarize graph health (risk, test gaps, hotspots, dead code).

Fields

file: PathBuf

Path to the .acb file.

limit: usize

Maximum items to show per section.

Gate

Enforce a CI risk gate for a proposed unit change.

Fields

file: PathBuf

Path to the .acb file.

unit_id: u64

Unit ID being changed.

max_risk: f32

Max allowed overall risk score (0.0 - 1.0).

depth: u32

Traversal depth for impact analysis.

require_tests: bool

Fail if impacted units without tests are present.

Budget

Estimate long-horizon storage usage against a fixed budget.

Fields

file: PathBuf

Path to the .acb file.

max_bytes: u64

Max allowed bytes over the horizon.

horizon_years: u32

Projection horizon in years.

Trait Implementations

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