PHPackages techvoot/engineering-intelligence-package - 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 & Helpers](/categories/utility) 4. / 5. techvoot/engineering-intelligence-package ActiveLibrary[Utility & Helpers](/categories/utility) techvoot/engineering-intelligence-package ========================================= AI-powered Laravel code analysis and engineering intelligence toolkit. v1.0.1(yesterday)19↑2566.7%MITPHPPHP ^8.2 Since Jun 22Pushed yesterdayCompare [ Source](https://github.com/tvabhishek/engineering-intelligence-package)[ Packagist](https://packagist.org/packages/techvoot/engineering-intelligence-package)[ RSS](/packages/techvoot-engineering-intelligence-package/feed)WikiDiscussions main Synced today READMEChangelogDependencies (2)Versions (3)Used By (0) Engineering Intelligence Package (EIP) ====================================== [](#engineering-intelligence-package-eip) What is EIP? ------------ [](#what-is-eip) Think of the Engineering Intelligence Package (EIP) as an automated Senior Developer for your Laravel project. It's a smart code analysis tool that catches bugs, security flaws, and messy code before they become a headache. EIP scans your entire Laravel application, spots common engineering mistakes, and gives you an easy-to-read report packed with actionable advice on how to fix them. What Does EIP Do? ----------------- [](#what-does-eip-do) EIP dives deep into your Laravel project, looking for architectural flaws, security risks, and performance bottlenecks across all your files—not just controllers, but models, services, routes, jobs, events, and more. Once the scan is done, EIP takes all those issues, neatly organizes them, and compresses them into a highly optimized format. It then sends this data to an AI engine, which acts as your personal engineering consultant. The AI reads the data and hands you back a smart, human-readable report covering: - **Overall Project Health**: A clear grade on how your codebase is doing. - **Risk Hotspots**: Exactly which files are causing the most trouble. - **Security & Architecture Alerts**: Highlighting dangerous patterns like raw SQL queries or overgrown classes. - **Actionable Advice**: Simple, clear steps you can take to clean things up right now. Instead of just dumping a massive, confusing list of errors on your screen, EIP gives you the big picture and tells you exactly what matters most. Main Features ------------- [](#main-features) - **Comprehensive Project Scanning**: Scans everything from Controllers and Models to Jobs and Routes. - **Deep Security Checks**: Spots vulnerabilities like SQL injections and exposed environment variables. - **Smart Architecture Insights**: Finds "God Classes" and spaghetti dependencies. - **AI-Powered Engineering Analysis**: Get feedback from top-tier AI models. - **Token-Safe AI Pipeline**: Intelligently compresses data so you don't blow through your API limits. - **Terminal & Markdown Reports**: See your results instantly in the console, or save them for later. How EIP Works ------------- [](#how-eip-works) EIP follows a simple 3-step process: ### 1. The Deep Scan [](#1-the-deep-scan) EIP crawls through your entire Laravel application, automatically identifying different file types and running specialized rules against them to find coding issues and security risks. ### 2. Context Engineering [](#2-context-engineering) All the issues EIP finds are gathered up, grouped by file, and squashed into a highly compressed "context payload." This ensures the AI gets all the facts without wasting expensive tokens. ### 3. The AI Review [](#3-the-ai-review) The AI engine takes that optimized context, reviews the structural health of your app, and generates a clear, helpful report telling you exactly how to improve your code. What rules does it check? ------------------------- [](#what-rules-does-it-check) EIP comes loaded with dozens of checks out of the box. Here are just a few of the things it looks for: **Architecture & Clean Code** - **Fat Controllers & God Services**: Detects classes that have grown too large and are trying to do too many things at once. - **Long Methods**: Finds massively long functions that are a nightmare to test and maintain. - **Too Many Dependencies**: Warns you when a class is relying on way too many external services. **Security & Performance** - **Raw SQL Injections**: Scans your database queries for raw SQL strings that could leave you wide open to attacks. - **Exposed Env Variables**: Checks if you are using the `env()` helper outside of your config files, which can break your app in production. - **Mass Assignment Vulnerabilities**: Ensures your Models properly lock down their database columns using `$fillable` or `$guarded`. - **Potential N+1 Queries**: Spots database calls hiding inside loops, which silently kill your application's speed. - **Uncacheable Routes**: Detects Closure-based routes that prevent Laravel from optimizing your app's loading time. - **Synchronous Jobs**: Flags jobs that aren't queued, which will force your users to wait while heavy background tasks finish. Generated Reports ----------------- [](#generated-reports) EIP saves different types of reports depending on what you need. You can find them all neatly organized in your storage folder: ### 1. Raw Report [](#1-raw-report) The complete, unedited list of every single issue found. Great for debugging. **Location:** `storage/app/eip/reports/` ### 2. AI Context Report [](#2-ai-context-report) The compressed, token-safe data sent to the AI. **Location:** `storage/app/eip/context/` ### 3. AI Final Report [](#3-ai-final-report) The beautiful, AI-generated summary full of engineering insights and recommendations. **Location:** `storage/app/eip/ai/` Supported AI Providers ---------------------- [](#supported-ai-providers) EIP lets you choose which AI brain you want to use. We currently support: - **OpenAI** (GPT-4, etc.) - **Gemini** (Google's latest models) - **Mistral** (Codestral, etc.) - **OpenRouter** (Access to dozens of open-source models) Example AI Report Output ------------------------ [](#example-ai-report-output) ``` { "health_score": 74, "critical_issues": 2, "hotspots_detected": 5, "recommendations": [ "Move business logic out of the UserService and into dedicated action classes.", "Fix potential SQL Injection vulnerabilities in the InvitationService.", "Cache your routes by moving Closure logic to Controllers." ] } ``` Usage ===== [](#usage) Publish the Configuration File ------------------------------ [](#publish-the-configuration-file) After installing the package, publish the EIP configuration file: ``` php artisan vendor:publish --tag=eip-config ``` This command will create the EIP configuration file inside your application's `config` directory. --- Enable AI-Powered Insights (Optional) ------------------------------------- [](#enable-ai-powered-insights-optional) EIP can generate AI-powered engineering insights and recommendations. To enable AI analysis, add the following settings to your `.env` file: ``` EIP_AI_ENABLED=true EIP_AI_PROVIDER=openai ``` ### Supported AI Providers [](#supported-ai-providers-1) ``` openai gemini openrouter mistral ``` ### OpenAI Example [](#openai-example) ``` EIP_AI_ENABLED=true EIP_AI_PROVIDER=openai OPENAI_API_KEY=your-api-key OPENAI_MODEL=gpt-5 ``` ### Gemini Example [](#gemini-example) ``` EIP_AI_ENABLED=true EIP_AI_PROVIDER=gemini GEMINI_API_KEY=your-api-key GEMINI_MODEL=gemini-2.5-pro ``` ### OpenRouter Example [](#openrouter-example) ``` EIP_AI_ENABLED=true EIP_AI_PROVIDER=openrouter EIP_OPENROUTER_API_KEY=your-api-key EIP_OPENROUTER_MODEL=anthropic/claude-sonnet-4 ``` ### Mistral Example [](#mistral-example) ``` EIP_AI_ENABLED=true EIP_AI_PROVIDER=mistral EIP_MISTRAL_API_KEY=your-api-key EIP_MISTRAL_MODEL=mistral-large-latest ``` > AI integration is optional. EIP can generate engineering reports even when AI is disabled. --- Running Analysis ================ [](#running-analysis) Quick Project Health Report --------------------------- [](#quick-project-health-report) Generate a summarized engineering report: ``` php artisan eip ``` Detailed JSON Report -------------------- [](#detailed-json-report) Generate a detailed JSON report: ``` php artisan eip --json ``` Markdown Report --------------- [](#markdown-report) Generate a Markdown report: ``` php artisan eip --markdown ``` Generate All Reports -------------------- [](#generate-all-reports) Generate both JSON and Markdown reports: ``` php artisan eip --export ``` --- Available Options ================= [](#available-options) ### Save Reports to a Custom Location [](#save-reports-to-a-custom-location) ``` php artisan eip --output=storage/reports ``` ### Filter by Severity [](#filter-by-severity) Show only issues of a specific severity level: ``` php artisan eip --severity=critical ``` Available severity levels: ``` critical high warning info ``` ### Filter by Issue Type [](#filter-by-issue-type) Show only specific issue types: ``` php artisan eip --type=n_plus_one ``` ### Filter by File Name [](#filter-by-file-name) Show issues related to a specific file: ``` php artisan eip --file=UserController ``` ### Limit Console Output [](#limit-console-output) Display only a specific number of issues: ``` php artisan eip --limit=20 ``` ### Sort Results [](#sort-results) Sort output by severity, file name, or line number: ``` php artisan eip --sort=severity ``` Available sort options: ``` severity file line ``` --- Example Commands ================ [](#example-commands) ``` # Generate a quick report php artisan eip # Generate a JSON report php artisan eip --json # Generate a Markdown report php artisan eip --markdown # Generate all report formats php artisan eip --export # Show only critical issues php artisan eip --severity=critical # Show issues from UserController php artisan eip --file=UserController # Show only N+1 query issues php artisan eip --type=n_plus_one # Limit output to 10 results php artisan eip --limit=10 ``` ### Health Score 42 — FairBetter than 89% of packages Maintenance100 Actively maintained with recent releases Popularity8 Limited adoption so far Community6 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure 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 ~0 days Total 2 Last Release 1d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b63b539b01df60575f752bd06df5d3a288f711ab00ddf070a7044722814ad86a?d=identicon)[abhishek\_0217](/maintainers/abhishek_0217) --- Top Contributors [![tvabhishek](https://avatars.githubusercontent.com/u/250933812?v=4)](https://github.com/tvabhishek "tvabhishek (5 commits)") --- Tags laravelaicode analysisengineeringtechnical debt ### Embed Badge ![Health badge](/badges/techvoot-engineering-intelligence-package/health.svg) ``` [![Health](https://phpackages.com/badges/techvoot-engineering-intelligence-package/health.svg)](https://phpackages.com/packages/techvoot-engineering-intelligence-package) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3345.1M337](/packages/psalm-plugin-laravel)[zidbih/laravel-deadlock Make temporary Laravel workarounds expire and fail CI when ignored. 984.0k](/packages/zidbih-laravel-deadlock)[v.chetkov/php-clean-architecture PHP Clean Architecture 14659.9k](/packages/vchetkov-php-clean-architecture)[tarfin-labs/event-machine Event-driven state machines for Laravel with event sourcing, type-safe context, and full audit trail. 199.1k](/packages/tarfin-labs-event-machine)[salehhashemi/laravel-intelli-git An intelligent Git helper package for Laravel applications. It utilizes OpenAI's GPT to analyze your Git repository, providing features such as automatic generation of commit messages based on staged changes. 132.1k](/packages/salehhashemi-laravel-intelli-git) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)