PHPackages                             semitexa/project-graph - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. semitexa/project-graph

ActiveSemitexa-module[Utility &amp; Helpers](/categories/utility)

semitexa/project-graph
======================

Semitexa Project Graph — persistent codebase knowledge graph for impact analysis and LLM context

2026.06.21.0352(1mo ago)0472MITPHP ^8.4

Since Apr 10Compare

[ Source](https://github.com/semitexa/semitexa-project-graph)[ Packagist](https://packagist.org/packages/semitexa/project-graph)[ RSS](/packages/semitexa-project-graph/feed)WikiDiscussions Synced 3w ago

READMEChangelogDependencies (8)Versions (13)Used By (2)

semitexa-project-graph
======================

[](#semitexa-project-graph)

Project graph package for fast AI and developer understanding of a Semitexa codebase.

Scans PHP source files, extracts semantic information via attributes and AST analysis, and stores it as a directed graph of nodes and edges. Enables LLMs and developers to understand a codebase in minutes instead of hours.

Quick Start
-----------

[](#quick-start)

```
# Generate or update the graph
bin/semitexa ai:review-graph:generate

# Confirm it's ready
bin/semitexa ai:review-graph:stats
```

Full Documentation
------------------

[](#full-documentation)

- [Architecture](docs/ARCHITECTURE.md) — Graph data model, node/edge types, extractors, storage
- [Commands](docs/COMMANDS.md) — Complete CLI reference with examples
- [AI Integration](docs/AI_INTEGRATION.md) — How AI agents consume the graph
- [Intelligence Layer](docs/INTELLIGENCE.md) — Domains, flows, events, hotspots, intent inference

Primary Workflow
----------------

[](#primary-workflow)

Run these commands before deep code changes or code generation:

```
bin/semitexa ai:review-graph:generate --json
bin/semitexa ai:review-graph:stats --json
```

`generate` builds or incrementally refreshes the graph. `stats` confirms that the graph is ready and shows node/edge counts.

Intelligence Commands
---------------------

[](#intelligence-commands)

Beyond basic graph queries, the intelligence layer provides:

```
# Trace an event's full lifecycle (emitters → listeners → NATS → replay → DLQ)
bin/semitexa ai:review-graph:event-trace OrderCreated

# Trace an execution flow end-to-end
bin/semitexa ai:review-graph:flow-trace CheckoutFlow

# Get context for a development task
bin/semitexa ai:review-graph:context "adding payment method"

# Analyze impact of changing a component
bin/semitexa ai:review-graph:impact PaymentService

# Module overview with domain, flows, events, hotspots
bin/semitexa ai:review-graph:module Ordering --include-events --include-flows

# See how the graph changed since last scan
bin/semitexa ai:review-graph:diff

# Watch for file changes and auto-update
bin/semitexa ai:review-graph:watch
```

All commands support `--format=json` for programmatic consumption by AI agents.

Storage
-------

[](#storage)

The graph uses its own named ORM connection: `project_graph`.

- Preferred configuration: `DB_PROJECT_GRAPH_*`
- Default fallback: dedicated SQLite database
- Local CLI fallback path: `var/tmp/project-graph.sqlite`

This keeps graph storage separate from the application's primary database.

Why AI agents should use it first
---------------------------------

[](#why-ai-agents-should-use-it-first)

- It gives a fast structural view of the real project, not just static package docs.
- It is safer than assuming the default database connection.
- It reduces blind searching before edits.
- It reveals event flows and cross-module dependencies that are invisible from file-level analysis.

All Commands
------------

[](#all-commands)

CommandPurpose`ai:review-graph:generate`Build or incrementally update the graph`ai:review-graph:stats`Show graph statistics`ai:review-graph:show`Show details for a specific node`ai:review-graph:query`Find nodes by type, module, or metadata`ai:review-graph:event-trace`Trace full event lifecycle`ai:review-graph:flow-trace`Trace execution flow end-to-end`ai:review-graph:context`Build context for a development task`ai:review-graph:impact`Analyze impact of changing a component`ai:review-graph:module`Module overview with full context`ai:review-graph:diff`Show graph changes since last scan`ai:review-graph:watch`Watch for file changes and auto-update`ai:review-graph:capabilities`List all available commands

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance93

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~7 days

Recently: every ~15 days

Total

10

Last Release

34d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e94044da9f4c76cc5cd09ef0c693a68065787e10d0d18edfeedbef3573a9163a?d=identicon)[syntaxwanderer](/maintainers/syntaxwanderer)

---

Tags

code analysisknowledge-graphsemitexaproject-graph

### Embed Badge

![Health badge](/badges/semitexa-project-graph/health.svg)

```
[![Health](https://phpackages.com/badges/semitexa-project-graph/health.svg)](https://phpackages.com/packages/semitexa-project-graph)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[v.chetkov/php-clean-architecture

PHP Clean Architecture

14661.3k](/packages/vchetkov-php-clean-architecture)[boundwize/structarmed

Configurable PHP architecture guards — define your layers and rules, then keep them enforced

45629.2k26](/packages/boundwize-structarmed)[drupal-code-builder/drupal-code-builder

Code generator for Drupal

27253.3k1](/packages/drupal-code-builder-drupal-code-builder)[zidbih/laravel-deadlock

Make temporary Laravel workarounds expire and fail CI when ignored.

985.4k](/packages/zidbih-laravel-deadlock)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
