Verified against Semitexa Ultimate 2026.09.19.1020
Project Graph Command Reference
All commands are prefixed with ai:review-graph: and are available via bin/semitexa.
Core Commands
generate
bin/semitexa ai:review-graph:generate
Scans the codebase and builds (or incrementally updates) the project graph.
Options:
| Option | Description |
|---|---|
--full |
Force full rebuild (ignore incremental cache) |
--module=NAME |
Scan only a specific module |
--json |
Output results as JSON |
Output:
Incremental update complete. 8 files scanned, +15/-5 nodes, +132/-0 edges. (209ms)
When to use: Before any code review, refactoring, or feature addition. Always run this first.
stats
bin/semitexa ai:review-graph:stats
Shows graph statistics — node counts by type, edge counts, module breakdown.
Options:
| Option | Description |
|---|---|
--module=NAME |
Stats for specific module |
--json |
Output as JSON |
Output:
Graph Statistics:
Total nodes: 1,247
Total edges: 3,891
Modules: 12
Files indexed: 487
When to use: Verify the graph is populated and complete before querying.
show
bin/semitexa ai:review-graph:show <node-id>
Show details for a specific node — type, metadata, incoming/outgoing edges.
Arguments:
| Argument | Description |
|---|---|
node-id |
Node ID (e.g. class:App\Ordering\CheckoutHandler) or FQCN |
Options:
| Option | Description |
|---|---|
--depth=N |
How many edge levels to show (default: 1) |
--json |
Output as JSON |
When to use: Inspect a specific component's connections and metadata.
query
bin/semitexa ai:review-graph:query <type> [--module=NAME] [--filter=KEY:VALUE]
Find nodes by type, module, or metadata filters.
Arguments:
| Argument | Description |
|---|---|
type |
Node type to search (e.g. handler, event, service) |
Options:
| Option | Description |
|---|---|
--module=NAME |
Filter by module |
--filter=KEY:VALUE |
Filter by metadata key-value |
--json |
Output as JSON |
Examples:
# Find all handlers
bin/semitexa ai:review-graph:query handler
# Find all events in Ordering module
bin/semitexa ai:review-graph:query event --module=Ordering
# Find all payloads with a specific path
bin/semitexa ai:review-graph:query payload --filter=path:/api/checkout
Intelligence Commands
event-trace
bin/semitexa ai:review-graph:event-trace <event>
Trace the full lifecycle of an event from emission through all consumers.
Arguments:
| Argument | Description |
|---|---|
event |
Event class name (short or FQCN) |
Options:
| Option | Description |
|---|---|
--format=text|json|markdown |
Output format (default: text) |
--include-code |
Include source file paths |
Shows:
- Who emits the event
- Sync listeners (inline)
- Async listeners (Swoole defer)
- Queued listeners (with queue names)
- NATS subject and JetStream stream
- Replay handlers
- DLQ path and retry config
- Idempotency key
Examples:
bin/semitexa ai:review-graph:event-trace OrderCreated
bin/semitexa ai:review-graph:event-trace OrderCreated --format=json
bin/semitexa ai:review-graph:event-trace OrderCreated --include-code
When to use: Understanding event-driven flows, debugging event propagation, finding all consumers of an event.
flow-trace
bin/semitexa ai:review-graph:flow-trace <flow>
Trace an execution flow end-to-end — from entry point through all steps.
Arguments:
| Argument | Description |
|---|---|
flow |
Flow name or payload class |
Options:
| Option | Description |
|---|---|
--format=text|json|markdown |
Output format (default: text) |
--include-code |
Include source file paths |
Shows:
- Entry point (route)
- Ordered steps with roles
- Sync/async boundary
- Events emitted
- Storage touches
- External calls
Examples:
bin/semitexa ai:review-graph:flow-trace CheckoutFlow
bin/semitexa ai:review-graph:flow-trace CheckoutPayload --format=json
When to use: Understanding how a request flows through the system, onboarding to a new module.
context
bin/semitexa ai:review-graph:context "<task>"
Build relevant context for a development task — matched components, related flows, events, dependencies, hotspots.
Arguments:
| Argument | Description |
|---|---|
task |
Natural language description of what you're working on |
Options:
| Option | Description |
|---|---|
--format=text|json |
Output format (default: text) |
--depth=N |
Context depth 1-3 (default: 2) |
--module=NAME |
Limit to specific module |
Examples:
bin/semitexa ai:review-graph:context "adding payment method"
bin/semitexa ai:review-graph:context "fixing checkout bug" --format=json
bin/semitexa ai:review-graph:context "user authentication" --module=Authorization
When to use: Before starting any task — gives you the full picture of what's relevant.
impact
bin/semitexa ai:review-graph:impact <component>
Analyze the impact of changing a component — direct/transitive dependents, cross-module impact, blast radius.
Arguments:
| Argument | Description |
|---|---|
component |
Component to analyze (class name, module, or file) |
Options:
| Option | Description |
|---|---|
--format=text|json |
Output format (default: text) |
--depth=N |
Traversal depth 1-3 (default: 2) |
Shows:
- Risk level (CRITICAL/HIGH/MEDIUM/LOW) and score
- Direct dependents (with edge types)
- Transitive dependents (with depth)
- Cross-module impact (by module)
- Event impact (events emitted + listener counts)
- Total blast radius
Examples:
bin/semitexa ai:review-graph:impact PaymentService
bin/semitexa ai:review-graph:impact CheckoutHandler --depth=3 --format=json
When to use: Before making changes to shared services, handlers, or events.
module
bin/semitexa ai:review-graph:module <name>
Overview of a module with full context — summary, domain, flows, events, hotspots, cross-module deps.
Arguments:
| Argument | Description |
|---|---|
module |
Module name |
Options:
| Option | Description |
|---|---|
--format=text|json |
Output format (default: text) |
--include-events |
Include event details |
--include-flows |
Include execution flows |
Shows:
- Component counts (classes, events, handlers, services, routes)
- Domain context (name, description, criticality)
- Execution flows with steps
- Events with listeners and NATS subjects
- Hotspots with risk scores
- Cross-module dependencies
Examples:
bin/semitexa ai:review-graph:module Ordering
bin/semitexa ai:review-graph:module Ordering --include-events --include-flows --format=json
When to use: Onboarding to a new module, reviewing module boundaries.
diff
bin/semitexa ai:review-graph:diff
Show how the graph changed since the last scan.
Options:
| Option | Description |
|---|---|
--format=text|json |
Output format (default: text) |
--module=NAME |
Limit to specific module |
Shows:
- Node/edge counts (previous → current, delta)
- Changes by type
- New/removed modules
When to use: After a big refactor to see what changed structurally.
Utility Commands
capabilities
bin/semitexa ai:review-graph:capabilities
List all available commands and their capabilities.
watch
bin/semitexa ai:review-graph:watch [--interval=2] [--full-on-start]
Watch for file changes and incrementally update the graph in real-time.
Options:
| Option | Description |
|---|---|
--interval=N |
Polling interval in seconds (default: 2) |
--full-on-start |
Run full build before watching |
When to use: During active development — keeps the graph always up to date.
JSON Output
All commands support --format=json (or --json for older commands). This is the primary interface for AI agents.
bin/semitexa ai:review-graph:event-trace OrderCreated --format=json
Returns structured data that can be parsed and used programmatically.