@artilingo/artiframe-cli 1.3.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artilingo/artiframe-cli",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "description": "ArtiFrame — Zero-dependency native PHP framework with a powerful multilingual CLI. Scaffold projects, generate views, APIs and classes instantly.",
   "main": "bin/artiframe.js",
   "bin": {

package/src/App.php

@@ -199,6 +199,10 @@ class App
             case 'new':
                 (new \ArtiFrame\Cli\Commands\NewProjectCommand($this->translator))->execute($commandArgs);
                 break;
+
+            case 'upgrade':
+                (new \ArtiFrame\Cli\Commands\UpgradeCommand($this->translator))->execute($commandArgs);
+                break;
                 
             case 'make:view':
                 (new \ArtiFrame\Cli\Commands\MakeViewCommand($this->translator))->execute($commandArgs);
@@ -230,6 +234,18 @@ class App
                 (new \ArtiFrame\Cli\Commands\ServeCommand($this->translator))->execute($commandArgs);
                 break;
 
+            case 'auth':
+                (new \ArtiFrame\Cli\Commands\AuthCommand($this->translator))->execute($commandArgs);
+                break;
+
+            case 'suggest':
+                (new \ArtiFrame\Cli\Commands\SuggestCommand($this->translator))->execute($commandArgs);
+                break;
+
+            case 'issues':
+                (new \ArtiFrame\Cli\Commands\IssuesCommand($this->translator))->execute($commandArgs);
+                break;
+
             case 'add':
                 (new \ArtiFrame\Cli\Commands\AddCommand($this->translator))->execute($commandArgs);
                 break;
@@ -290,6 +306,10 @@ class App
         echo "  " . $g . "new" . $r . " " . $y . "<project-path>" . $r . PHP_EOL;
         echo "  " . $d . "│" . $r . "   " . $t->get('HELP_NEW_DESC') . PHP_EOL;
         echo "  " . $d . "└── " . $r . "Example: " . $lg . "new my-app" . $r . PHP_EOL;
+        // upgrade
+        echo "  " . $g . "upgrade" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   " . $t->get('HELP_UPGRADE_DESC') . PHP_EOL;
+        echo "  " . $d . "└── " . $r . "Example: " . $lg . "upgrade" . $r . PHP_EOL;
         echo PHP_EOL;
 
         // make:view
@@ -383,6 +403,24 @@ class App
         echo "  " . $d . "└── " . $r . $lg . "add list" . $r . $d . "       " . $t->get('HELP_ADD_LIST') . $r . PHP_EOL;
         echo PHP_EOL;
 
+        // auth
+        echo "  " . $g . "auth" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   " . $t->get('HELP_AUTH_DESC') . PHP_EOL;
+        echo "  " . $d . "└── " . $r . "Example: " . $lg . "auth" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // suggest
+        echo "  " . $g . "suggest" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   " . $t->get('HELP_SUGGEST_DESC') . PHP_EOL;
+        echo "  " . $d . "└── " . $r . "Example: " . $lg . "suggest" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // issues
+        echo "  " . $g . "issues" . $r . " " . $y . "[id]" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   " . $t->get('HELP_ISSUES_DESC') . PHP_EOL;
+        echo "  " . $d . "└── " . $r . "Example: " . $lg . "issues" . $r . " or " . $lg . "issues 4" . $r . PHP_EOL;
+        echo PHP_EOL;
+
         // help / exit
         echo "  " . $d . "─────────────────────────────────────────────────────────────" . $r . PHP_EOL;
         echo "  " . $g . "help" . $r . "           " . $t->get('HELP_HELP_DESC') . PHP_EOL;

package/src/Commands/AddCommand.php

@@ -82,7 +82,7 @@ class AddCommand
         'sentry' => [
             'composer' => 'sentry/sentry',
             'type'     => 'integrated',
-            'service'  => 'config/sentry.php',
+            'service'  => 'src/Service/Sentry.php',
             'stub'     => 'sentry.stub',
             'env'      => [
                 '# ── sentry ──────────────────────',

package/src/Commands/AuthCommand.php

@@ -0,0 +1,219 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+
+class AuthCommand
+{
+    private Translator $translator;
+    
+    // Placeholder Client ID as requested
+    const CLIENT_ID = 'Ov23libWFmWDGtyaSEiT';
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+    }
+
+    public function execute(array $args): void
+    {
+        echo "\033[1;36mInitializing GitHub Authentication...\033[0m" . PHP_EOL;
+
+        // 1. Request Device Code
+        $deviceCodeData = $this->requestDeviceCode();
+        if (!$deviceCodeData) {
+            return;
+        }
+
+        $deviceCode = $deviceCodeData['device_code'];
+        $userCode = $deviceCodeData['user_code'];
+        $verificationUri = $deviceCodeData['verification_uri'];
+        $interval = (int)($deviceCodeData['interval'] ?? 5);
+
+        // 2. Display instructions
+        echo PHP_EOL;
+        echo "\033[1;33mAction Required:\033[0m" . PHP_EOL;
+        echo "1. Please open your browser to: \033[1;34m" . $verificationUri . "\033[0m" . PHP_EOL;
+        echo "2. Enter the following code to authorize: \033[1;32m" . $userCode . "\033[0m" . PHP_EOL;
+        echo PHP_EOL;
+        echo "Waiting for authorization..." . PHP_EOL;
+
+        // 3. Open browser automatically
+        $this->openBrowser($verificationUri);
+
+        // 4. Poll for Access Token
+        $accessToken = $this->pollForToken($deviceCode, $interval);
+        
+        if ($accessToken) {
+            // 5. Fetch user profile
+            $userProfile = $this->fetchUserProfile($accessToken);
+            $username = $userProfile['login'] ?? 'Unknown User';
+
+            // 6. Save configuration
+            $this->saveConfig($accessToken, $username);
+            
+            echo "\033[1;32m✔ Successfully authenticated as @{$username}!\033[0m" . PHP_EOL;
+        }
+    }
+
+    private function requestDeviceCode(): ?array
+    {
+        $ch = curl_init('https://github.com/login/device/code');
+        $postData = http_build_query([
+            'client_id' => self::CLIENT_ID,
+            'scope' => 'public_repo'
+        ]);
+
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($ch, CURLOPT_POST, true);
+        curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
+        curl_setopt($ch, CURLOPT_HTTPHEADER, [
+            'Accept: application/json'
+        ]);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
+        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);
+
+        if ($httpCode !== 200 || !$response) {
+            echo "\033[1;31m[-] Failed to request device code from GitHub.\033[0m" . PHP_EOL;
+            curl_close($ch);
+            return null;
+        }
+        curl_close($ch);
+
+        return json_decode($response, true);
+    }
+
+    private function pollForToken(string $deviceCode, int $interval): ?string
+    {
+        $url = 'https://github.com/login/oauth/access_token';
+        
+        while (true) {
+            sleep($interval);
+
+            $ch = curl_init($url);
+            $postData = http_build_query([
+                'client_id' => self::CLIENT_ID,
+                'device_code' => $deviceCode,
+                'grant_type' => 'urn:ietf:params:oauth:grant-type:device_code'
+            ]);
+
+            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+            curl_setopt($ch, CURLOPT_POST, true);
+            curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
+            curl_setopt($ch, CURLOPT_HTTPHEADER, [
+                '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);
+            curl_close($ch);
+            
+            if ($response) {
+                $data = json_decode($response, true);
+                
+                if (isset($data['access_token'])) {
+                    return $data['access_token'];
+                }
+                
+                if (isset($data['error'])) {
+                    if ($data['error'] === 'authorization_pending') {
+                        // Keep waiting
+                        continue;
+                    } elseif ($data['error'] === 'slow_down') {
+                        $interval += 5; // Slow down polling
+                        continue;
+                    } elseif ($data['error'] === 'expired_token') {
+                        echo "\033[1;31m[-] The device code expired. Please run the auth command again.\033[0m" . PHP_EOL;
+                        return null;
+                    } elseif ($data['error'] === 'access_denied') {
+                        echo "\033[1;31m[-] Authorization was denied.\033[0m" . PHP_EOL;
+                        return null;
+                    } else {
+                        echo "\033[1;31m[-] An error occurred: " . $data['error'] . "\033[0m" . PHP_EOL;
+                        return null;
+                    }
+                }
+            }
+        }
+    }
+
+    private function fetchUserProfile(string $token): ?array
+    {
+        $ch = curl_init('https://api.github.com/user');
+        
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($ch, CURLOPT_HTTPHEADER, [
+            'Accept: application/vnd.github.v3+json',
+            'Authorization: Bearer ' . $token,
+            'User-Agent: ArtiFrame-CLI'
+        ]);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
+
+        $response = curl_exec($ch);
+        curl_close($ch);
+
+        if ($response) {
+            return json_decode($response, true);
+        }
+
+        return null;
+    }
+
+    private function saveConfig(string $token, string $username): void
+    {
+        $home = getenv('HOME') ?: getenv('USERPROFILE');
+        $configDir = $home . \DIRECTORY_SEPARATOR . '.artiframe';
+        
+        if (!is_dir($configDir)) {
+            mkdir($configDir, 0755, true);
+        }
+
+        $configFile = $configDir . \DIRECTORY_SEPARATOR . 'config.json';
+        
+        $config = [];
+        if (file_exists($configFile)) {
+            $existing = json_decode(file_get_contents($configFile), true);
+            if (is_array($existing)) {
+                $config = $existing;
+            }
+        }
+
+        $config['github_token'] = $token;
+        $config['github_user'] = $username;
+        $config['logged_in_at'] = date('c');
+
+        file_put_contents($configFile, json_encode($config, JSON_PRETTY_PRINT));
+    }
+
+    private function openBrowser(string $url): void
+    {
+        $os = php_uname('s');
+        $command = '';
+
+        if (stripos($os, 'win') === 0) {
+            $command = 'start "" "' . $url . '"';
+        } elseif (stripos($os, 'darwin') === 0) {
+            $command = 'open "' . $url . '"';
+        } else {
+            $command = 'xdg-open "' . $url . '"';
+        }
+
+        if ($command) {
+            // execute command silently in background
+            if (stripos($os, 'win') === 0) {
+                pclose(popen($command, "r"));
+            } else {
+                exec($command . ' > /dev/null 2>&1 &');
+            }
+        }
+    }
+}

package/src/Commands/IssuesCommand.php

@@ -0,0 +1,174 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+
+class IssuesCommand
+{
+    private Translator $translator;
+    const REPO = 'utkuthecoder/artiframe-cli';
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+    }
+
+    public function execute(array $args = []): void
+    {
+        $home = getenv('HOME') ?: getenv('USERPROFILE');
+        $configPath = $home . \DIRECTORY_SEPARATOR . '.artiframe' . \DIRECTORY_SEPARATOR . 'config.json';
+
+        if (!file_exists($configPath)) {
+            echo "\033[1;31m[-] " . $this->translator->get('SUGGEST_NOT_AUTH') . "\033[0m" . PHP_EOL;
+            echo "Run: \033[1;32martiframe auth\033[0m" . PHP_EOL;
+            return;
+        }
+
+        $config = json_decode(file_get_contents($configPath), true);
+        $token = $config['github_token'] ?? null;
+        $username = $config['github_user'] ?? null;
+
+        if (!$token || !$username) {
+            echo "\033[1;31m[-] " . $this->translator->get('SUGGEST_NOT_AUTH') . "\033[0m" . PHP_EOL;
+            echo "Run: \033[1;32martiframe auth\033[0m" . PHP_EOL;
+            return;
+        }
+
+        $issueId = $args[0] ?? null;
+
+        if ($issueId) {
+            $this->showIssueDetails($token, $username, $issueId);
+        } else {
+            $this->listIssues($token, $username);
+        }
+    }
+
+    private function listIssues(string $token, string $username): void
+    {
+        echo PHP_EOL . "\033[1;36mFetching issues for @{$username}...\033[0m" . PHP_EOL;
+
+        $url = 'https://api.github.com/repos/' . self::REPO . '/issues?creator=' . urlencode($username) . '&state=all';
+        $response = $this->githubApiRequest($url, $token);
+        
+        if (!$response) {
+            echo "\033[1;31m[-] Failed to fetch issues from GitHub.\033[0m" . PHP_EOL;
+            return;
+        }
+
+        $issues = json_decode($response, true);
+
+        if (isset($issues['message'])) {
+            echo "\033[1;31m[-] GitHub Error: " . $issues['message'] . "\033[0m" . PHP_EOL;
+            return;
+        }
+
+        if (empty($issues)) {
+            echo "\033[1;33mYou haven't opened any issues yet.\033[0m" . PHP_EOL;
+            return;
+        }
+
+        echo "\033[1;37m" . str_pad("ID", 6) . str_pad("STATUS", 10) . str_pad("COMMENTS", 10) . "TITLE\033[0m" . PHP_EOL;
+        echo str_repeat("-", 80) . PHP_EOL;
+
+        foreach ($issues as $issue) {
+            if (isset($issue['pull_request'])) {
+                continue; // Skip PRs if they show up in issue search
+            }
+            
+            $id = "#" . $issue['number'];
+            $state = $issue['state']; // open or closed
+            $comments = $issue['comments'];
+            $title = strlen($issue['title']) > 50 ? substr($issue['title'], 0, 47) . '...' : $issue['title'];
+
+            $stateColor = $state === 'open' ? "\033[1;32m" : "\033[1;31m"; // Green for open, red for closed
+            $displayState = ucfirst($state);
+
+            echo str_pad($id, 6) . 
+                 $stateColor . str_pad($displayState, 10) . "\033[0m" . 
+                 str_pad((string)$comments, 10) . 
+                 $title . PHP_EOL;
+        }
+        
+        echo PHP_EOL . "\033[38;5;240mTip: To view comments for a specific issue, run `artiframe issues <ID>`\033[0m" . PHP_EOL;
+    }
+
+    private function showIssueDetails(string $token, string $username, string $issueId): void
+    {
+        $issueId = ltrim($issueId, '#');
+        echo PHP_EOL . "\033[1;36mFetching details for Issue #{$issueId}...\033[0m" . PHP_EOL;
+
+        // Fetch Issue Details
+        $url = 'https://api.github.com/repos/' . self::REPO . '/issues/' . $issueId;
+        $response = $this->githubApiRequest($url, $token);
+        
+        if (!$response) {
+            echo "\033[1;31m[-] Failed to fetch issue details.\033[0m" . PHP_EOL;
+            return;
+        }
+
+        $issue = json_decode($response, true);
+
+        if (isset($issue['message'])) {
+            echo "\033[1;31m[-] GitHub Error: " . $issue['message'] . "\033[0m" . PHP_EOL;
+            return;
+        }
+
+        $stateColor = $issue['state'] === 'open' ? "\033[1;32m" : "\033[1;31m";
+        
+        echo PHP_EOL;
+        echo "\033[1;37m[" . $issue['state'] . "] " . $issue['title'] . "\033[0m" . PHP_EOL;
+        echo "\033[38;5;240mOpened by @" . $issue['user']['login'] . " at " . date('Y-m-d H:i', strtotime($issue['created_at'])) . "\033[0m" . PHP_EOL;
+        echo str_repeat("=", 80) . PHP_EOL;
+        echo $this->wordWrapWithIndentation($issue['body']) . PHP_EOL;
+        echo str_repeat("=", 80) . PHP_EOL;
+
+        if ($issue['comments'] > 0) {
+            echo PHP_EOL . "\033[1;36mComments ({$issue['comments']}):\033[0m" . PHP_EOL;
+            
+            $commentsUrl = $issue['comments_url'];
+            $commentsResponse = $this->githubApiRequest($commentsUrl, $token);
+            $comments = json_decode($commentsResponse, true);
+            
+            if (is_array($comments)) {
+                foreach ($comments as $comment) {
+                    echo PHP_EOL;
+                    echo "\033[1;34m@" . $comment['user']['login'] . "\033[0m \033[38;5;240m(" . date('Y-m-d H:i', strtotime($comment['created_at'])) . "):\033[0m" . PHP_EOL;
+                    echo str_repeat("-", 80) . PHP_EOL;
+                    echo $this->wordWrapWithIndentation($comment['body']) . PHP_EOL;
+                    echo str_repeat("-", 80) . PHP_EOL;
+                }
+            }
+        } else {
+            echo PHP_EOL . "\033[38;5;240mNo comments on this issue yet.\033[0m" . PHP_EOL;
+        }
+        echo PHP_EOL;
+    }
+
+    private function githubApiRequest(string $url, string $token): ?string
+    {
+        $ch = curl_init($url);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($ch, CURLOPT_HTTPHEADER, [
+            'Accept: application/vnd.github.v3+json',
+            'Authorization: Bearer ' . $token,
+            'User-Agent: ArtiFrame-CLI'
+        ]);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
+
+        $response = curl_exec($ch);
+        curl_close($ch);
+
+        return $response ?: null;
+    }
+
+    private function wordWrapWithIndentation(string $text, int $width = 80): string
+    {
+        $lines = explode("\n", $text);
+        $wrapped = [];
+        foreach ($lines as $line) {
+            $wrapped[] = wordwrap(trim($line), $width, "\n");
+        }
+        return implode("\n", $wrapped);
+    }
+}

package/src/Commands/ListCommand.php

@@ -14,7 +14,8 @@ class ListCommand
 
     public function execute(array $args): void
     {
-        $dir = getcwd();
+        $safeguard = new \ArtiFrame\Cli\Services\Safeguard($this->translator);
+        $dir = $safeguard->getProjectRoot();
         $projectName = basename($dir);
         
         echo "

package/src/Commands/MakeApiCommand.php

@@ -38,7 +38,7 @@ class MakeApiCommand
             $target .= '.php';
         }
 
-        $projectRoot = getcwd();
+        $projectRoot = $this->safeguard->getProjectRoot();
         $apiPath     = $projectRoot . '/public/api/' . $type . '/' . $target;
 
         if (!$this->safeguard->checkTarget($apiPath)) {

package/src/Commands/MakeClassCommand.php

@@ -35,7 +35,7 @@ class MakeClassCommand
             $target .= '.php';
         }
 
-        $projectRoot = getcwd();
+        $projectRoot = $this->safeguard->getProjectRoot();
         $classPath   = $projectRoot . '/' . $target;
 
         if (!$this->safeguard->checkTarget($classPath)) {

package/src/Commands/MakeViewCommand.php

@@ -32,7 +32,7 @@ class MakeViewCommand
             $target .= '.php';
         }
 
-        $projectRoot = getcwd();
+        $projectRoot = $this->safeguard->getProjectRoot();
         $viewPath = $projectRoot . '/public/' . $target;
 
         if (!$this->safeguard->checkTarget($viewPath)) {

package/src/Commands/NewProjectCommand.php

@@ -425,7 +425,11 @@ class NewProjectCommand
       "Bin\\\\": "bin/",
       "App\\\\": "app/",
       "Src\\\\": "src/"
-    }
+    },
+    "files": [
+      "bin/ViewMethod.php",
+      "bin/SystemMethod.php"
+    ]
   },
   "authors": [
     {
@@ -469,6 +473,7 @@ JSON;
             "# Uygulama",
             "APP_NAME=ArtiFrame",
             "APP_URL=http://localhost",
+            "APP_MAINTENANCE=false",
             "",
             "# Veritabanı (MySQL / MariaDB)",
             "DB_HOST=localhost",
@@ -476,22 +481,7 @@ JSON;
             "DB_PASS=",
             "DB_NAME=artiframe",
             "",
-            "# SMTP (PHPMailer)",
-            "MAIL_HOST=smtp.example.com",
-            "MAIL_PORT=587",
-            "MAIL_USERNAME=",
-            "MAIL_PASSWORD=",
-            "MAIL_FROM_ADDRESS=noreply@example.com",
-            "MAIL_FROM_NAME=ArtiFrame",
-            "MAIL_ENCRYPTION=tls",
-            "",
-            "# Cloudflare R2 (AWS S3 Uyumlu Depolama)",
-            "R2_ACCOUNT_ID=",
-            "R2_ACCESS_KEY=",
-            "R2_SECRET_KEY=",
-            "R2_BUCKET_NAME=",
-            "R2_PUBLIC_URL=",
-            "",
+
             "# Redis",
             "REDIS_HOST=127.0.0.1",
             "REDIS_PORT=6379",
@@ -645,14 +635,14 @@ REDISPHP;
         // public/index.php — localized welcome page
         $lang    = $this->translator->getLang();
         $docFile = [
-            'tr' => ['file' => 'kilavuz.html',  'installed' => 'Projeniz Başarıyla Oluşturuldu!',      'guide' => 'İlk adımlar için kılavuzu inceleyebilirsiniz:'],
-            'en' => ['file' => 'guide.html',     'installed' => 'Project Created Successfully!',        'guide' => 'Check out the guide for the first steps:'],
-            'de' => ['file' => 'handbuch.html',  'installed' => 'Projekt Erfolgreich Erstellt!',        'guide' => 'Für die ersten Schritte sehen Sie im Handbuch nach:'],
-            'fr' => ['file' => 'guide_fr.html',  'installed' => 'Projet Créé avec Succès !',            'guide' => 'Consultez le guide pour les premières étapes :'],
-            'es' => ['file' => 'guia.html',       'installed' => '¡Proyecto Creado Exitosamente!',      'guide' => 'Consulta la guía para los primeros pasos:'],
-        ][$lang] ?? ['file' => 'guide.html', 'installed' => 'ArtiFrame Installed Successfully!', 'guide' => 'To get started, see'];
-
-        $indexContent = "<?php\nrequire_once __DIR__ . '/../app/ViewControl.php';\n"
+            'tr' => ['file' => 'kilavuz.html',  'installed' => 'Projeniz Başarıyla Oluşturuldu!',      'guide' => 'İlk adımlar için kılavuzu inceleyebilirsiniz:', 'note' => '💡 <b>Not:</b> Eğer anasayfa (landing.php) ismini değiştirmek isterseniz, <code>bin/ViewMethod.php</code> içindeki <code>routeLink()</code> metodunda bulunan varsayılan sayfa adını da güncellemelisiniz.'],
+            'en' => ['file' => 'guide.html',     'installed' => 'Project Created Successfully!',        'guide' => 'Check out the guide for the first steps:', 'note' => '💡 <b>Note:</b> If you want to change the homepage (landing.php) filename, you must also update the default page name in the <code>routeLink()</code> method inside <code>bin/ViewMethod.php</code>.'],
+            'de' => ['file' => 'handbuch.html',  'installed' => 'Projekt Erfolgreich Erstellt!',        'guide' => 'Für die ersten Schritte sehen Sie im Handbuch nach:', 'note' => '💡 <b>Hinweis:</b> Wenn Sie den Dateinamen der Startseite (landing.php) ändern möchten, müssen Sie auch den Standardseitennamen in der Methode <code>routeLink()</code> in <code>bin/ViewMethod.php</code> aktualisieren.'],
+            'fr' => ['file' => 'guide_fr.html',  'installed' => 'Projet Créé avec Succès !',            'guide' => 'Consultez le guide pour les premières étapes :', 'note' => '💡 <b>Remarque :</b> Si vous souhaitez modifier le nom de fichier de la page d\'accueil (landing.php), vous devez également mettre à jour le nom de page par défaut dans la méthode <code>routeLink()</code> dans <code>bin/ViewMethod.php</code>.'],
+            'es' => ['file' => 'guia.html',       'installed' => '¡Proyecto Creado Exitosamente!',      'guide' => 'Consulta la guía para los primeros pasos:', 'note' => '💡 <b>Nota:</b> Si desea cambiar el nombre del archivo de la página de inicio (landing.php), también debe actualizar el nombre de la página predeterminada en el método <code>routeLink()</code> dentro de <code>bin/ViewMethod.php</code>.'],
+        ][$lang] ?? ['file' => 'guide.html', 'installed' => 'ArtiFrame Installed Successfully!', 'guide' => 'To get started, see', 'note' => '💡 <b>Note:</b> If you want to change the homepage (landing.php) filename, you must also update the default page name in the <code>routeLink()</code> method inside <code>bin/ViewMethod.php</code>.'];
+
+        $landingContent = "<?php\n"
             . "if (isset(\$_GET['guide'])) {\n"
             . "    header('Content-Type: text/html; charset=utf-8');\n"
             . "    readfile(__DIR__ . '/../{$docFile['file']}');\n"
@@ -696,6 +686,12 @@ REDISPHP;
             . "            transition: all 0.3s ease; box-shadow: 0 4px 14px 0 rgba(9, 151, 114, 0.39);\n"
             . "        }\n"
             . "        .btn:hover { transform: translateY(-2px); box-shadow: 0 6px 20px rgba(9, 151, 114, 0.45); }\n"
+            . "        .note {\n"
+            . "            font-size: 0.85rem; color: #6b7280; margin-top: 2rem;\n"
+            . "            background: rgba(255,255,255,0.5); padding: 1rem; border-radius: 0.75rem;\n"
+            . "            border: 1px solid rgba(0,0,0,0.05); text-align: left; line-height: 1.5;\n"
+            . "        }\n"
+            . "        .note code { background: rgba(0,0,0,0.05); padding: 0.2rem 0.4rem; border-radius: 4px; font-family: monospace; }\n"
             . "        .footer {\n"
             . "            display: flex; align-items: center; gap: 0.5rem;\n"
             . "            color: #6b7280; font-size: 0.875rem; font-weight: 500;\n"
@@ -714,6 +710,7 @@ REDISPHP;
             . "        <h1>{$docFile['installed']}</h1>\n"
             . "        <p>{$docFile['guide']}</p>\n"
             . "        <a href=\"?guide\" class=\"btn\">{$docFile['file']}</a>\n"
+            . "        <div class=\"note\">{$docFile['note']}</div>\n"
             . "    </div>\n"
             . "    <div class=\"footer\">\n"
             . "        <span>Powered by</span>\n"
@@ -723,9 +720,24 @@ REDISPHP;
             . "    </div>\n"
             . "</body>\n"
             . "</html>\n";
+        file_put_contents($targetDir . '/public/landing.php', $landingContent);
+        $this->tick('public/landing.php');
+
+        // public/index.php - router
+        $indexContent = "<?php\n\nrequire_once __DIR__ . '/../vendor/autoload.php';\n\nrouteLink();\n";
         file_put_contents($targetDir . '/public/index.php', $indexContent);
         $this->tick('public/index.php');
 
+        // public/404.php
+        $error404Content = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n    <meta charset=\"UTF-8\">\n    <title>404 Not Found</title>\n    <style>body{font-family:sans-serif;display:flex;justify-content:center;align-items:center;height:100vh;background:#f3f4f6;color:#374151;text-align:center;} h1{font-size:3rem;margin-bottom:0;} p{font-size:1.2rem;color:#6b7280;}</style>\n</head>\n<body>\n    <div>\n        <h1>404</h1>\n        <p>Page Not Found</p>\n    </div>\n</body>\n</html>\n";
+        file_put_contents($targetDir . '/public/404.php', $error404Content);
+        $this->tick('public/404.php');
+
+        // public/503.php
+        $error503Content = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n    <meta charset=\"UTF-8\">\n    <title>503 Service Unavailable</title>\n    <style>body{font-family:sans-serif;display:flex;justify-content:center;align-items:center;height:100vh;background:#f3f4f6;color:#374151;text-align:center;} h1{font-size:3rem;margin-bottom:0;} p{font-size:1.2rem;color:#6b7280;}</style>\n</head>\n<body>\n    <div>\n        <h1>503</h1>\n        <p>Service Unavailable / Maintenance Mode</p>\n    </div>\n</body>\n</html>\n";
+        file_put_contents($targetDir . '/public/503.php', $error503Content);
+        $this->tick('public/503.php');
+
         // public/.htaccess
         $htaccessContent = <<<HTACCESS
 RewriteEngine On