Enum GraphOperation 

pub enum GraphOperation {
    TracePath {
        from: String,
        to: String,
        languages: Option<String>,
        full_paths: bool,
    },
    CallChainDepth {
        symbol: String,
        languages: Option<String>,
        show_chain: bool,
    },
    DependencyTree {
        module: String,
        max_depth: Option<usize>,
        cycles_only: bool,
    },
    CrossLanguage {
        from_lang: Option<String>,
        to_lang: Option<String>,
        edge_type: Option<String>,
        min_confidence: f64,
    },
    Nodes {
        kind: Option<String>,
        languages: Option<String>,
        file: Option<String>,
        name: Option<String>,
        qualified_name: Option<String>,
        limit: usize,
        offset: usize,
        full_paths: bool,
    },
    Edges {
        kind: Option<String>,
        from: Option<String>,
        to: Option<String>,
        from_lang: Option<String>,
        to_lang: Option<String>,
        file: Option<String>,
        limit: usize,
        offset: usize,
        full_paths: bool,
    },
    Stats {
        by_file: bool,
        by_language: bool,
    },
    Status,
    Cycles {
        min_length: usize,
        max_length: Option<usize>,
        imports_only: bool,
        languages: Option<String>,
    },
    Complexity {
        target: Option<String>,
        sort_complexity: bool,
        min_complexity: usize,
        languages: Option<String>,
    },
    DirectCallers {
        symbol: String,
        limit: usize,
        languages: Option<String>,
        full_paths: bool,
    },
    DirectCallees {
        symbol: String,
        limit: usize,
        languages: Option<String>,
        full_paths: bool,
    },
    CallHierarchy {
        symbol: String,
        depth: usize,
        direction: String,
        languages: Option<String>,
        full_paths: bool,
    },
    IsInCycle {
        symbol: String,
        cycle_type: String,
        show_cycle: bool,
    },
}

Graph-based query operations

Variants

TracePath

Find shortest path between two symbols

Traces the shortest execution path from one symbol to another, following Call, HTTPRequest, and FFICall edges.

Example: sqry graph trace-path main processData

Fields

from: String

Source symbol name (e.g., “main”, “User.authenticate”).

to: String

Target symbol name.

languages: Option<String>

Filter by languages (comma-separated, e.g., “javascript,python”).

full_paths: bool

Show full file paths in output.

CallChainDepth

Calculate maximum call chain depth from a symbol

Computes the longest call chain starting from the given symbol, useful for complexity analysis and recursion detection.

Example: sqry graph call-chain-depth main

Fields

symbol: String

Symbol name to analyze.

languages: Option<String>

Filter by languages (comma-separated).

show_chain: bool

Show the actual call chain, not just the depth.

DependencyTree

Show transitive dependencies for a module

Analyzes all imports transitively to build a complete dependency tree, including circular dependency detection.

Example: sqry graph dependency-tree src/main.js

Fields

module: String

Module path or name.

max_depth: Option<usize>

Maximum depth to traverse (default: unlimited).

cycles_only: bool

Show circular dependencies only.

CrossLanguage

List all cross-language relationships

Finds edges connecting symbols in different programming languages, such as TypeScript→JavaScript imports, Python→C FFI calls, SQL table access, Dart MethodChannel invocations, and Flutter widget hierarchies.

Supported languages for –from-lang/–to-lang: js, ts, py, cpp, c, csharp (cs), java, go, ruby, php, swift, kotlin, scala, sql, dart, lua, perl, shell (bash), groovy, http

Examples: sqry graph cross-language –from-lang dart –edge-type channel_invoke sqry graph cross-language –from-lang sql –edge-type table_read sqry graph cross-language –edge-type widget_child

Fields

from_lang: Option<String>

Filter by source language.

to_lang: Option<String>

Filter by target language.

edge_type: Option<String>

Edge type filter.

Supported values: call, import, http, ffi, table_read, table_write, triggered_by, channel_invoke, widget_child

min_confidence: f64

Minimum confidence threshold (0.0-1.0).

Nodes

List unified graph nodes

Enumerates nodes from the unified graph snapshot and applies filters. Useful for inspecting graph coverage and metadata details.

Fields

kind: Option<String>

Filter by node kind(s) (comma-separated: function,method,macro).

languages: Option<String>

Filter by language(s) (comma-separated: rust,python).

file: Option<String>

Filter by file path substring (case-insensitive).

name: Option<String>

Filter by name substring (case-sensitive).

qualified_name: Option<String>

Filter by qualified name substring (case-sensitive).

limit: usize

Maximum results (default: 1000, max: 10000; use 0 for default).

offset: usize

Skip N results.

full_paths: bool

Show full file paths in output.

Edges

List unified graph edges

Enumerates edges from the unified graph snapshot and applies filters. Useful for inspecting relationships and cross-cutting metadata.

Fields

kind: Option<String>

Filter by edge kind tag(s) (comma-separated: calls,imports).

from: Option<String>

Filter by source label substring (case-sensitive).

to: Option<String>

Filter by target label substring (case-sensitive).

from_lang: Option<String>

Filter by source language.

to_lang: Option<String>

Filter by target language.

file: Option<String>

Filter by file path substring (case-insensitive, source file only).

limit: usize

Maximum results (default: 1000, max: 10000; use 0 for default).

offset: usize

Skip N results.

full_paths: bool

Show full file paths in output.

Stats

Show graph statistics and summary

Displays overall graph metrics including node counts by language, edge counts by type, and cross-language relationship statistics.

Example: sqry graph stats

Fields

by_file: bool

Show detailed breakdown by file.

by_language: bool

Show detailed breakdown by language.

Status

Show unified graph snapshot status

Reports on the state of the unified graph snapshot stored in .sqry/graph/ directory. Displays build timestamp, node/edge counts, and snapshot age.

Example: sqry graph status

Cycles

Detect circular dependencies in the codebase

Finds all cycles in the call and import graphs, which can indicate potential design issues or circular dependency problems.

Example: sqry graph cycles

Fields

min_length: usize

Minimum cycle length to report (default: 2).

max_length: Option<usize>

Maximum cycle length to report (default: unlimited).

imports_only: bool

Only analyze import edges (ignore calls).

languages: Option<String>

Filter by languages (comma-separated).

Complexity

Calculate code complexity metrics

Analyzes cyclomatic complexity, call graph depth, and other complexity metrics for functions and modules.

Example: sqry graph complexity

Fields

target: Option<String>

Target symbol or module (default: analyze all).

sort_complexity: bool

Sort by complexity score.

min_complexity: usize

Show only items above this complexity threshold.

languages: Option<String>

Filter by languages (comma-separated).

DirectCallers

Find direct callers of a symbol

Lists all symbols that directly call the specified function, method, or other callable. Useful for understanding symbol usage and impact analysis.

Example: sqry graph direct-callers authenticate

Fields

symbol: String

Symbol name to find callers for.

limit: usize

Maximum results (default: 100).

languages: Option<String>

Filter by languages (comma-separated).

full_paths: bool

Show full file paths in output.

DirectCallees

Find direct callees of a symbol

Lists all symbols that are directly called by the specified function or method. Useful for understanding dependencies and refactoring scope.

Example: sqry graph direct-callees processData

Fields

symbol: String

Symbol name to find callees for.

limit: usize

Maximum results (default: 100).

languages: Option<String>

Filter by languages (comma-separated).

full_paths: bool

Show full file paths in output.

CallHierarchy

Show call hierarchy for a symbol

Displays incoming and/or outgoing call relationships in a tree format. Useful for understanding code flow and impact of changes.

Example: sqry graph call-hierarchy main –depth 3

Fields

symbol: String

Symbol name to show hierarchy for.

depth: usize

Maximum depth to traverse (default: 3).

direction: String

Direction: incoming, outgoing, or both (default: both).

languages: Option<String>

Filter by languages (comma-separated).

full_paths: bool

Show full file paths in output.

IsInCycle

Check if a symbol is in a cycle

Determines whether a specific symbol participates in any circular dependency chains. Can optionally show the cycle path.

Example: sqry graph is-in-cycle UserService –show-cycle

Fields

symbol: String

Symbol name to check.

cycle_type: String

Cycle type to check: calls, imports, or all (default: calls).

show_cycle: bool

Show the full cycle path if found.

Trait Implementations

impl Clone for GraphOperation

fn clone(&self) -> GraphOperation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphOperation

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

Formats the value using the given formatter.

impl FromArgMatches for GraphOperation

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 GraphOperation

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