Graph Queries

Raw Cypher passthrough

Every high-level command is built on Cypher queries against FalkorDB. You can drop to raw Cypher for anything the built-in commands don't cover:

navegador query "MATCH (f:Function) RETURN f.name, f.file LIMIT 10"

Results are printed as a table to stdout. Pipe with --format json if you need machine-readable output:

navegador query "MATCH (f:Function) RETURN f.name, f.file" --format json

Warning

navegador query executes writes as well as reads. Use MATCH / RETURN for inspection. Use CREATE / MERGE / DELETE only if you know what you're doing — there is no undo.

---

Useful example queries

Find all functions decorated with @login_required

MATCH (d:Decorator {name: "login_required"})-[:DECORATES]->(f:Function)
RETURN f.name, f.file, f.line
ORDER BY f.file

Find all functions in a specific file

MATCH (file:File {path: "src/auth/service.py"})-[:CONTAINS]->(f:Function)
RETURN f.name, f.line, f.signature

Find everything a function calls (two hops)

MATCH (f:Function {name: "process_payment"})-[:CALLS*1..2]->(callee:Function)
RETURN DISTINCT callee.name, callee.file

Find all callers of a function

MATCH (caller:Function)-[:CALLS]->(f:Function {name: "validate_token"})
RETURN caller.name, caller.file

Find all rules in a domain

MATCH (d:Domain {name: "Payments"})<-[:BELONGS_TO]-(r:Rule)
RETURN r.name, r.severity, r.description
ORDER BY r.severity

Find all concepts implemented by code in a file

MATCH (file:File {path: "src/payments/processor.py"})-[:CONTAINS]->(f)
      -[:ANNOTATES]-(c:Concept)
RETURN DISTINCT c.name, c.description

Find all decisions that relate to a domain

MATCH (d:Domain {name: "Infrastructure"})<-[:BELONGS_TO]-(dec:Decision)
RETURN dec.name, dec.status, dec.date, dec.rationale
ORDER BY dec.date DESC

Find classes that inherit from a base class

MATCH (child:Class)-[:INHERITS]->(parent:Class {name: "BaseProcessor"})
RETURN child.name, child.file

Find the full inheritance chain for a class

MATCH path = (c:Class {name: "StripeProcessor"})-[:INHERITS*]->(ancestor)
RETURN [node.name](/node IN nodes(path)) AS hierarchy

Find wiki pages that document a concept

MATCH (wp:WikiPage)-[:DOCUMENTS]->(c:Concept {name: "Idempotency"})
RETURN wp.title, wp.url

Find all functions annotated with a specific rule

MATCH (r:Rule {name: "RequireIdempotencyKey"})-[:GOVERNS]->(f:Function)
RETURN f.name, f.file, f.line

Find what a person is assigned to

MATCH (p:Person {name: "Alice Chen"})<-[:ASSIGNED_TO]-(item)
RETURN labels(item)[0] AS type, item.name

---

navegador stats

Get a high-level count of everything in the graph:

navegador stats
navegador stats --json

Output breakdown:

Metric	What it counts
Repositories	Repository nodes
Files	File nodes
Classes	Class nodes
Functions + Methods	Function + Method nodes combined
Decorators	Decorator nodes
Imports	Import nodes
Domains	Domain nodes
Concepts	Concept nodes
Rules	Rule nodes
Decisions	Decision nodes
People	Person nodes
WikiPages	WikiPage nodes
Total edges	All relationship edges

Use --json to feed stats into CI dashboards or coverage checks.

Z