@artilingo/artiframe-cli 1.3.0 → 2.0.0

package/src/Commands/RemoveCommand.php

@@ -1,4 +1,4 @@
-<?php
+<?php
 namespace ArtiFrame\Cli\Commands;
 
 use ArtiFrame\Cli\Services\Translator;
@@ -24,7 +24,7 @@ class RemoveCommand
             return;
         }
 
-        $projectRoot = getcwd();
+        $projectRoot = $this->safeguard->getProjectRoot();
         
         $targetPath = $target;
         if (!file_exists($targetPath)) {
@@ -52,15 +52,26 @@ class RemoveCommand
         $isClass = strpos($normalizedPath, '/src/') !== false || strpos($normalizedPath, '/app/') !== false;
 
         if ($isView) {
-            $relPath = str_replace(str_replace('\\', '/', $projectRoot) . '/public/', '', $normalizedPath);
-            $relPath = preg_replace('/\.php$/', '', $relPath);
-            
-            $cssPath = $projectRoot . '/public/assets/css/' . $relPath . '.css';
-            $jsPath  = $projectRoot . '/public/assets/js/' . $relPath . '.js';
-
             $assetsFound = [];
-            if (file_exists($cssPath)) $assetsFound[] = $cssPath;
-            if (file_exists($jsPath)) $assetsFound[] = $jsPath;
+            $content = file_get_contents($targetPath);
+            
+            // Extract CSS path from href="/assets/css/...css"
+            if (preg_match('/href="(\/assets\/css\/[^"]+\.css)(?:\?[^"]*)?"/i', $content, $matches)) {
+                $cssRelative = ltrim($matches[1], '/');
+                $cssPath = rtrim($projectRoot, '/') . '/public/' . $cssRelative;
+                if (file_exists($cssPath)) {
+                    $assetsFound[] = $cssPath;
+                }
+            }
+            
+            // Extract JS path from src="/assets/js/...js"
+            if (preg_match('/src="(\/assets\/js\/[^"]+\.js)(?:\?[^"]*)?"/i', $content, $matches)) {
+                $jsRelative = ltrim($matches[1], '/');
+                $jsPath = rtrim($projectRoot, '/') . '/public/' . $jsRelative;
+                if (file_exists($jsPath)) {
+                    $assetsFound[] = $jsPath;
+                }
+            }
 
             if (!empty($assetsFound)) {
                 echo "\n⚠️  " . $this->translator->get('REMOVE_CONFIRM_ASSETS') . " [y/N]: ";

package/src/Commands/ServeCommand.php

@@ -14,7 +14,8 @@ class ServeCommand
 
     public function execute(array $args): void
     {
-        $projectRoot = getcwd();
+        $safeguard = new \ArtiFrame\Cli\Services\Safeguard($this->translator);
+        $projectRoot = $safeguard->getProjectRoot();
         $publicDir   = $projectRoot . '/public';
 
         if (!is_dir($publicDir) || !file_exists($publicDir . '/index.php')) {
@@ -32,34 +33,53 @@ class ServeCommand
             $port = $args[0];
         }
 
-        $url = "http://{$host}:{$port}";
+        // Detect Local IP
+        $localIp = 'Unknown';
+        $sock = @socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
+        if ($sock) {
+            @socket_connect($sock, "8.8.8.8", 53);
+            @socket_getsockname($sock, $localIp);
+            @socket_close($sock);
+        }
+        if ($localIp === 'Unknown' || $localIp === '127.0.0.1' || $localIp === '::1' || empty($localIp)) {
+            $localIp = getHostByName(getHostName());
+        }
+
+        $localUrl = "http://localhost:{$port}";
+        $networkUrl = "http://{$localIp}:{$port}";
         
         echo "
-  🚀  " . $this->translator->get('SERVE_STARTING', ['url' => $url]) . "
+  🚀  " . $this->translator->get('SERVE_STARTING', ['url' => "0.0.0.0:{$port}"]) . "
 ";
         echo "      " . $this->translator->get('SERVE_STOP_INFO') . "
 
-";
+      Local:   {$localUrl}";
+        
+        if ($localIp && $localIp !== '127.0.0.1' && $localIp !== 'Unknown') {
+            echo "
+      Network: {$networkUrl}";
+        }
+        echo "\n\n";
 
         $os = PHP_OS_FAMILY;
         
-        // Command to start PHP built-in server
-        $phpCmd = sprintf('php -S %s:%s -t %s', $host, $port, escapeshellarg($publicDir));
+        // Command to start PHP built-in server on all interfaces (0.0.0.0)
+        $phpCmd = sprintf('php -S 0.0.0.0:%s -t %s', $port, escapeshellarg($publicDir));
 
         if ($os === 'Windows') {
             // Open Browser
-            pclose(popen("start {$url}", "r"));
+            pclose(popen("start {$localUrl}", "r"));
             // Start Server in new visible CMD window
             pclose(popen("start \"ArtiFrame Server\" cmd /k \"{$phpCmd}\"", "r"));
         } elseif ($os === 'Darwin') {
             // Open Browser
-            exec("open {$url} > /dev/null 2>&1 &");
+            exec("open {$localUrl} > /dev/null 2>&1 &");
             // Start Server in new Terminal window
             $appleScript = 'tell app "Terminal" to do script "' . escapeshellcmd($phpCmd) . '"';
             exec("osascript -e " . escapeshellarg($appleScript));
         } else {
             // Open Browser
-            exec("xdg-open {$url} > /dev/null 2>&1 &");
+            exec("xdg-open {$localUrl} > /dev/null 2>&1 &");
             // Linux: Try common terminals, fallback to background process
             $linuxCmd = sprintf(
                 'gnome-terminal -- bash -c "%s" || xterm -e "%s" || konsole -e "%s" || %s > /dev/null 2>&1 &',

package/src/Commands/SuggestCommand.php

@@ -0,0 +1,143 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+
+class SuggestCommand
+{
+    private Translator $translator;
+    const API_ENDPOINT = 'https://api.artilingo.com/artiframe/v1/suggest.php';
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+    }
+
+    public function execute(array $args): void
+    {
+        $home = getenv('HOME') ?: getenv('USERPROFILE');
+        $configFile = $home . \DIRECTORY_SEPARATOR . '.artiframe' . \DIRECTORY_SEPARATOR . 'config.json';
+
+        if (!file_exists($configFile)) {
+            echo "\033[1;31m[-] Not authenticated. Please run 'artiframe auth' first.\033[0m" . PHP_EOL;
+            return;
+        }
+
+        $config = json_decode(file_get_contents($configFile), true);
+        if (!$config || !isset($config['github_token'])) {
+            echo "\033[1;31m[-] Not authenticated. Please run 'artiframe auth' first.\033[0m" . PHP_EOL;
+            return;
+        }
+
+        $token = $config['github_token'];
+        $username = $config['github_user'] ?? 'User';
+
+        echo "\033[1;36mHello @{$username}, welcome to ArtiFrame Issue Submitter!\033[0m" . PHP_EOL;
+        echo PHP_EOL;
+
+        // 1. Ask for Category
+        $categories = [
+            '1' => 'Feature Request',
+            '2' => 'Bug Report',
+            '3' => 'Helper Suggestion'
+        ];
+
+        echo "Please select a Category:" . PHP_EOL;
+        echo "  [1] Feature Request" . PHP_EOL;
+        echo "  [2] Bug Report" . PHP_EOL;
+        echo "  [3] Helper Suggestion" . PHP_EOL;
+        
+        $categoryId = null;
+        while (true) {
+            echo "Select [1-3]: ";
+            $input = trim(fgets(STDIN));
+            if (isset($categories[$input])) {
+                $categoryId = $input;
+                break;
+            }
+            echo "\033[1;31mInvalid selection.\033[0m" . PHP_EOL;
+        }
+
+        $category = $categories[$categoryId];
+
+        // 2. Ask for Title
+        echo PHP_EOL;
+        $title = '';
+        while (true) {
+            echo "Title (Short summary, max 120 chars): ";
+            $title = trim(fgets(STDIN));
+            if (strlen($title) === 0) {
+                echo "\033[1;31mTitle cannot be empty.\033[0m" . PHP_EOL;
+            } elseif (strlen($title) > 120) {
+                echo "\033[1;31mTitle is too long. Max 120 chars.\033[0m" . PHP_EOL;
+            } else {
+                break;
+            }
+        }
+
+        // 3. Ask for Description
+        echo PHP_EOL;
+        echo "Description (Detailed explanation or code sample):" . PHP_EOL;
+        echo "\033[1;33m(Type 'END' on a new line and press Enter to finish)\033[0m" . PHP_EOL;
+        
+        $bodyLines = [];
+        while (true) {
+            $line = fgets(STDIN);
+            if ($line === false || trim(strtoupper($line)) === 'END') {
+                break;
+            }
+            $bodyLines[] = rtrim($line, "\r\n");
+        }
+        $body = implode(PHP_EOL, $bodyLines);
+
+        if (empty(trim($body))) {
+            echo "\033[1;31m[-] Description cannot be empty. Aborting.\033[0m" . PHP_EOL;
+            return;
+        }
+
+        // 4. Send Payload
+        echo PHP_EOL . "\033[1;36mSubmitting to ArtiFrame...\033[0m" . PHP_EOL;
+
+        $payload = json_encode([
+            'token' => $token,
+            'category' => $category,
+            'title' => $title,
+            'body' => $body
+        ]);
+
+        $ch = curl_init(self::API_ENDPOINT);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($ch, CURLOPT_POST, true);
+        curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
+        curl_setopt($ch, CURLOPT_HTTPHEADER, [
+            'Content-Type: application/json',
+            'Accept: application/json'
+        ]);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
+        curl_setopt($ch, CURLOPT_USERAGENT, 'ArtiFrame-CLI');
+
+        $response = curl_exec($ch);
+        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+        curl_close($ch);
+
+        if ($response) {
+            $data = json_decode($response, true);
+            if ($httpCode === 200 && isset($data['status']) && $data['status'] === 'success') {
+                echo "\033[1;32m🎉 Issue successfully created!\033[0m" . PHP_EOL;
+                echo "URL: " . ($data['issue_url'] ?? 'N/A') . PHP_EOL;
+            } else {
+                if ($data && isset($data['message'])) {
+                    echo "\033[1;31m[-] Server Error: " . $data['message'] . "\033[0m" . PHP_EOL;
+                } else {
+                    echo "\033[1;31m[-] Server Error: Unknown response format.\033[0m" . PHP_EOL;
+                    echo "HTTP Code: " . $httpCode . PHP_EOL;
+                    echo "Raw Response: " . substr($response, 0, 300) . PHP_EOL;
+                }
+            }
+        } else {
+            echo "\033[1;31m[-] Failed to communicate with the server.\033[0m" . PHP_EOL;
+            echo "cURL Error: " . curl_error($ch) . PHP_EOL;
+        }
+    }
+}

package/src/Commands/TableCommand.php

@@ -69,7 +69,8 @@ class TableCommand
             return;
         }
 
-        $schemaPath = getcwd() . '/schema.sql';
+        $safeguard = new \ArtiFrame\Cli\Services\Safeguard($this->translator);
+        $schemaPath = $safeguard->getProjectRoot() . '/schema.sql';
 
         if (!file_exists($schemaPath)) {
             file_put_contents($schemaPath, "-- ArtiFrame DB Schema\n-- Created: " . date('Y-m-d') . "\n");

package/src/Commands/UpgradeCommand.php

@@ -0,0 +1,209 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+
+class UpgradeCommand
+{
+    private Translator $translator;
+    private array $changes = [
+        'added' => [],
+        'modified' => []
+    ];
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+    }
+
+    public function execute(array $args): void
+    {
+        $targetDir = getcwd();
+
+        if (!file_exists($targetDir . '/composer.json') || !is_dir($targetDir . '/app') || !is_dir($targetDir . '/bin')) {
+            echo "❌ " . $this->translator->get('ERROR_RUN_FROM_ROOT') . PHP_EOL;
+            return;
+        }
+
+        // ── KURAL 1: INDEX.PHP KORUMASI ────────────────────────────────
+        $indexFile = $targetDir . '/public/index.php';
+        if (file_exists($indexFile)) {
+            $indexContent = file_get_contents($indexFile);
+            if (strpos($indexContent, 'routeLink(') === false) {
+                echo PHP_EOL . "❌ " . $this->translator->get('UPGRADE_INDEX_ABORT') . PHP_EOL;
+                return;
+            }
+        }
+
+        // ── KURAL 2: ÇEKİRDEK (BIN) DEĞİŞİKLİK KONTROLÜ ────────────────
+        $coreStubsBinDir = \ARTIFRAME_CLI_ROOT . '/core-stubs/bin';
+        $projectBinDir = $targetDir . '/bin';
+
+        $isCoreModified = false;
+        $filesToCheck = ['SystemMethod.php', 'ViewMethod.php'];
+
+        foreach ($filesToCheck as $file) {
+            $stubPath = $coreStubsBinDir . '/' . $file;
+            $projPath = $projectBinDir . '/' . $file;
+
+            if (file_exists($stubPath) && file_exists($projPath)) {
+                if (md5_file($stubPath) !== md5_file($projPath)) {
+                    $isCoreModified = true;
+                    break;
+                }
+            }
+        }
+
+        if ($isCoreModified) {
+            echo PHP_EOL . "⚠️  " . $this->translator->get('UPGRADE_CORE_WARNING') . PHP_EOL;
+            // The prompt asks to press Enter to continue.
+            $choice = trim(fgets(STDIN));
+            if (strtolower($choice) === 'n' || strtolower($choice) === 'h') {
+                echo $this->translator->get('ABORTED') . PHP_EOL;
+                return;
+            }
+        }
+
+        echo PHP_EOL . "🚀 " . $this->translator->get('PHASE_COPYING') . PHP_EOL;
+
+        // ── KURAL 3 & ANA İŞLEM: KOPYALAMA ──────────────────────────────
+        $this->copyDirectory(\ARTIFRAME_CLI_ROOT . '/core-stubs/app', $targetDir . '/app');
+        $this->copyDirectory(\ARTIFRAME_CLI_ROOT . '/core-stubs/bin', $targetDir . '/bin');
+
+        // Docs
+        $docsSource = \ARTIFRAME_CLI_ROOT . '/core-stubs/docs';
+        $docsTarget = $targetDir . '/public/docs';
+        if (is_dir($docsSource)) {
+            if (!is_dir($docsTarget)) {
+                mkdir($docsTarget, 0755, true);
+            }
+            $this->copyDirectory($docsSource, $docsTarget);
+        }
+
+        // ── KURAL 4: SERVICE STUB EZİLMESİ ──────────────────────────────
+        $servicesDir = $targetDir . '/src/Service';
+        $stubsServicesDir = \ARTIFRAME_CLI_ROOT . '/stubs/services';
+
+        if (is_dir($servicesDir) && is_dir($stubsServicesDir)) {
+            $iterator = new \DirectoryIterator($servicesDir);
+            foreach ($iterator as $fileinfo) {
+                if ($fileinfo->isFile() && $fileinfo->getExtension() === 'php') {
+                    $filename = $fileinfo->getFilename();
+                    
+                    $stubIterator = new \DirectoryIterator($stubsServicesDir);
+                    foreach ($stubIterator as $stubInfo) {
+                        if ($stubInfo->isFile() && $stubInfo->getExtension() === 'stub') {
+                            $stubName = $stubInfo->getBasename('.stub');
+                            $expectedServiceName = ucfirst($stubName) . 'Service.php';
+                            
+                            if ($filename === $expectedServiceName) {
+                                $oldContent = file_get_contents($fileinfo->getPathname());
+                                $content = file_get_contents($stubInfo->getPathname());
+                                if (md5($oldContent) !== md5($content)) {
+                                    $oldFunctions = $this->getFunctionsFromFile($fileinfo->getPathname());
+                                    $newFunctions = $this->getFunctionsFromFile($stubInfo->getPathname());
+                                    $addedFunctions = array_values(array_diff($newFunctions, $oldFunctions));
+                                    
+                                    file_put_contents($fileinfo->getPathname(), $content);
+                                    $this->changes['modified']['src/Service/' . $filename] = [
+                                        'added_functions' => $addedFunctions
+                                    ];
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        if (empty($this->changes['added']) && empty($this->changes['modified'])) {
+            echo PHP_EOL . "✅ " . $this->translator->get('UPGRADE_SUCCESS') . " (Sistem zaten güncel)" . PHP_EOL . PHP_EOL;
+        } else {
+            echo PHP_EOL . "✅ " . $this->translator->get('UPGRADE_SUCCESS') . PHP_EOL . PHP_EOL;
+            
+            echo "📊 Değişiklik Raporu:" . PHP_EOL;
+            echo str_repeat('-', 40) . PHP_EOL;
+            
+            if (!empty($this->changes['added'])) {
+                echo "\e[32m[EKLENDİ]\e[0m" . PHP_EOL;
+                foreach ($this->changes['added'] as $add) {
+                    echo "  + $add" . PHP_EOL;
+                }
+                echo PHP_EOL;
+            }
+            
+            if (!empty($this->changes['modified'])) {
+                echo "\e[33m[GÜNCELLENDİ]\e[0m" . PHP_EOL;
+                foreach ($this->changes['modified'] as $mod => $details) {
+                    echo "  ~ $mod" . PHP_EOL;
+                    if (!empty($details['added_functions'])) {
+                        foreach ($details['added_functions'] as $func) {
+                            echo "      \e[36m[YENİ FONKSİYON]\e[0m $func() - Lütfen dokümantasyonu inceleyin." . PHP_EOL;
+                        }
+                    }
+                }
+                echo PHP_EOL;
+            }
+        }
+    }
+
+    private function copyDirectory(string $source, string $target): void
+    {
+        if (!is_dir($target)) {
+            mkdir($target, 0755, true);
+        }
+
+        $dir = opendir($source);
+        while (($file = readdir($dir)) !== false) {
+            if ($file === '.' || $file === '..') {
+                continue;
+            }
+            $srcFile = $source . '/' . $file;
+            $tgtFile = $target . '/' . $file;
+
+            if (is_dir($srcFile)) {
+                $this->copyDirectory($srcFile, $tgtFile);
+            } else {
+                $isNew = !file_exists($tgtFile);
+                $isModified = !$isNew && (md5_file($srcFile) !== md5_file($tgtFile));
+
+                if ($isNew || $isModified) {
+                    $addedFunctions = [];
+                    if ($isModified && pathinfo($srcFile, PATHINFO_EXTENSION) === 'php') {
+                        $oldFunctions = $this->getFunctionsFromFile($tgtFile);
+                        $newFunctions = $this->getFunctionsFromFile($srcFile);
+                        $addedFunctions = array_values(array_diff($newFunctions, $oldFunctions));
+                    }
+                    
+                    copy($srcFile, $tgtFile);
+                    
+                    $normalizedTarget = str_replace('\\', '/', $tgtFile);
+                    $normalizedCwd = str_replace('\\', '/', getcwd()) . '/';
+                    $relativePath = str_replace($normalizedCwd, '', $normalizedTarget);
+                    
+                    if ($isNew) {
+                        $this->changes['added'][] = $relativePath;
+                    } else {
+                        $this->changes['modified'][$relativePath] = [
+                            'added_functions' => $addedFunctions
+                        ];
+                    }
+                }
+            }
+        }
+        closedir($dir);
+    }
+
+    private function getFunctionsFromFile(string $filepath): array
+    {
+        if (!file_exists($filepath)) {
+            return [];
+        }
+        $content = file_get_contents($filepath);
+        $functions = [];
+        if (preg_match_all('/function\s+([a-zA-Z0-9_]+)\s*\(/i', $content, $matches)) {
+            $functions = $matches[1];
+        }
+        return $functions;
+    }
+}

package/src/Commands/VersionCommand.php

@@ -27,7 +27,8 @@ class VersionCommand
             return;
         }
 
-        $projectRoot = getcwd();
+        $safeguard = new \ArtiFrame\Cli\Services\Safeguard($this->translator);
+        $projectRoot = $safeguard->getProjectRoot();
         $versionFile = $projectRoot . '/config/app-version.php';
 
         if (!file_exists($versionFile)) {

package/src/Lang/de.php

@@ -59,6 +59,7 @@ return [
     // Help screen
     'HELP_COMMANDS'          => 'BEFEHLE',
     'HELP_NEW_DESC'          => 'Erstellt ein neues ArtiFrame-Projekt von Grund auf.',
+    'HELP_UPGRADE_DESC'      => 'Wendet aktualisierte CLI-Kernfunktionen (app, bin) von NPM auf Ihr Projekt an.',
     'HELP_MAKEVIEW_DESC1'    => 'Erstellt eine neue View-Datei mit CSS- und JS-Assets.',
     'HELP_MAKEVIEW_DESC2'    => 'Der Pfad kann Unterverzeichnisse enthalten (automatisch erstellt).',
     'HELP_MAKEAPI_DESC'      => 'Erstellt eine neue API-Endpunkt-Datei.',
@@ -75,6 +76,8 @@ return [
     'HELP_MAJOR_DOWN'        => 'Letzte Major-Version zurücksetzen.',
     'HELP_HELP_DESC'         => 'Diese Hilfemeldung anzeigen.',
     'HELP_EXIT_DESC'         => 'Die interaktive Shell beenden.',
+    'HELP_AUTH_DESC'         => 'Authentifizieren Sie sich bei GitHub, um Vorschläge einzureichen.',
+    'HELP_SUGGEST_DESC'      => 'Reichen Sie einen Funktionswunsch, Fehlerbericht oder Vorschlag direkt bei GitHub ein.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Aktuelle Sprache:',
@@ -176,6 +179,11 @@ return [
     'TABLE_LIST_HEADER' => 'Unterstützte Tabellen:',
     'TABLE_DESC_USERS' => 'Basis-Benutzer- und Autorisierungstabelle (UUID).',
     'TABLE_DESC_USER_SESSIONS' => 'Benutzersitzungen (IP, Gerät, Token) verfolgen.',
-    'TABLE_DESC_USER_PREFERENCES' => 'Benutzereinstellungen (Sprache, Thema, Benachrichtigungen).',
+    'TABLE_DESC_USER_PREFERENCES' => 'Benutzereinstellungen (Sprache, Design, Benachrichtigungen).',
+
+    // Upgrade
+    'UPGRADE_INDEX_ABORT' => 'public/index.php Datei erkannt! In der neuen Version fungiert diese Datei als Router. Um das Upgrade fortzusetzen, benennen Sie bitte Ihre bestehende index.php in landing.php (oder einen anderen Namen) um und führen Sie den Befehl erneut aus.',
+    'UPGRADE_CORE_WARNING' => 'Ihr Projektkern unterscheidet sich von der Originalversion. Wenn Sie manuell Funktionen hinzugefügt haben, sichern Sie diese bitte vor dem Upgrade, um Datenverlust zu vermeiden. Drücken Sie die Eingabetaste, um nach der Sicherung fortzufahren.',
+    'UPGRADE_SUCCESS' => 'Kern (app/ und bin/) und Service-Stubs erfolgreich aktualisiert!',
 
 ];

package/src/Lang/en.php

@@ -59,6 +59,7 @@ return [
     // Help screen
     'HELP_COMMANDS'          => 'COMMANDS',
     'HELP_NEW_DESC'          => 'Create a new ArtiFrame project from scratch.',
+    'HELP_UPGRADE_DESC'      => 'Applies updated core features (app, bin) from NPM to the current project.',
     'HELP_MAKEVIEW_DESC1'    => 'Generate a new view file with its paired CSS and JS assets.',
     'HELP_MAKEVIEW_DESC2'    => 'The path can use subdirectories (auto-created).',
     'HELP_MAKEAPI_DESC'      => 'Generate a new API endpoint file.',
@@ -75,6 +76,8 @@ return [
     'HELP_MAJOR_DOWN'        => 'Roll back last major release.',
     'HELP_HELP_DESC'         => 'Show this help message.',
     'HELP_EXIT_DESC'         => 'Exit the interactive shell.',
+    'HELP_AUTH_DESC'         => 'Authenticate with GitHub to enable issue suggestions.',
+    'HELP_SUGGEST_DESC'      => 'Submit a feature request, bug report, or helper suggestion directly to GitHub.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Current language:',
@@ -178,4 +181,9 @@ return [
     'TABLE_DESC_USER_SESSIONS' => 'User sessions (IP, device, token) tracking.',
     'TABLE_DESC_USER_PREFERENCES' => 'User preferences (language, theme, notifications).',
 
+    // Upgrade
+    'UPGRADE_INDEX_ABORT' => 'public/index.php file detected! In the new version, this file acts as a router. To continue the upgrade, please rename your existing index.php to landing.php (or any other name) and run the command again.',
+    'UPGRADE_CORE_WARNING' => 'Your project core is different from the original version. If you have manually added functions, please back them up before upgrading to prevent data loss. Press Enter to continue after backing up.',
+    'UPGRADE_SUCCESS' => 'Core (app/ and bin/) and service stubs updated successfully!',
+
 ];

package/src/Lang/es.php

@@ -59,6 +59,7 @@ return [
     // Help screen
     'HELP_COMMANDS'          => 'COMANDOS',
     'HELP_NEW_DESC'          => 'Crea un nuevo proyecto ArtiFrame desde cero.',
+    'HELP_UPGRADE_DESC'      => 'Aplica las características actualizadas del núcleo CLI (app, bin) desde NPM al proyecto.',
     'HELP_MAKEVIEW_DESC1'    => 'Genera un nuevo archivo de vista con sus recursos CSS y JS.',
     'HELP_MAKEVIEW_DESC2'    => 'La ruta puede usar subdirectorios (creados automáticamente).',
     'HELP_MAKEAPI_DESC'      => 'Genera un nuevo archivo de punto de conexión API.',
@@ -75,6 +76,8 @@ return [
     'HELP_MAJOR_DOWN'        => 'Revertir la última versión mayor.',
     'HELP_HELP_DESC'         => 'Mostrar este mensaje de ayuda.',
     'HELP_EXIT_DESC'         => 'Salir del shell interactivo.',
+    'HELP_AUTH_DESC'         => 'Autentifícate con GitHub para habilitar las sugerencias de issues.',
+    'HELP_SUGGEST_DESC'      => 'Envía una solicitud de función, un informe de error o una sugerencia de ayuda directamente a GitHub.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Idioma actual:',
@@ -176,6 +179,11 @@ return [
     'TABLE_LIST_HEADER' => 'Tablas compatibles:',
     'TABLE_DESC_USERS' => 'Tabla básica de usuarios y autorización (UUID).',
     'TABLE_DESC_USER_SESSIONS' => 'Seguimiento de sesiones de usuario (IP, dispositivo, token).',
-    'TABLE_DESC_USER_PREFERENCES' => 'Preferencias de usuario (idioma, tema, notificaciones).',
+    'TABLE_DESC_USER_PREFERENCES' => 'Preferencias del usuario (idioma, tema, notificaciones).',
+
+    // Upgrade
+    'UPGRADE_INDEX_ABORT' => '¡Archivo public/index.php detectado! En la nueva versión, este archivo actúa como un enrutador. Para continuar con la actualización, cambie el nombre de su index.php existente a landing.php (o cualquier otro nombre) y vuelva a ejecutar el comando.',
+    'UPGRADE_CORE_WARNING' => 'El núcleo de su proyecto es diferente de la versión original. Si ha agregado funciones manualmente, haga una copia de seguridad antes de actualizar para evitar la pérdida de datos. Presione Entrar para continuar después de hacer la copia de seguridad.',
+    'UPGRADE_SUCCESS' => '¡Núcleo (app/ y bin/) y stubs de servicio actualizados con éxito!',
 
 ];

package/src/Lang/fr.php

@@ -59,6 +59,7 @@ return [
     // Help screen
     'HELP_COMMANDS'          => 'COMMANDES',
     'HELP_NEW_DESC'          => 'Crée un nouveau projet ArtiFrame de zéro.',
+    'HELP_UPGRADE_DESC'      => 'Applique les fonctionnalités principales mises à jour du CLI (app, bin) depuis NPM au projet.',
     'HELP_MAKEVIEW_DESC1'    => 'Génère un nouveau fichier vue avec ses assets CSS et JS.',
     'HELP_MAKEVIEW_DESC2'    => 'Le chemin peut utiliser des sous-répertoires (créés automatiquement).',
     'HELP_MAKEAPI_DESC'      => 'Génère un nouveau fichier de point de terminaison API.',
@@ -75,6 +76,8 @@ return [
     'HELP_MAJOR_DOWN'        => 'Annuler la dernière version majeure.',
     'HELP_HELP_DESC'         => 'Afficher ce message d\'aide.',
     'HELP_EXIT_DESC'         => 'Quitter le shell interactif.',
+    'HELP_AUTH_DESC'         => 'Authentifiez-vous avec GitHub pour permettre les suggestions.',
+    'HELP_SUGGEST_DESC'      => 'Soumettez une demande de fonctionnalité, un rapport de bogue ou une suggestion d\'aide directement sur GitHub.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Langue actuelle :',
@@ -178,4 +181,9 @@ return [
     'TABLE_DESC_USER_SESSIONS' => 'Suivi des sessions utilisateur (IP, appareil, token).',
     'TABLE_DESC_USER_PREFERENCES' => 'Préférences de l\'utilisateur (langue, thème, notifications).',
 
+    // Upgrade
+    'UPGRADE_INDEX_ABORT' => 'Fichier public/index.php détecté ! Dans la nouvelle version, ce fichier agit comme un routeur. Pour continuer la mise à jour, veuillez renommer votre index.php existant en landing.php (ou tout autre nom) et relancez la commande.',
+    'UPGRADE_CORE_WARNING' => 'Le cœur de votre projet diffère de la version originale. Si vous avez ajouté manuellement des fonctions, veuillez les sauvegarder avant la mise à jour pour éviter toute perte de données. Appuyez sur Entrée pour continuer après la sauvegarde.',
+    'UPGRADE_SUCCESS' => 'Cœur (app/ et bin/) et stubs de services mis à jour avec succès !',
+
 ];

package/src/Lang/tr.php

@@ -59,6 +59,7 @@ return [
     // Help screen
     'HELP_COMMANDS'          => 'KOMUTLAR',
     'HELP_NEW_DESC'          => 'Sıfırdan yeni bir ArtiFrame projesi oluşturur.',
+    'HELP_UPGRADE_DESC'      => 'NPM üzerinden güncellenen çekirdek özellikleri (app, bin) mevcut projeye uygular.',
     'HELP_MAKEVIEW_DESC1'    => 'CSS ve JS varlıklarıyla birlikte yeni bir view dosyası oluşturur.',
     'HELP_MAKEVIEW_DESC2'    => 'Yol alt dizinleri içerebilir (otomatik oluşturulur).',
     'HELP_MAKEAPI_DESC'      => 'Yeni bir API endpoint dosyası oluşturur.',
@@ -74,7 +75,9 @@ return [
     'HELP_MINOR_DOWN'        => 'Son minör sürümün geri alınması.',
     'HELP_MAJOR_DOWN'        => 'Son majör sürümün geri alınması.',
     'HELP_HELP_DESC'         => 'Bu yardım mesajını gösterir.',
-    'HELP_EXIT_DESC'         => 'İnteraktif kabuğu kapatır.',
+    'HELP_EXIT_DESC'         => 'Etkileşimli kabuktan çık.',
+    'HELP_AUTH_DESC'         => 'Issue önerileri için GitHub ile kimlik doğrulaması yapın.',
+    'HELP_SUGGEST_DESC'      => 'GitHub\'a doğrudan özellik isteği, hata bildirimi veya öneri gönderin.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Mevcut dil:',
@@ -156,7 +159,7 @@ return [
     'SERVE_NOT_PROJECT' => 'Bu dizin geçerli bir ArtiFrame projesi değil (public/index.php bulunamadı).',
     'SERVE_STARTING'    => 'Geliştirme sunucusu başlatılıyor: :url',
     'SERVE_STOP_INFO'   => 'Durdurmak için CTRL+C tuşlarına basın.',
-    'HELP_SERVE_DESC'   => 'Lokal geliştirme sunucusunu başlatır.',
+    'HELP_SERVE_DESC'   => 'Geliştirme sunucusunu başlatır ve yerel ağa açar.',
 
     'INVALID_PACKAGE_NAME' => 'Geçersiz paket adı. Format şuna benzemeli: vendor/project',
 
@@ -178,4 +181,9 @@ return [
     'TABLE_DESC_USER_SESSIONS' => 'Kullanıcı oturumları (IP, cihaz, token) takibi.',
     'TABLE_DESC_USER_PREFERENCES' => 'Kullanıcı tercihleri (dil, tema, bildirimler).',
 
+    // Upgrade
+    'UPGRADE_INDEX_ABORT' => 'public/index.php dosyası tespit edildi! Yeni sürümde bu dosya artık bir router\'dır. Güncellemeye devam edebilmek için lütfen mevcut index.php\'nizin adını landing.php (veya istediğiniz başka bir isim) olarak değiştirin ve komutu tekrar çalıştırın.',
+    'UPGRADE_CORE_WARNING' => 'Proje çekirdeğiniz orijinal sürümden farklı. Manuel olarak eklediğiniz fonksiyonlar varsa kayba uğramamak için güncellemeden önce lütfen kopyalarını alın. Kopyalarını aldıktan sonra Enter tuşuna basarak devam edebilirsiniz.',
+    'UPGRADE_SUCCESS' => 'Çekirdek (app/ ve bin/) ile servis şablonları başarıyla güncellendi!',
+
 ];