Initial commit

Author: ajibarra

.gitignore

@@ -0,0 +1,3 @@
+.idea
+vendor
+composer.lock

CONTRIBUTING.md

@@ -0,0 +1,5 @@
+Contributing
+============
+
+This repository follows the [CakeDC Plugin Standard](https://www.cakedc.com/plugin-standard). 
+If you'd like to contribute new features, enhancements or bug fixes to the plugin, please read our [Contribution Guidelines](https://www.cakedc.com/contribution-guidelines) for detailed instructions.

LICENSE.txt

@@ -0,0 +1,26 @@
+The MIT License
+
+Copyright 2009-2019
+Cake Development Corporation
+1785 E. Sahara Avenue, Suite 490-423
+Las Vegas, Nevada 89104
+Phone: +1 702 425 5085
+https://www.cakedc.com
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,20 @@
+# DebugKit AI Panel for CakePHP
+
+## Installation
+  * composer require cakedc/cakephp-debugkit-ai
+  * Add `DebugKit.AI.apiKey` to your `app_local.php`
+  * Load plugin in `Application::bootstrap()` and ensure it is done before loading `DebugKit` plugin:
+
+```php
+public function bootstrap(): void
+{
+...
+$this->addPlugin(DebugKitAIPlugin::class, ['bootstrap' => true]);
+$this->addPlugin('DebugKit', ['bootstrap' => true]);
+...
+}
+```
+
+## TODO
+
+* HTML help

composer.json

@@ -0,0 +1,14 @@
+{
+    "name": "cakedc/cakephp-debugkit-ai",
+    "description": "DebugKit AI enhancements",
+    "autoload": {
+        "psr-4": {
+            "CakeDC\\DebugKitAI\\": "src/"
+        }
+    },
+    "require": {
+        "php": ">8.2",
+        "google-gemini-php/client": "^2.6",
+        "cakephp/cakephp": "^5.0"
+    }
+}

config/debugkit_ai.php

@@ -0,0 +1,14 @@
+<?php
+
+return [
+    'DebugKit' => [
+        'AI' => [
+            'client' => \CakeDC\DebugKitAI\Client\Gemini::class,
+            'model' => 'gemini-2.5-flash',
+            'excludedPanels' => ['AI']
+        ],
+        'panels' => [
+            'CakeDC/DebugKitAI.AI' => true
+        ],
+    ],
+];

src/Client/AbstractClient.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace CakeDC\DebugKitAI\Client;
+
+use CakeDC\DebugKitAI\Enum\Prompt;
+
+abstract class AbstractClient
+{
+
+    public abstract function sendPrompt(Prompt $prompt, string $info): string;
+
+}

src/Client/Gemini.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace CakeDC\DebugKitAI\Client;
+
+use Cake\Core\Configure;
+use CakeDC\DebugKitAI\Enum\Prompt;
+
+class Gemini extends AbstractClient
+{
+
+    /**
+     * @param Prompt $prompt
+     * @param string $info
+     * @return string
+     */
+    public function sendPrompt(Prompt $prompt, string $info): string
+    {
+        $client = \Gemini::client(Configure::read('DebugKit.AI.apiKey'));
+        $prompt = sprintf($prompt->getTemplate(), $info);
+        $result = $client->generativeModel(Configure::read('DebugKit.AI.model'))->generateContent($prompt);
+
+        return $result->text();
+    }
+}

src/Controller/AppController.php

@@ -0,0 +1,10 @@
+<?php
+declare(strict_types=1);
+
+namespace CakeDC\DebugKitAI\Controller;
+
+use App\Controller\AppController as BaseController;
+
+class AppController extends BaseController
+{
+}

src/Controller/RequestsController.php

@@ -0,0 +1,48 @@
+<?php
+declare(strict_types=1);
+
+namespace CakeDC\DebugKitAI\Controller;
+
+use App\Controller\AppController;
+use Cake\Cache\Cache;
+use Cake\Core\Configure;
+use CakeDC\DebugKitAI\Client\AbstractClient;
+use CakeDC\DebugKitAI\Enum\Prompt;
+
+/**
+ * Requests Controller
+ *
+ */
+class RequestsController extends AppController
+{
+    public function htmlHelp()
+    {
+        //TODO
+    }
+    public function debugKitHelp()
+    {
+        $request = $this->getTableLocator()->get('DebugKit.Requests')->find()->contain(['Panels'])->orderByDesc('requested_at')->first();
+        $panels = [];
+        foreach ($request->panels as $panel) {
+            if (in_array($panel->panel, Configure::read('DebugKit.AI.excludedPanels'))) continue;
+            $panels[$panel->panel] = [
+                'summary' => $panel->summary,
+                'content' => $panel->content
+            ];
+        }
+        $json = json_encode($panels);
+
+        $response = Cache::remember("DebugKitAI.requests.{$request->id}.debugKitHelp.response", function () use ($json) {
+            $clientClass = Configure::read('DebugKit.AI.client');
+            /** @var AbstractClient $client */
+            $client = new $clientClass();
+
+            return $client->sendPrompt(Prompt::ANALYZE_DEBUGKIT_DATA, $json);
+        });
+
+        $this->viewBuilder()->disableAutoLayout();
+        $this->viewBuilder()->setTemplate('help');
+        $this->set('response', $response);
+
+    }
+}