manggala / cortex-ai

v1.0.0 2026-09-02 15:46 UTC

Requires

• php: ^8.2
• illuminate/console: ^10.0|^11.0|^12.0|^13.0
• illuminate/database: ^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• laravel/pint: ^1.13
• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Ilham Hatta Manggala

• Context
• laravel
• cursor
• erd
• ai
• Gemini
• copilot
• mermaid
• claude
• windsurf
• antigravity
• manggala
• cortex-ai

Published on Packagist.org on 2026-09-02 15:47 UTC

README

Laravel AI Context & Architecture Blueprint Generator

Cortex AI adalah paket Composer buatan Manggala yang berfungsi mengekstraksi seluruh arsitektur proyek Laravel (Model Eloquent, Relasi, Schema DB, FormRequest Validation, & Routes) menjadi file konteks AI terkompresi hemat token untuk berbagai AI Coding Assistant (GEMINI.md, AGENT.md, AGENTS.md, .cursorrules, CLAUDE.md, .windsurfrules, COPILOT.md, atau cortex-ai-context.json) serta diagram ERD Mermaid.js.

⚡ Fitur Utama

• 🧠 Smart Schema Extractor: Membaca struktur tabel DB, primary keys, foreign keys, serta tipe data bawaan.
• 🔗 Eloquent Relation Inspection: Membaca relasi Eloquent (hasMany, belongsTo, belongsToMany, morphMany, dll.) dan casts.
• 🛣️ Route & Auth Awareness: Mengekstraksi API/Web routes beserta middleware pengamannya.
• 📝 FormRequest Validation Parser: Mengonversi aturan validasi form menjadi petunjuk terstruktur untuk AI.
• 📊 Mermaid.js ERD Generator: Menghasilkan diagram ERD visual langsung untuk LLM (erDiagram).
• 📁 Organized Subdirectory Output: Semua file tersimpan rapi di folder /context (dapat dikustomisasi via --output-dir).
• 📦 Multi-Agent Exporters: Mendukung pembuatan otomatis file GEMINI.md, AGENT.md, AGENTS.md, .cursorrules, CLAUDE.md, .windsurfrules, COPILOT.md, dan cortex-ai-context.json.

🚀 Instalasi

composer require manggala/cortex-ai --dev

Publikasikan file konfigurasi config/cortex-ai.php (opsional):

php artisan vendor:publish --tag=cortex-ai-config

⚙️ Konfigurasi (config/cortex-ai.php)

return [
    // Target default exporter: 'gemini', 'cursor', 'claude', 'windsurf', 'copilot', 'all', 'json'
    'default_target' => 'gemini',

    // Direktori penampung file hasil ekstraksi (set '' jika ingin di root proyek)
    'output_dir' => 'context',

    // Tabel DB yang diabaikan
    'ignored_tables' => [
        'migrations', 'failed_jobs', 'personal_access_tokens', 'sessions', 'jobs', 'cache',
    ],

    // Route patterns yang diabaikan
    'ignored_routes' => [
        '_ignition/*', 'sanctum/*', 'telescope/*', 'horizon/*', 'livewire/*',
    ],
];

💻 Penggunaan CLI

Eksekusi perintah Artisan untuk me-generate file konteks AI:

# Generate file GEMINI.md & AGENT.md di folder /context (default)
php artisan cortex-ai:generate --target=gemini

# Generate file .cursorrules di folder /context
php artisan cortex-ai:generate --target=cursor --output-dir=context

# Generate file CLAUDE.md untuk Anthropic Claude
php artisan cortex-ai:generate --target=claude

# Generate seluruh format AI agent sekaligus di folder /context
php artisan cortex-ai:generate --target=all --output-dir=context

# Generate file ke root proyek (tanpa subfolder context)
php artisan cortex-ai:generate --target=all --output-dir=""

🧪 Pengujian (Testing & Linting)

Paket ini dilengkapi dengan suite pengujian internal berbasis Orchestra Testbench:

# Menjalankan unit & feature test
composer test

# Menjalankan pengujian format kode PSR-12
composer lint

📜 Lisensi

Lisensi MIT. Dibuat oleh Ilham Hatta Manggala. Lihat LICENSE untuk informasi lebih lanjut.