@artilingo/artiframe-cli 1.0.0

package/src/Commands/VersionCommand.php

@@ -0,0 +1,92 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+
+class VersionCommand
+{
+    private Translator $translator;
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+    }
+
+    public function execute(array $args): void
+    {
+        $action = $args[0] ?? null; // upgrade or downgrade
+        $level  = $args[1] ?? null; // major, minor, or patch
+
+        if (!$action || !in_array($action, ['upgrade', 'downgrade'])) {
+            echo "❌ " . $this->translator->get('ERROR_VERSION_ACTION') . PHP_EOL;
+            exit(1);
+        }
+
+        if (!$level || !in_array($level, ['major', 'minor', 'patch'])) {
+            echo "❌ " . $this->translator->get('ERROR_VERSION_LEVEL') . PHP_EOL;
+            exit(1);
+        }
+
+        $projectRoot = getcwd();
+        $versionFile = $projectRoot . '/config/app-version.php';
+
+        if (!file_exists($versionFile)) {
+            echo "❌ " . $this->translator->get('ERROR_VERSION_FILE', ['path' => $versionFile]) . PHP_EOL;
+            exit(1);
+        }
+
+        $content = file_get_contents($versionFile);
+
+        // Match define('APP_VERSION', 'x.y.z');
+        if (!preg_match('/define\(\'APP_VERSION\',\s*\'(\d+)\.(\d+)\.(\d+)\'\);/', $content, $matches)) {
+            echo "❌ " . $this->translator->get('ERROR_VERSION_PARSE') . PHP_EOL;
+            exit(1);
+        }
+
+        $major      = (int)$matches[1];
+        $minor      = (int)$matches[2];
+        $patch      = (int)$matches[3];
+        $oldVersion = "{$major}.{$minor}.{$patch}";
+
+        if ($action === 'upgrade') {
+            if ($level === 'major') {
+                $major++;
+                $minor = 0;
+                $patch = 0;
+            } elseif ($level === 'minor') {
+                $minor++;
+                $patch = 0;
+            } elseif ($level === 'patch') {
+                $patch++;
+            }
+        } else { // downgrade
+            if ($level === 'major') {
+                $major = max(1, $major - 1);
+                $minor = 0;
+                $patch = 0;
+            } elseif ($level === 'minor') {
+                $minor = max(0, $minor - 1);
+                $patch = 0;
+            } elseif ($level === 'patch') {
+                $patch = max(0, $patch - 1);
+            }
+        }
+
+        $newVersion = "{$major}.{$minor}.{$patch}";
+
+        if ($oldVersion === $newVersion) {
+            echo $this->translator->get('WARN_VERSION_UNCHANGED', ['version' => $newVersion]) . PHP_EOL;
+            return;
+        }
+
+        $newContent = preg_replace(
+            '/define\(\'APP_VERSION\',\s*\'\d+\.\d+\.\d+\'\);/',
+            "define('APP_VERSION', '{$newVersion}');",
+            $content
+        );
+
+        file_put_contents($versionFile, $newContent);
+
+        echo $this->translator->get('SUCCESS_VERSION', ['old' => $oldVersion, 'new' => $newVersion]) . PHP_EOL;
+    }
+}

package/src/Lang/de.php

@@ -0,0 +1,53 @@
+<?php
+return [
+    'WELCOME'              => 'Willkommen beim ArtiFrame CLI!',
+    'CORE_WARNING_TITLE'   => 'ArtiFrame Kern-Warnung!',
+    'CORE_WARNING_BODY'    => 'Achtung! Dieses Verzeichnis und diese Dateien enthalten die Kernarchitektur von ArtiFrame.' . PHP_EOL . 'Änderungen hier können das gesamte System, die Sicherheitsschichten' . PHP_EOL . 'und API-Abhängigkeiten global betreffen.' . PHP_EOL . 'Sofern Sie kein spezielles Kernverhalten konfigurieren oder einen Framework-Patch entwickeln,' . PHP_EOL . 'wird empfohlen, diese Dateien nicht zu ändern.',
+    'CONFIRM_PROMPT'       => 'Akzeptieren Sie? [j/N]: ',
+    'ABORTED'              => 'Vorgang vom Benutzer abgebrochen.',
+    'DIR_REQUIRED_ERROR'   => 'Fehler: Zielverzeichnis für die Klasse muss angegeben werden! (z.B. /app oder /src)',
+    'COMPOSER_MISSING_TITLE' => 'Composer nicht gefunden!',
+    'COMPOSER_MISSING_BODY'  => "ArtiFrame erfordert Composer (PHP-Paketmanager), um Projekte zu erstellen.\n\nInstallation:\n- Windows: Laden Sie https://getcomposer.org/Composer-Setup.exe herunter\n- macOS: Führen Sie 'brew install composer' aus\n- Linux: Führen Sie 'sudo apt install composer' aus\n\nBitte starten Sie Ihr Terminal nach der Installation neu. No composer, no project!",
+    'INSTALL_SUCCESS'      => '[ERFOLG] Installation abgeschlossen. Bitte starten Sie Ihr Terminal neu, um die neuen Umgebungsvariablen anzuwenden.',
+
+    // NewProjectCommand
+    'PROJECT_BUILDER_TITLE' => '🚀  ArtiFrame Projekt-Builder',
+    'PROJECT_LABEL'         => '📁 Projekt',
+    'LOCATION_LABEL'        => '📍 Pfad',
+    'PHASE_COPYING'         => 'Kern-Templates werden kopiert...',
+    'PHASE_DIRS'            => 'Modul-Verzeichnisse werden erstellt...',
+    'PHASE_FILES'           => 'Projektdateien werden generiert...',
+    'PHASE_DEPS'            => 'Abhängigkeiten werden installiert...',
+    'PHASE_HEADER'          => 'Phase :current/:total —',
+    'FILES_TO_PROCESS'      => ':count Dateien werden verarbeitet',
+    'SUCCESS_TITLE'         => '✅  Projekt erfolgreich erstellt!',
+    'NEXT_STEPS'            => '🎯 Erste Schritte:',
+    'NEXT_STEPS_EDIT_ENV'   => '.env-Datei bearbeiten und mit der Entwicklung beginnen!',
+    'DIR_ITEM_COUNT'        => '(:count Elemente)',
+
+    // MakeViewCommand
+    'ERROR_VIEW_PATH_REQUIRED' => 'Fehler: View-Pfad ist erforderlich (z.B. dashboard.php oder /admin/benutzer/liste.php)',
+    'ERROR_STUB_NOT_FOUND'     => 'Fehler: Stub-Datei nicht gefunden: :path',
+    'ERROR_RUN_FROM_ROOT'      => 'Stellen Sie sicher, dass Sie diesen Befehl vom Stammverzeichnis eines ArtiFrame-Projekts ausführen.',
+    'SUCCESS_VIEW'             => '✅ View erstellt: /public/:path',
+    'SUCCESS_CSS'              => '✅ CSS erstellt: /public:path',
+    'SUCCESS_JS'               => '✅ JS erstellt:  /public:path',
+
+    // MakeApiCommand
+    'ERROR_API_TYPE'           => "Fehler: API-Typ muss 'standart' oder 'switch-case' sein.",
+    'ERROR_API_PATH_REQUIRED'  => 'Fehler: Zielpfad ist erforderlich (z.B. /v1/auth/login.php).',
+    'SUCCESS_API'              => '✅ API-Endpunkt erstellt: /public/api/:type/:path',
+
+    // MakeClassCommand
+    'ERROR_CLASS_ROOT'         => 'Fehler: Ziel muss innerhalb der /app/- oder /src/-Verzeichnisse liegen.',
+    'SUCCESS_CLASS'            => '✅ Klasse erstellt: /:path',
+    'NAMESPACE_LABEL'          => '   Namespace:',
+
+    // VersionCommand
+    'ERROR_VERSION_ACTION'     => "Fehler: Aktion muss 'upgrade' oder 'downgrade' sein.",
+    'ERROR_VERSION_LEVEL'      => "Fehler: Ebene muss 'major', 'minor' oder 'patch' sein.",
+    'ERROR_VERSION_FILE'       => 'Fehler: app-version.php nicht gefunden: :path',
+    'ERROR_VERSION_PARSE'      => 'Fehler: APP_VERSION in app-version.php konnte nicht gelesen werden.',
+    'WARN_VERSION_UNCHANGED'   => '⚠️  Warnung: Version ist bereits am Minimum (:version) oder hat sich nicht geändert.',
+    'SUCCESS_VERSION'          => '✅ Version aktualisiert: :old → :new',
+];

package/src/Lang/en.php

@@ -0,0 +1,53 @@
+<?php
+return [
+    'WELCOME'              => 'Welcome to ArtiFrame CLI!',
+    'CORE_WARNING_TITLE'   => 'ArtiFrame Core Warning!',
+    'CORE_WARNING_BODY'    => "Warning! This directory and files contain ArtiFrame's core architecture.\nChanges here will globally affect the application's overall functionality, security layers, and API dependencies.\nUnless you are implementing custom core behavior or developing a framework patch, it is recommended not to modify files in this directory.",
+    'CONFIRM_PROMPT'       => 'Do you approve? [y/N]: ',
+    'ABORTED'              => 'Operation aborted by user.',
+    'DIR_REQUIRED_ERROR'   => 'Error: Target class directory must be specified! (e.g. /app or /src)',
+    'COMPOSER_MISSING_TITLE' => 'Composer Not Found!',
+    'COMPOSER_MISSING_BODY'  => "ArtiFrame requires Composer (PHP package manager) to build projects.\n\nHow to Install:\n- Windows: Download from https://getcomposer.org/Composer-Setup.exe\n- macOS: Run 'brew install composer'\n- Linux: Run 'sudo apt install composer' or check official docs.\n\nPlease restart your terminal after installation. No composer, no project!",
+    'INSTALL_SUCCESS'      => '[SUCCESS] Installation complete. Please restart your terminal to apply the new environment variables.',
+
+    // NewProjectCommand
+    'PROJECT_BUILDER_TITLE' => '🚀  ArtiFrame Project Builder',
+    'PROJECT_LABEL'         => '📁 Project',
+    'LOCATION_LABEL'        => '📍 Location',
+    'PHASE_COPYING'         => 'Copying core templates...',
+    'PHASE_DIRS'            => 'Creating module directories...',
+    'PHASE_FILES'           => 'Generating project files...',
+    'PHASE_DEPS'            => 'Installing dependencies...',
+    'PHASE_HEADER'          => 'Phase :current/:total —',
+    'FILES_TO_PROCESS'      => ':count files to process',
+    'SUCCESS_TITLE'         => '✅  Project created successfully!',
+    'NEXT_STEPS'            => '🎯 Get started:',
+    'NEXT_STEPS_EDIT_ENV'   => 'Edit your .env file and start building!',
+    'DIR_ITEM_COUNT'        => '(:count items)',
+
+    // MakeViewCommand
+    'ERROR_VIEW_PATH_REQUIRED' => 'Error: View path is required (e.g., dashboard.php or /admin/users/list.php)',
+    'ERROR_STUB_NOT_FOUND'     => 'Error: Stub file not found at: :path',
+    'ERROR_RUN_FROM_ROOT'      => 'Make sure you are running this command from the root of an ArtiFrame project.',
+    'SUCCESS_VIEW'             => '✅ View generated: /public/:path',
+    'SUCCESS_CSS'              => '✅ CSS generated: /public:path',
+    'SUCCESS_JS'               => '✅ JS generated:  /public:path',
+
+    // MakeApiCommand
+    'ERROR_API_TYPE'           => "Error: API type must be 'standart' or 'switch-case'.",
+    'ERROR_API_PATH_REQUIRED'  => 'Error: Target path is required (e.g., /v1/auth/login.php).',
+    'SUCCESS_API'              => '✅ API Endpoint generated: /public/api/:type/:path',
+
+    // MakeClassCommand
+    'ERROR_CLASS_ROOT'         => 'Error: Target must be inside /app/ or /src/ directories.',
+    'SUCCESS_CLASS'            => '✅ Class generated: /:path',
+    'NAMESPACE_LABEL'          => '   Namespace:',
+
+    // VersionCommand
+    'ERROR_VERSION_ACTION'     => "Error: Action must be 'upgrade' or 'downgrade'.",
+    'ERROR_VERSION_LEVEL'      => "Error: Level must be 'major', 'minor', or 'patch'.",
+    'ERROR_VERSION_FILE'       => 'Error: app-version.php not found at: :path',
+    'ERROR_VERSION_PARSE'      => 'Error: Could not parse APP_VERSION in app-version.php.',
+    'WARN_VERSION_UNCHANGED'   => '⚠️  Warning: Version is already at minimum (:version) or did not change.',
+    'SUCCESS_VERSION'          => '✅ Version updated: :old → :new',
+];

package/src/Lang/es.php

@@ -0,0 +1,53 @@
+<?php
+return [
+    'WELCOME'              => '¡Bienvenido a ArtiFrame CLI!',
+    'CORE_WARNING_TITLE'   => '¡Advertencia del Núcleo ArtiFrame!',
+    'CORE_WARNING_BODY'    => "¡Atención! Este directorio y estos archivos contienen la arquitectura central de ArtiFrame.\nLos cambios aquí afectarán globalmente la funcionalidad de la aplicación, las capas de seguridad y las dependencias de la API.\nA menos que esté implementando un comportamiento central personalizado o desarrollando un parche de framework, se recomienda no modificar archivos en este directorio.",
+    'CONFIRM_PROMPT'       => '¿Aprueba esta acción? [s/N]: ',
+    'ABORTED'              => 'Operación cancelada por el usuario.',
+    'DIR_REQUIRED_ERROR'   => 'Error: ¡Debe especificar el directorio de la clase! (ej. /app o /src)',
+    'COMPOSER_MISSING_TITLE' => '¡Composer no encontrado!',
+    'COMPOSER_MISSING_BODY'  => "ArtiFrame requiere Composer (gestor de paquetes PHP) para crear proyectos.\n\nInstalación:\n- Windows: Descargue https://getcomposer.org/Composer-Setup.exe\n- macOS: Ejecute 'brew install composer'\n- Linux: Ejecute 'sudo apt install composer'\n\nPor favor, reinicie su terminal después de la instalación. ¡No composer, no project!",
+    'INSTALL_SUCCESS'      => '[ÉXITO] Instalación completada. Por favor, reinicie su terminal para aplicar las nuevas variables de entorno.',
+
+    // NewProjectCommand
+    'PROJECT_BUILDER_TITLE' => '🚀  Generador de Proyectos ArtiFrame',
+    'PROJECT_LABEL'         => '📁 Proyecto',
+    'LOCATION_LABEL'        => '📍 Ubicación',
+    'PHASE_COPYING'         => 'Copiando plantillas del núcleo...',
+    'PHASE_DIRS'            => 'Creando directorios de módulos...',
+    'PHASE_FILES'           => 'Generando archivos del proyecto...',
+    'PHASE_DEPS'            => 'Instalando dependencias...',
+    'PHASE_HEADER'          => 'Fase :current/:total —',
+    'FILES_TO_PROCESS'      => ':count archivos a procesar',
+    'SUCCESS_TITLE'         => '✅  ¡Proyecto creado exitosamente!',
+    'NEXT_STEPS'            => '🎯 Para comenzar:',
+    'NEXT_STEPS_EDIT_ENV'   => '¡Edite su archivo .env y comience a desarrollar!',
+    'DIR_ITEM_COUNT'        => '(:count elementos)',
+
+    // MakeViewCommand
+    'ERROR_VIEW_PATH_REQUIRED' => 'Error: Se requiere la ruta de la vista (ej. dashboard.php o /admin/usuarios/lista.php)',
+    'ERROR_STUB_NOT_FOUND'     => 'Error: Archivo stub no encontrado: :path',
+    'ERROR_RUN_FROM_ROOT'      => 'Asegúrese de ejecutar este comando desde la raíz de un proyecto ArtiFrame.',
+    'SUCCESS_VIEW'             => '✅ Vista generada: /public/:path',
+    'SUCCESS_CSS'              => '✅ CSS generado: /public:path',
+    'SUCCESS_JS'               => '✅ JS generado:  /public:path',
+
+    // MakeApiCommand
+    'ERROR_API_TYPE'           => "Error: El tipo de API debe ser 'standart' o 'switch-case'.",
+    'ERROR_API_PATH_REQUIRED'  => 'Error: Se requiere la ruta de destino (ej. /v1/auth/login.php).',
+    'SUCCESS_API'              => '✅ Endpoint API generado: /public/api/:type/:path',
+
+    // MakeClassCommand
+    'ERROR_CLASS_ROOT'         => 'Error: El destino debe estar dentro de los directorios /app/ o /src/.',
+    'SUCCESS_CLASS'            => '✅ Clase generada: /:path',
+    'NAMESPACE_LABEL'          => '   Espacio de nombres (Namespace):',
+
+    // VersionCommand
+    'ERROR_VERSION_ACTION'     => "Error: La acción debe ser 'upgrade' o 'downgrade'.",
+    'ERROR_VERSION_LEVEL'      => "Error: El nivel debe ser 'major', 'minor' o 'patch'.",
+    'ERROR_VERSION_FILE'       => 'Error: app-version.php no encontrado: :path',
+    'ERROR_VERSION_PARSE'      => 'Error: No se pudo leer APP_VERSION en app-version.php.',
+    'WARN_VERSION_UNCHANGED'   => '⚠️  Advertencia: La versión ya está en el mínimo (:version) o no cambió.',
+    'SUCCESS_VERSION'          => '✅ Versión actualizada: :old → :new',
+];

package/src/Lang/fr.php

@@ -0,0 +1,53 @@
+<?php
+return [
+    'WELCOME'              => 'Bienvenue dans la CLI ArtiFrame !',
+    'CORE_WARNING_TITLE'   => 'Avertissement du Noyau ArtiFrame !',
+    'CORE_WARNING_BODY'    => 'Attention ! Ce répertoire et ces fichiers contiennent l\'architecture centrale d\'ArtiFrame.' . PHP_EOL . 'Les modifications apportées ici affecteront globalement le fonctionnement de l\'application,' . PHP_EOL . 'les couches de sécurité et les dépendances de l\'API.' . PHP_EOL . 'À moins que vous ne configuriez un comportement personnalisé ou un correctif de framework,' . PHP_EOL . 'il est recommandé de ne pas modifier les fichiers de ce répertoire.',
+    'CONFIRM_PROMPT'       => 'Approuvez-vous ? [o/N] : ',
+    'ABORTED'              => 'Opération annulée par l\'utilisateur.',
+    'DIR_REQUIRED_ERROR'   => 'Erreur : Le répertoire de destination de la classe doit être spécifié ! (ex. /app ou /src)',
+    'COMPOSER_MISSING_TITLE' => 'Composer introuvable !',
+    'COMPOSER_MISSING_BODY'  => 'ArtiFrame nécessite Composer (gestionnaire de paquets PHP) pour créer des projets.' . PHP_EOL . PHP_EOL . 'Installation :' . PHP_EOL . '- Windows : Téléchargez https://getcomposer.org/Composer-Setup.exe' . PHP_EOL . '- macOS : Exécutez \'brew install composer\'' . PHP_EOL . '- Linux : Exécutez \'sudo apt install composer\'' . PHP_EOL . PHP_EOL . 'Veuillez redémarrer votre terminal après l\'installation. No composer, no project !',
+    'INSTALL_SUCCESS'      => '[SUCCÈS] Installation terminée. Veuillez redémarrer votre terminal pour appliquer les nouvelles variables d\'environnement.',
+
+    // NewProjectCommand
+    'PROJECT_BUILDER_TITLE' => '🚀  Générateur de Projet ArtiFrame',
+    'PROJECT_LABEL'         => '📁 Projet',
+    'LOCATION_LABEL'        => '📍 Emplacement',
+    'PHASE_COPYING'         => 'Copie des modèles de base...',
+    'PHASE_DIRS'            => 'Création des répertoires de modules...',
+    'PHASE_FILES'           => 'Génération des fichiers du projet...',
+    'PHASE_DEPS'            => 'Installation des dépendances...',
+    'PHASE_HEADER'          => 'Phase :current/:total —',
+    'FILES_TO_PROCESS'      => ':count fichiers à traiter',
+    'SUCCESS_TITLE'         => '✅  Projet créé avec succès !',
+    'NEXT_STEPS'            => '🎯 Pour commencer :',
+    'NEXT_STEPS_EDIT_ENV'   => 'Modifiez votre fichier .env et commencez à développer !',
+    'DIR_ITEM_COUNT'        => '(:count éléments)',
+
+    // MakeViewCommand
+    'ERROR_VIEW_PATH_REQUIRED' => 'Erreur : Le chemin de la vue est requis (ex. dashboard.php ou /admin/utilisateurs/liste.php)',
+    'ERROR_STUB_NOT_FOUND'     => 'Erreur : Fichier stub introuvable : :path',
+    'ERROR_RUN_FROM_ROOT'      => 'Assurez-vous d\'exécuter cette commande depuis la racine d\'un projet ArtiFrame.',
+    'SUCCESS_VIEW'             => '✅ Vue créée : /public/:path',
+    'SUCCESS_CSS'              => '✅ CSS créé : /public:path',
+    'SUCCESS_JS'               => '✅ JS créé :  /public:path',
+
+    // MakeApiCommand
+    'ERROR_API_TYPE'           => "Erreur : Le type d'API doit être 'standart' ou 'switch-case'.",
+    'ERROR_API_PATH_REQUIRED'  => 'Erreur : Le chemin cible est requis (ex. /v1/auth/connexion.php).',
+    'SUCCESS_API'              => '✅ Point de terminaison API créé : /public/api/:type/:path',
+
+    // MakeClassCommand
+    'ERROR_CLASS_ROOT'         => 'Erreur : La cible doit se trouver dans les répertoires /app/ ou /src/.',
+    'SUCCESS_CLASS'            => '✅ Classe créée : /:path',
+    'NAMESPACE_LABEL'          => '   Espace de noms (Namespace) :',
+
+    // VersionCommand
+    'ERROR_VERSION_ACTION'     => "Erreur : L'action doit être 'upgrade' ou 'downgrade'.",
+    'ERROR_VERSION_LEVEL'      => "Erreur : Le niveau doit être 'major', 'minor' ou 'patch'.",
+    'ERROR_VERSION_FILE'       => 'Erreur : app-version.php introuvable : :path',
+    'ERROR_VERSION_PARSE'      => 'Erreur : Impossible de lire APP_VERSION dans app-version.php.',
+    'WARN_VERSION_UNCHANGED'   => '⚠️  Avertissement : La version est déjà au minimum (:version) ou n\'a pas changé.',
+    'SUCCESS_VERSION'          => '✅ Version mise à jour : :old → :new',
+];

package/src/Lang/tr.php

@@ -0,0 +1,53 @@
+<?php
+return [
+    'WELCOME'              => 'ArtiFrame CLI aracına hoş geldiniz!',
+    'CORE_WARNING_TITLE'   => 'ArtiFrame Çekirdek Uyarısı!',
+    'CORE_WARNING_BODY'    => 'Dikkat! Bu dizin ve dosyalar ArtiFrame\'in çekirdek mimarisini barındırır.' . PHP_EOL . 'Burada yapacağınız değişiklikler uygulamanın tüm genel işleyişini,' . PHP_EOL . 'güvenlik katmanlarını ve API bağımlılıklarını küresel (global) olarak etkileyecektir.' . PHP_EOL . 'Özel bir çekirdek davranışı kurgulamıyor veya bir framework yaması (patch)' . PHP_EOL . 'geliştirmiyorsanız bu dizin üzerindeki dosyaları değiştirmemeniz önerilir.',
+    'CONFIRM_PROMPT'       => 'Onaylıyor musunuz? [e/H]: ',
+    'ABORTED'              => 'İşlem kullanıcı tarafından iptal edildi.',
+    'DIR_REQUIRED_ERROR'   => 'Hata: Sınıfın oluşturulacağı dizin belirtilmeli! (örn: /app veya /src)',
+    'COMPOSER_MISSING_TITLE' => 'Composer Bulunamadı!',
+    'COMPOSER_MISSING_BODY'  => 'ArtiFrame projeleri çalışabilmek için PHP paket yöneticisi olan Composer\'a ihtiyaç duyar.' . PHP_EOL . PHP_EOL . 'Nasıl Kurulur?' . PHP_EOL . '- Windows: https://getcomposer.org/Composer-Setup.exe adresinden indirip kurun.' . PHP_EOL . '- macOS: \'brew install composer\' komutunu kullanın.' . PHP_EOL . '- Linux: \'sudo apt install composer\' veya resmi dokümantasyonu takip edin.' . PHP_EOL . PHP_EOL . 'Kurulumdan sonra terminali yeniden başlatmayı unutmayın. No composer, no project!',
+    'INSTALL_SUCCESS'      => '[BAŞARILI] Kurulum tamamlandı. Komutların aktif olması için lütfen terminalinizi yeniden başlatın.',
+
+    // NewProjectCommand
+    'PROJECT_BUILDER_TITLE' => '🚀  ArtiFrame Proje Oluşturucu',
+    'PROJECT_LABEL'         => '📁 Proje',
+    'LOCATION_LABEL'        => '📍 Konum',
+    'PHASE_COPYING'         => 'Çekirdek şablonlar kopyalanıyor...',
+    'PHASE_DIRS'            => 'Modül dizinleri oluşturuluyor...',
+    'PHASE_FILES'           => 'Proje dosyaları oluşturuluyor...',
+    'PHASE_DEPS'            => 'Bağımlılıklar kuruluyor...',
+    'PHASE_HEADER'          => 'Faz :current/:total —',
+    'FILES_TO_PROCESS'      => ':count dosya işlenecek',
+    'SUCCESS_TITLE'         => '✅  Proje başarıyla oluşturuldu!',
+    'NEXT_STEPS'            => '🎯 Başlamak için:',
+    'NEXT_STEPS_EDIT_ENV'   => '.env dosyasını düzenleyin ve geliştirmeye başlayın!',
+    'DIR_ITEM_COUNT'        => '(:count öğe)',
+
+    // MakeViewCommand
+    'ERROR_VIEW_PATH_REQUIRED' => 'Hata: View yolu gerekli (örn: dashboard.php veya /admin/kullanicilar/liste.php)',
+    'ERROR_STUB_NOT_FOUND'     => 'Hata: Stub dosyası bulunamadı: :path',
+    'ERROR_RUN_FROM_ROOT'      => 'Bu komutu ArtiFrame projenizin kök dizininden çalıştırın.',
+    'SUCCESS_VIEW'             => '✅ View oluşturuldu: /public/:path',
+    'SUCCESS_CSS'              => '✅ CSS oluşturuldu: /public:path',
+    'SUCCESS_JS'               => '✅ JS oluşturuldu:  /public:path',
+
+    // MakeApiCommand
+    'ERROR_API_TYPE'           => 'Hata: API türü \'standart\' veya \'switch-case\' olmalıdır.',
+    'ERROR_API_PATH_REQUIRED'  => 'Hata: Hedef yol gerekli (örn: /v1/auth/giris.php)',
+    'SUCCESS_API'              => '✅ API Endpoint oluşturuldu: /public/api/:type/:path',
+
+    // MakeClassCommand
+    'ERROR_CLASS_ROOT'         => 'Hata: Hedef /app/ veya /src/ dizininin içinde olmalıdır.',
+    'SUCCESS_CLASS'            => '✅ Sınıf oluşturuldu: /:path',
+    'NAMESPACE_LABEL'          => '   Ad Alanı (Namespace):',
+
+    // VersionCommand
+    'ERROR_VERSION_ACTION'     => 'Hata: Eylem \'upgrade\' veya \'downgrade\' olmalıdır.',
+    'ERROR_VERSION_LEVEL'      => 'Hata: Seviye \'major\', \'minor\' veya \'patch\' olmalıdır.',
+    'ERROR_VERSION_FILE'       => 'Hata: app-version.php bulunamadı: :path',
+    'ERROR_VERSION_PARSE'      => 'Hata: app-version.php içindeki APP_VERSION okunamadı.',
+    'WARN_VERSION_UNCHANGED'   => '⚠️  Uyarı: Sürüm zaten minimum değerde (:version) veya değişmedi.',
+    'SUCCESS_VERSION'          => '✅ Sürüm güncellendi: :old → :new',
+];

package/src/Services/Safeguard.php

@@ -0,0 +1,48 @@
+<?php
+namespace ArtiFrame\Cli\Services;
+
+class Safeguard
+{
+    private Translator $translator;
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+    }
+
+    /**
+     * Checks if the target path is inside the protected /bin/ directory.
+     * If so, interrupts and asks for user confirmation.
+     * Returns true if safe to proceed, false if aborted.
+     */
+    public function checkTarget(string $targetPath): bool
+    {
+        // Normalize slashes
+        $normalizedPath = str_replace('\\', '/', $targetPath);
+        
+        // Check if the path targets /bin/
+        if (strpos($normalizedPath, '/bin/') !== false || strpos($normalizedPath, 'bin/') === 0) {
+            echo PHP_EOL . "⚠️  " . $this->translator->get('CORE_WARNING_TITLE') . PHP_EOL;
+            echo str_repeat("-", 60) . PHP_EOL;
+            echo $this->translator->get('CORE_WARNING_BODY') . PHP_EOL;
+            echo str_repeat("-", 60) . PHP_EOL;
+            
+            $prompt = $this->translator->get('CONFIRM_PROMPT');
+            echo $prompt;
+            
+            $handle = fopen("php://stdin", "r");
+            $line = fgets($handle);
+            fclose($handle);
+            
+            $response = strtolower(trim($line));
+            $approvedResponses = ['y', 'yes', 'j', 'o', 's', 'evet'];
+            
+            if (!in_array($response, $approvedResponses)) {
+                echo PHP_EOL . "[ABORT] Operation cancelled by user." . PHP_EOL;
+                return false;
+            }
+        }
+        
+        return true;
+    }
+}

package/src/Services/Translator.php

@@ -0,0 +1,52 @@
+<?php
+namespace ArtiFrame\Cli\Services;
+
+class Translator
+{
+    private string $locale;
+    private array $messages = [];
+
+    public function __construct(string $locale)
+    {
+        // Support tr, en, de, es, fr. Default to en if not found.
+        $supportedLocales = ['tr', 'en', 'de', 'es', 'fr'];
+        
+        if (!in_array($locale, $supportedLocales)) {
+            $locale = 'en';
+        }
+        
+        $this->locale = $locale;
+        $this->loadMessages();
+    }
+
+    private function loadMessages(): void
+    {
+        $langFile = ARTIFRAME_CLI_ROOT . '/src/Lang/' . $this->locale . '.php';
+        
+        if (file_exists($langFile)) {
+            $this->messages = require $langFile;
+        } else {
+            // Fallback to english
+            $fallbackFile = ARTIFRAME_CLI_ROOT . '/src/Lang/en.php';
+            if (file_exists($fallbackFile)) {
+                $this->messages = require $fallbackFile;
+            }
+        }
+    }
+
+    public function get(string $key, array $replacements = []): string
+    {
+        $message = $this->messages[$key] ?? $key;
+
+        foreach ($replacements as $placeholder => $value) {
+            $message = str_replace(':' . $placeholder, $value, $message);
+        }
+
+        return $message;
+    }
+
+    public function getLang(): string
+    {
+        return $this->locale;
+    }
+}