create workflow

Author: aagjalpankaj

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: ci
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+permissions:
+  contents: read
+
+jobs:
+  ci:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Cache Composer packages
+      id: composer-cache
+      uses: actions/cache@v3
+      with:
+        path: vendor
+        key: ${{ runner.os }}-ci-${{ hashFiles('**/composer.json') }}
+        restore-keys: |
+          ${{ runner.os }}-ci-
+
+    - name: Install dependencies
+      run: composer install --prefer-dist --no-progress
+
+    - name: Run ci checks
+      run: composer ci

README.md

@@ -1,10 +1,11 @@
 # CodeBuddy
 
-## All-in-One Code Quality Tool for Laravel
+## All-in-One Code Quality Tool for your codebase
 
-> **Note:** This package is currently compatible only with the Laravel framework.
+> **Note:** This package is currently compatible only with the Laravel framework 11 & 12.
 
 ## About
+
 CodeBuddy is a wrapper around essential development tools that help maintain code quality in your Laravel projects. It integrates:
 
 - **Rector** (automated code refactoring)
@@ -18,29 +19,22 @@ CodeBuddy is a wrapper around essential development tools that help maintain cod
 - Automated fixes for coding standards.
 - Code health reporting with email support.
 
-## Commands
+## Installation
 
-### Configure Code Quality Tools
-```sh
-php artisan codebuddy:configure
 ```
-This command sets up **Rector, PestPHP, Pint, and PHPStan** with standard configurations.
-
-### Run CI Checks
-```sh
-php artisan codebuddy:ci [--fix]
+composer require codebuddyphp/codebuddy --dev
 ```
-Runs tests, performs static analysis, and checks code style in a **dry-run mode** (does not modify files). Optimized for CI/CD pipelines.
 
-- `--fix`: Automatically applies fixes for Rector and Pint where possible.
+## Commands
 
-### Generate Code Quality Report
-```sh
-php artisan codebuddy:report [--show|--send-to=<email>]
 ```
-- `--show`: Displays the overall code health report in the console.
-- `--send-to=<email>`: Sends the report to the specified email address.
+php artisan codebuddy:configure
+```
 
----
+```
+php artisan codebuddy:review
+```
 
-This package simplifies code quality enforcement, making it easier to maintain a high standard across your Laravel projects.
+```
+php artisan codebuddy:insights
+```

composer.json

@@ -1,21 +1,39 @@
 {
     "name": "codebuddyphp/codebuddy",
-    "description": "All-in-one tool for your codebase",
+    "description": "All-in-one tool for your codebase quality",
     "type": "library",
     "require": {
         "php": "^8.2",
         "laravel/framework": "^11.0",
-        "nunomaduro/termwind": "^2.3",
-        "laravel/pint": "^1.20",
+        "laravel/pint": "^1.21",
+        "driftingly/rector-laravel": "^2.0",
         "larastan/larastan": "^3.0",
-        "rector/rector": "^2.0"
+        "pestphp/pest": "^3.7"
+    },
+    "require-dev": {
     },
     "autoload": {
         "psr-4": {
             "Codebuddyphp\\Codebuddy\\": "src/"
         }
     },
     "scripts": {
+        "lint": "XDEBUG_MODE=off pint --test",
+        "lint.fix": "XDEBUG_MODE=off pint",
+        "stan": "XDEBUG_MODE=off phpstan analyse --ansi --memory-limit=-1",
+        "test.arch": "XDEBUG_MODE=off pest --testsuite=Architecture",
+        "test.unit": "XDEBUG_MODE=off pest --testsuite=Unit",
+        "test.feature": "XDEBUG_MODE=coverage pest --testsuite=Feature --coverage --min=90",
+        "rector": "XDEBUG_MODE=off rector process --dry-run",
+        "rector.fix": "XDEBUG_MODE=off rector process",
+        "ci": [
+            "@lint",
+            "@rector"
+        ],
+        "ci.fix": [
+            "@rector.fix",
+            "@lint.fix"
+        ]
     },
     "extra": {
         "laravel": {
@@ -27,7 +45,10 @@
         }
     },
     "config": {
-        "preferred-install": "dist"
+        "preferred-install": "dist",
+        "allow-plugins": {
+            "pestphp/pest-plugin": true
+        }
     },
     "minimum-stability": "dev",
     "prefer-stable": true

phpstan.neon

@@ -0,0 +1,10 @@
+includes:
+    - vendor/larastan/larastan/extension.neon
+    - vendor/nesbot/carbon/extension.neon
+
+parameters:
+
+    paths:
+        - src/
+
+    level: max

rector.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+
+return RectorConfig::configure()
+    ->withPaths([
+        __DIR__.'/config',
+        __DIR__.'/src',
+    ])
+    // uncomment to reach your current PHP version
+    // ->withPhpSets()
+    ->withTypeCoverageLevel(0)
+    ->withDeadCodeLevel(0)
+    ->withCodeQualityLevel(0);

resources/views/banner.blade.php

@@ -0,0 +1,6 @@
+<div class="m-1">
+    <div class="px-1 bg-sky-600">CodeBuddy</div>
+    <em class="ml-1 underline">
+        All-in-one tool for your codebase quality
+    </em>
+</div>

src/CodebuddyServiceProvider.php

@@ -3,6 +3,8 @@
 namespace Codebuddyphp\Codebuddy;
 
 use Codebuddyphp\Codebuddy\Commands\Configure;
+use Codebuddyphp\Codebuddy\Commands\Report;
+use Codebuddyphp\Codebuddy\Commands\Review;
 use Illuminate\Support\ServiceProvider;
 
 class CodebuddyServiceProvider extends ServiceProvider
@@ -12,23 +14,32 @@ public function register()
         // Register bindings if any
     }
 
-    public function boot()
+    public function boot(): void
     {
         if ($this->app->runningInConsole()) {
             $this->commands([
                 Configure::class,
+                Review::class,
+                Report::class,
             ]);
 
             $this->publishes([
                 __DIR__.'/../config/codebuddy.php' => config_path('codebuddy.php'),
             ]);
         }
+
+        $this->loadViewsFrom(__DIR__.'/../resources/views', 'codebuddy');
     }
 
-    public function provides()
+    /**
+     * @return array<string>
+     */
+    public function provides(): array
     {
         return [
             Configure::class,
+            Review::class,
+            Report::class,
         ];
     }
-}
+}

src/Commands/Configure.php

@@ -3,7 +3,9 @@
 namespace Codebuddyphp\Codebuddy\Commands;
 
 use Illuminate\Console\Command;
-use Illuminate\Filesystem\Filesystem;
+use Illuminate\Support\Facades\File;
+
+use function Laravel\Prompts\spin;
 use function Termwind\render;
 
 class Configure extends Command
@@ -14,43 +16,54 @@ class Configure extends Command
 
     public function handle(): void
     {
-        $filesystem = new Filesystem();
+        render(view('codebuddy::banner'));
 
-        $configs = [
-            'rector.php',
-            'phpstan.neon',
-            'pint.json',
+        $packages = [
+            [
+                'package_name' => 'driftingly/rector-laravel',
+                'stub_file' => 'rector.php.stub',
+                'config_file' => 'rector.php',
+                'description' => 'Rector makes upgrading and maintaining code easier.',
+            ],
+            [
+                'package_name' => 'larastan/larastan',
+                'stub_file' => 'phpstan.neon.stub',
+                'config_file' => 'phpstan.neon',
+                'description' => 'PHPStan helps detect errors at compile time instead of runtime.',
+            ],
+            [
+                'package_name' => 'laravel/pint',
+                'stub_file' => 'pint.json.stub',
+                'config_file' => 'pint.json',
+                'description' => 'Pint ensures your code follows consistent formatting rules.',
+            ],
+            [
+                'package_name' => 'pestphp/pest',
+                'stub_file' => 'phpunit.xml.stub',
+                'config_file' => 'phpunit.xml',
+                'description' => 'Elegant testing framework.',
+            ],
         ];
 
-        foreach ($configs as $file) {
-            $sourceFile = __DIR__ . "/../../config/laravel/{$file}";
-            $destinationFile = base_path($file);
-
-            if (!$filesystem->exists($sourceFile)) {
-                $this->error("Source file not found: {$sourceFile}");
-                continue;
-            }
-
-            if ($filesystem->exists($destinationFile)) {
-                $overwrite = $this->confirmOverwrite($destinationFile);
-                if (!$overwrite) {
-                    $this->warn("Skipped: {$destinationFile} already exists");
-                    continue;
-                }
-            }
-
-            $filesystem->copy($sourceFile, $destinationFile);
-            $this->info("Copied: {$file} to project root");
-            $this->newLine();
+        foreach ($packages as $package) {
+            $this->configurePackage($package);
         }
     }
 
-    private function confirmOverwrite(string $file): bool
+    private function configurePackage(array $package): void
     {
-        $this->info(
-            sprintf('%s already exists. Do you want to overwrite it?', $file)
-        );
-
-        return $this->ask('Overwrite?', false);
+        spin(
+            callback: function () use ($package): void {
+                sleep(1);
+                $result = File::copy(
+                    __DIR__.'/../../stubs/'.$package['stub_file'],
+                    base_path($package['config_file'])
+                );
+                if (! $result) {
+                    self::fail(sprintf('❌ Failed to copy %s configuration file', $package['config_file']));
+                }
+            },
+            message: sprintf('Configuring %s...', $package['package_name']));
+        $this->info(sprintf('✅ %s configured successfully!', $package['package_name']));
     }
 }