lapeh 3.0.4 → 3.0.6

package/bin/index.js

@@ -133,7 +133,7 @@ sendTelemetry(command || 'init');
 
 switch (command) {
   case 'dev':
-    runDev();
+    (async () => { await runDev(); })();
     break;
   case 'start':
     (async () => { await runStart(); })();
@@ -155,8 +155,69 @@ switch (command) {
     break;
 }
 
-function runDev() {
+async function checkUpdate() {
+  try {
+    const pkg = require(path.join(__dirname, '../package.json'));
+    const currentVersion = pkg.version;
+    
+    // Fetch latest version from npm registry
+    const latestVersion = await new Promise((resolve) => {
+         const https = require('https');
+         const req = https.get('https://registry.npmjs.org/lapeh/latest', {
+             headers: { 'User-Agent': 'Lapeh-CLI' },
+             timeout: 1500 // 1.5s timeout
+         }, (res) => {
+             let data = '';
+             res.on('data', chunk => data += chunk);
+             res.on('end', () => {
+                 try {
+                     const json = JSON.parse(data);
+                     resolve(json.version);
+                 } catch (e) {
+                     resolve(null);
+                 }
+             });
+         });
+         
+         req.on('error', () => resolve(null));
+         req.on('timeout', () => {
+             req.destroy();
+             resolve(null);
+         });
+    });
+
+    if (latestVersion && latestVersion !== currentVersion) {
+        const currentParts = currentVersion.split('.').map(Number);
+        const latestParts = latestVersion.split('.').map(Number);
+        
+        let isOutdated = false;
+        for(let i=0; i<3; i++) {
+            if (latestParts[i] > currentParts[i]) {
+                isOutdated = true;
+                break;
+            } else if (latestParts[i] < currentParts[i]) {
+                break;
+            }
+        }
+        
+        if (isOutdated) {
+            console.log('\n');
+            console.log('\x1b[33m┌────────────────────────────────────────────────────────────┐\x1b[0m');
+            console.log(`\x1b[33m│\x1b[0m  \x1b[1mUpdate available!\x1b[0m \x1b[31m${currentVersion}\x1b[0m → \x1b[32m${latestVersion}\x1b[0m                           \x1b[33m│\x1b[0m`);
+            console.log(`\x1b[33m│\x1b[0m  Run \x1b[36mnpm install lapeh@latest\x1b[0m to update                  \x1b[33m│\x1b[0m`);
+            console.log(`\x1b[33m│\x1b[0m  Then run \x1b[36mnpx lapeh upgrade\x1b[0m to sync files               \x1b[33m│\x1b[0m`);
+            console.log('\x1b[33m└────────────────────────────────────────────────────────────┘\x1b[0m');
+            console.log('\n');
+        }
+    }
+  } catch (e) {
+    // Ignore errors during update check
+  }
+}
+
+async function runDev() {
   console.log('🚀 Starting Lapeh in development mode...');
+  await checkUpdate();
   try {
     const tsNodePath = require.resolve('ts-node/register');
     const tsConfigPathsPath = require.resolve('tsconfig-paths/register');
@@ -305,6 +366,12 @@ async function upgradeProject() {
     'src/redis.ts'
   ];
 
+  const updateStats = {
+      updated: [],
+      created: [],
+      removed: []
+  };
+
   function syncDirectory(src, dest, clean = false) {
     if (!fs.existsSync(src)) return;
     if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
@@ -316,11 +383,28 @@ async function upgradeProject() {
       srcEntryNames.add(entry.name);
       const srcPath = path.join(src, entry.name);
       const destPath = path.join(dest, entry.name);
+      const relativePath = path.relative(currentDir, destPath);
 
       if (entry.isDirectory()) {
         syncDirectory(srcPath, destPath, clean);
       } else {
-        fs.copyFileSync(srcPath, destPath);
+        let shouldCopy = true;
+        
+        if (fs.existsSync(destPath)) {
+            const srcContent = fs.readFileSync(srcPath);
+            const destContent = fs.readFileSync(destPath);
+            if (srcContent.equals(destContent)) {
+                shouldCopy = false;
+            } else {
+                updateStats.updated.push(relativePath);
+            }
+        } else {
+            updateStats.created.push(relativePath);
+        }
+
+        if (shouldCopy) {
+            fs.copyFileSync(srcPath, destPath);
+        }
       }
     }
 
@@ -329,7 +413,11 @@ async function upgradeProject() {
       for (const entry of destEntries) {
         if (!srcEntryNames.has(entry.name)) {
             const destPath = path.join(dest, entry.name);
+            const relativePath = path.relative(currentDir, destPath);
+            
             console.log(`🗑️  Removing obsolete file/directory: ${destPath}`);
+            updateStats.removed.push(relativePath);
+            
             if (entry.isDirectory()) {
                 fs.rmSync(destPath, { recursive: true, force: true });
             } else {
@@ -343,6 +431,7 @@ async function upgradeProject() {
   for (const item of filesToSync) {
     const srcPath = path.join(templateDir, item);
     const destPath = path.join(currentDir, item);
+    const relativePath = item; // Since item is relative to templateDir/currentDir
     
     if (fs.existsSync(srcPath)) {
       const stats = fs.statSync(srcPath);
@@ -350,10 +439,26 @@ async function upgradeProject() {
           console.log(`🔄 Syncing directory ${item}...`);
           syncDirectory(srcPath, destPath, item === 'lib');
       } else {
-          console.log(`🔄 Updating file ${item}...`);
+          console.log(`🔄 Checking file ${item}...`);
           const destDir = path.dirname(destPath);
           if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
-          fs.copyFileSync(srcPath, destPath);
+          
+          let shouldCopy = true;
+          if (fs.existsSync(destPath)) {
+              const srcContent = fs.readFileSync(srcPath);
+              const destContent = fs.readFileSync(destPath);
+              if (srcContent.equals(destContent)) {
+                  shouldCopy = false;
+              } else {
+                  updateStats.updated.push(relativePath);
+              }
+          } else {
+              updateStats.created.push(relativePath);
+          }
+
+          if (shouldCopy) {
+            fs.copyFileSync(srcPath, destPath);
+          }
       }
     }
   }
@@ -430,7 +535,27 @@ async function upgradeProject() {
   }
 
   console.log('\n✅ Upgrade completed successfully!');
-  console.log('   Please check your .env file against .env.example for any new required variables.');
+  
+  if (updateStats.created.length > 0) {
+      console.log('\n✨ Created files:');
+      updateStats.created.forEach(f => console.log(`   \x1b[32m+ ${f}\x1b[0m`));
+  }
+  
+  if (updateStats.updated.length > 0) {
+      console.log('\n📝 Updated files:');
+      updateStats.updated.forEach(f => console.log(`   \x1b[33m~ ${f}\x1b[0m`));
+  }
+
+  if (updateStats.removed.length > 0) {
+      console.log('\n🗑️ Removed files:');
+      updateStats.removed.forEach(f => console.log(`   \x1b[31m- ${f}\x1b[0m`));
+  }
+
+  if (updateStats.created.length === 0 && updateStats.updated.length === 0 && updateStats.removed.length === 0) {
+      console.log('   No files were changed.');
+  }
+
+  console.log('\n   Please check your .env file against .env.example for any new required variables.');
 }
 
 function createProject(skipFirstArg = false) {
@@ -520,7 +645,15 @@ function createProject(skipFirstArg = false) {
         if (ignoreList.includes(entry.name)) continue;
         const srcPath = path.join(src, entry.name);
         const destPath = path.join(dest, entry.name);
-
+        
+        // Clean storage/logs: skip everything except .gitkeep
+        // Check if we are inside storage/logs
+        const relPath = path.relative(templateDir, srcPath);
+        const isInLogs = relPath.includes(path.join('storage', 'logs')) || relPath.includes('storage/logs') || relPath.includes('storage\\logs');
+        
+        if (isInLogs && !entry.isDirectory() && entry.name !== '.gitkeep') {
+            continue; 
+        }
 
         if (entry.isDirectory()) {
           fs.mkdirSync(destPath);

package/doc/en/STRUCTURE.md

@@ -1,84 +1,79 @@
-# Project Structure Breakdown
+# 🏗️ Project Structure
 
-To fully understand Lapeh Framework, you need to know what each file and folder does. Here is a complete "Tour" of the project directory.
+Lapeh Framework is designed to be **intuitive**. We separate your application code (_User Space_) from the framework engine (_Core_), so you can focus on building features without being distracted by system complexity.
 
-## Root Directory
+## 🗺️ Navigation Map
 
-| File/Folder          | Description                                                                    |
-| :------------------- | :----------------------------------------------------------------------------- |
-| `bin/`               | Contains execution scripts for CLI (`npx lapeh`). You rarely touch this.       |
-| `doc/`               | Project documentation resides here.                                            |
-| `lib/`               | **Framework Core**. Internal parts of the framework you rarely touch.          |
-| `scripts/`           | Collection of Node.js utility scripts (generators, schema compilers, etc).     |
-| `src/`               | **Main Source Code**. 99% of your coding happens here.                         |
-| `.env`               | Secret variables (Database URL, API Keys). **Do not commit this file to Git!** |
-| `docker-compose.yml` | Docker configuration for running local Database & Redis.                       |
-| `nodemon.json`       | Auto-restart configuration during development.                                 |
-| `package.json`       | List of libraries (dependencies) and commands (`npm run ...`).                 |
-| `tsconfig.json`      | TypeScript configuration.                                                      |
+Here is a mental map to understand Lapeh folders:
 
-## `src/` Folder (Source Code - User Space)
+| Folder         | Icon | Function                                                                | Status          |
+| :------------- | :--: | :---------------------------------------------------------------------- | :-------------- |
+| **`src/`**     |  🏠  | **YOUR APP CODE**. You work here every day.                             | **Must Edit**   |
+| **`scripts/`** |  🤖  | **Automation Assistants**. Scripts for release, module generation, etc. | **Can Edit**    |
+| **`bin/`**     |  🚀  | **CLI Tools**. Entry point for `npx lapeh` commands.                    | **Rarely Edit** |
+| **`lib/`**     |  ⚙️  | **Framework Engine**. Core server & database logic.                     | **DO NOT Edit** |
 
-This is where you work every day.
+---
 
-### `src/modules/` (Modular Architecture)
+## 1. 🏠 Folder `src/` (User Space)
 
-Lapeh uses a **Modular** approach. Each feature is grouped into a single module folder to keep the code organized.
+This is your "home". 99% of new feature code will be written here.
 
-Example `Auth` module structure:
+### `src/modules/` (Modular Architecture)
 
-- `Auth/auth.controller.ts`: Application logic (Controller).
+Lapeh uses a **Modular** approach. One feature = One folder.
+
+- **Example**: `src/modules/Auth/` folder contains all login/register logic.
+- **Benefit**: Code is neat, easy to find, and easy to delete if the feature is no longer used.
 
 ### `src/routes/`
 
-Defines endpoint URLs.
+Your API gateway.
 
-- Connects URLs (e.g., `/api/login`) to functions in Controllers.
-- Attaches Middleware (e.g., `requireAuth`).
+- Defines URLs (e.g., `/api/users`).
+- Connects URLs to **Controllers**.
 
 ### `src/config/`
 
-Static application configuration.
-
-- `app.ts`: General application configuration.
-- `cors.ts`: CORS (Cross-Origin Resource Sharing) configuration.
+Application settings center.
 
-## `lib/` Folder (Framework Internals)
+- `app.ts`: Global configuration.
+- `cors.ts`: Domain access security.
 
-This part is similar to `node_modules` or the `.next` folder in Next.js. This is the framework engine.
-
-### `lib/core/`
+---
 
-The "Engine" part of the framework.
+## 2. 🤖 Folder `scripts/` (Robot Assistants)
 
-- `server.ts`: Express App setup.
-- `redis.ts`: Redis connection.
-- `serializer.ts`: JSON Schema caching logic.
+Don't do boring things manually! Lapeh provides robots here:
 
-### `lib/middleware/`
+- **`release.js`**: **Super Script** for releasing new versions.
+  - ✨ Automatic version bump (package.json).
+  - 📝 **Auto-Blog**: Automatically creates release articles from Git Commit history.
+  - 🔄 **Auto-Sync**: Synchronizes documentation to the website.
+  - 🚀 Push to Git & Publish to NPM in one command.
+- **`make-module.js`**: Generator to create new module folder structures instantly.
 
-Built-in framework middleware.
+---
 
-- `auth.ts`: Check JWT Token.
-- `rateLimit.ts`: Limit request count.
-- `requestLogger.ts`: Log every incoming request.
+## 3. 🚀 Folder `bin/` (CLI & Update)
 
-### `lib/utils/`
+This folder handles `npx lapeh` terminal commands.
 
-Built-in Helper functions.
+- Provides **Auto-Update Check** feature when you run `npm run dev`.
+- Handles `upgrade` command to sync your project with the latest Lapeh version without breaking your code.
 
-- `validator.ts`: Powerful and expressive input validation.
-- `response.ts`: Standard JSON response format (`sendFastSuccess`, `sendError`).
-- `logger.ts`: Logging system (Winston).
+---
 
-## `scripts/` Folder
+## 4. ⚙️ Folder `lib/` (The Core)
 
-"Magic" scripts executed by `npm run`.
+Lapeh's "Engine Room". Contains Express setup, Database connection, Logger, and basic Middleware.
 
-- `make-module.js`: New module generator (Controller).
-- `init-project.js`: Initial setup wizard.
-- `generate-jwt-secret.js`: Automatic JWT secret key generator.
+> ⚠️ **Warning**: Changing the contents of this folder can make the application difficult to update to the next Lapeh version.
 
 ---
 
-By understanding this structure, you won't get lost when adding new features or debugging.
+## 📄 Other Important Files
+
+- **`.env`**: **Secret Keys**. Store DB passwords and API Keys here. (Do not upload to Git!)
+- **`package.json`**: List of your project's library "shopping list".
+- **`ecosystem.config.js`**: Ready to deploy? This file configures how the application runs on a production server (VPS) using PM2.

package/doc/id/STRUCTURE.md

@@ -1,84 +1,79 @@
-# Bedah Struktur Proyek
+# 🏗️ Struktur Proyek
 
-Untuk memahami Lapeh Framework sepenuhnya, Anda perlu tahu apa fungsi setiap file dan folder. Berikut adalah "Tour" lengkap ke dalam direktori proyek.
+Lapeh Framework didesain agar **intuitif**. Kami memisahkan kode aplikasi Anda (_User Space_) dari mesin framework (_Core_), sehingga Anda bisa fokus membangun fitur tanpa terganggu kompleksitas sistem.
 
-## Root Directory
+## 🗺️ Peta Navigasi
 
-| File/Folder          | Deskripsi                                                                     |
-| :------------------- | :---------------------------------------------------------------------------- |
-| `bin/`               | Berisi script eksekusi untuk CLI (`npx lapeh`). Anda jarang menyentuh ini.    |
-| `doc/`               | Dokumentasi proyek ini berada.                                                |
-| `lib/`               | **Framework Core**. Bagian internal framework yang jarang Anda sentuh.        |
-| `scripts/`           | Kumpulan script Node.js untuk utility (generator, compiler schema, dll).      |
-| `src/`               | **Source Code Utama**. 99% kodingan Anda ada di sini.                         |
-| `.env`               | Variabel rahasia (Database URL, API Keys). **Jangan commit file ini ke Git!** |
-| `docker-compose.yml` | Konfigurasi Docker untuk menjalankan Database & Redis lokal.                  |
-| `nodemon.json`       | Konfigurasi auto-restart saat development.                                    |
-| `package.json`       | Daftar library (dependencies) dan perintah (`npm run ...`).                   |
-| `tsconfig.json`      | Konfigurasi TypeScript.                                                       |
+Berikut adalah peta mental untuk memahami folder Lapeh:
 
-## Folder `src/` (Source Code - User Space)
+| Folder         | Ikon | Fungsi                                                         | Status            |
+| :------------- | :--: | :------------------------------------------------------------- | :---------------- |
+| **`src/`**     |  🏠  | **KODE APLIKASI ANDA**. Disini Anda bekerja setiap hari.       | **Wajib Edit**    |
+| **`scripts/`** |  🤖  | **Asisten Otomatis**. Script untuk rilis, generate modul, dll. | **Boleh Edit**    |
+| **`bin/`**     |  🚀  | **CLI Tools**. Entry point untuk perintah `npx lapeh`.         | **Jarang Edit**   |
+| **`lib/`**     |  ⚙️  | **Mesin Framework**. Core logic server & database.             | **DILARANG Edit** |
 
-Ini adalah tempat Anda bekerja setiap hari.
+---
+
+## 1. 🏠 Folder `src/` (User Space)
 
-### `src/modules/` (Modular Architecture)
+Ini adalah "kandang" Anda. 99% kode fitur baru akan ditulis di sini.
 
-Lapeh menggunakan pendekatan **Modular**. Setiap fitur dikelompokkan dalam satu folder modul agar kode lebih terorganisir.
+### `src/modules/` (Arsitektur Modular)
 
-Contoh struktur modul `Auth`:
+Lapeh menggunakan pendekatan **Modular**. Satu fitur = Satu folder.
 
-- `Auth/auth.controller.ts`: Logika aplikasi (Controller).
+- **Contoh**: Folder `src/modules/Auth/` berisi semua logika login/register.
+- **Keuntungan**: Kode rapi, mudah dicari, dan mudah dihapus jika fitur tidak dipakai lagi.
 
 ### `src/routes/`
 
-Mendefinisikan URL endpoint.
+Pintu gerbang API Anda.
 
-- Menghubungkan URL (misal `/api/login`) ke fungsi di Controller.
-- Menempelkan Middleware (misal `requireAuth`).
+- Mendefinisikan URL (misal: `/api/users`).
+- Menghubungkan URL ke **Controller**.
 
 ### `src/config/`
 
-Konfigurasi aplikasi yang bersifat statis.
-
-- `app.ts`: Konfigurasi umum aplikasi.
-- `cors.ts`: Konfigurasi CORS (Cross-Origin Resource Sharing).
-
-## Folder `lib/` (Framework Internals)
+Pusat pengaturan aplikasi.
 
-Bagian ini mirip dengan `node_modules` atau folder `.next` di Next.js. Ini adalah mesin framework.
+- `app.ts`: Konfigurasi global.
+- `cors.ts`: Keamanan akses domain.
 
-### `lib/core/`
+---
 
-Bagian "Mesin" framework.
+## 2. 🤖 Folder `scripts/` (Asisten Robot)
 
-- `server.ts`: Setup Express App.
-- `redis.ts`: Koneksi Redis.
-- `serializer.ts`: Logic caching JSON Schema.
+Jangan lakukan hal membosankan secara manual! Lapeh menyediakan robot di sini:
 
-### `lib/middleware/`
+- **`release.js`**: **Super Script** untuk merilis versi baru.
+  - ✨ Otomatis bump versi (package.json).
+  - 📝 **Auto-Blog**: Membuat artikel rilis otomatis dari history Git Commit.
+  - 🔄 **Auto-Sync**: Sinkronisasi dokumentasi ke website.
+  - 🚀 Push ke Git & Publish ke NPM dalam satu perintah.
+- **`make-module.js`**: Generator untuk membuat struktur folder module baru dalam sekejap.
 
-Middleware bawaan framework.
+---
 
-- `auth.ts`: Cek JWT Token.
-- `rateLimit.ts`: Batasi jumlah request.
-- `requestLogger.ts`: Log setiap request yang masuk.
+## 3. 🚀 Folder `bin/` (CLI & Update)
 
-### `lib/utils/`
+Folder ini menangani perintah terminal `npx lapeh`.
 
-Fungsi bantuan (Helper) bawaan.
+- Menyediakan fitur **Auto-Update Check** saat Anda menjalankan `npm run dev`.
+- Menangani perintah `upgrade` untuk menyinkronkan proyek Anda dengan versi Lapeh terbaru tanpa merusak kode Anda.
 
-- `validator.ts`: Validasi input yang kuat dan ekspresif.
-- `response.ts`: Standar format JSON response (`sendFastSuccess`, `sendError`).
-- `logger.ts`: Sistem logging (Winston).
+---
 
-## Folder `scripts/`
+## 4. ⚙️ Folder `lib/` (The Core)
 
-Script-script "Magic" yang dijalankan `npm run`.
+"Ruang Mesin" Lapeh. Berisi setup Express, koneksi Database, Logger, dan Middleware dasar.
 
-- `make-module.js`: Generator modul baru (Controller).
-- `init-project.js`: Wizard setup awal.
-- `generate-jwt-secret.js`: Generator kunci rahasia JWT otomatis.
+> ⚠️ **Peringatan**: Mengubah isi folder ini bisa membuat aplikasi sulit di-update ke versi Lapeh selanjutnya.
 
 ---
 
-Dengan memahami struktur ini, Anda tidak akan tersesat saat ingin menambah fitur baru atau mencari bug.
+## 📄 File Penting Lainnya
+
+- **`.env`**: **Kunci Rahasia**. Simpan password DB dan API Key disini. (Jangan di-upload ke Git!)
+- **`package.json`**: Daftar "belanjaan" library proyek Anda.
+- **`ecosystem.config.js`**: Siap deploy? File ini mengatur cara aplikasi berjalan di server production (VPS) menggunakan PM2.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lapeh",
-  "version": "3.0.4",
+  "version": "3.0.6",
   "description": "Framework API Express yang siap pakai (Standardized)",
   "engines": {
     "node": ">=18.0.0",

package/scripts/release.js

@@ -73,8 +73,64 @@ function incrementPatch(version) {
     return parts.join('.');
 }
 
+// Helper to generate auto commit message
+function generateAutoCommitMessage() {
+    try {
+        const status = execSync('git status --porcelain', { stdio: 'pipe' }).toString().trim();
+        if (!status) return 'chore: no changes detected';
+
+        const files = status.split('\n').map(line => line.substring(3).trim());
+        
+        const hasDocs = files.some(f => f.startsWith('website/') || f.startsWith('doc/') || f.endsWith('.md'));
+        const hasScripts = files.some(f => f.startsWith('scripts/'));
+        const hasPackage = files.some(f => f.includes('package.json'));
+        const hasSrc = files.some(f => !f.startsWith('website/') && !f.startsWith('doc/') && !f.startsWith('scripts/') && !f.includes('package.json') && !f.startsWith('.'));
+
+        let types = [];
+        if (hasDocs) types.push('docs');
+        if (hasScripts) types.push('scripts');
+        if (hasPackage) types.push('deps');
+        if (hasSrc) types.push('feat/fix');
+
+        if (types.length === 0) return 'chore: update project files';
+        
+        if (hasDocs && !hasSrc && !hasScripts) return 'docs: update documentation';
+        if (hasScripts && !hasSrc) return 'chore: update build scripts';
+        
+        return `chore: update ${types.join(', ')}`;
+    } catch (e) {
+        return 'chore: update project files';
+    }
+}
+
 async function main() {
     try {
+        // 0. Quick Git Update Check
+        const quickGit = await question('\n⚡ Apakah ini hanya Quick Git Update (tanpa rilis versi)? (y/n): ');
+        if (quickGit.toLowerCase() === 'y') {
+             console.log('\n🤖 Auto-generating commit message...');
+             const commitMsg = generateAutoCommitMessage();
+             console.log(`📝 Commit Message: "${commitMsg}"`);
+             
+             try {
+                 console.log('🔄 Syncing documentation (just in case)...');
+                 try {
+                    execSync('node scripts/sync-docs.js', { cwd: websiteDir, stdio: 'inherit' });
+                 } catch (e) {
+                    console.log('⚠️ Warning: Doc sync failed, continuing...');
+                 }
+
+                 execSync('git add .', { stdio: 'inherit' });
+                 execSync(`git commit -m "${commitMsg}"`, { stdio: 'inherit' });
+                 execSync('git push origin HEAD', { stdio: 'inherit' });
+                 console.log('✅ Quick Git Update selesai!');
+                 process.exit(0);
+             } catch (e) {
+                 console.error('❌ Error during git operations:', e.message);
+                 process.exit(1);
+             }
+        }
+
         // 1. Check versions and ask for new one
         console.log('🔍 Checking npm version...');
         const npmVersion = getNpmVersion();
@@ -139,10 +195,10 @@ async function main() {
 
             // Indonesian Blog Content
             const idContent = `---
-title: Rilis v${newVersion} - ${titleID}
+title: "Rilis v${newVersion} - ${titleID.replace(/"/g, '\\"')}"
 date: ${date}
 author: Tim Lapeh
-description: ${descriptionID}
+description: "${descriptionID.replace(/"/g, '\\"')}"
 ---
 
 # Rilis v${newVersion}: ${titleID}
@@ -168,10 +224,10 @@ Terima kasih telah menggunakan Lapeh Framework!
 
             // English Blog Content
             const enContent = `---
-title: Release v${newVersion} - ${titleEN}
+title: "Release v${newVersion} - ${titleEN.replace(/"/g, '\\"')}"
 date: ${date}
 author: Lapeh Team
-description: ${descriptionEN}
+description: "${descriptionEN.replace(/"/g, '\\"')}"
 ---
 
 # Release v${newVersion}: ${titleEN}
@@ -208,12 +264,18 @@ Thank you for using Lapeh Framework!
         // 3. Question: Documentation
         const updateDocs = await question('\n2. Apa Anda ingin update dokumentasi? (y/n): ');
         if (updateDocs.toLowerCase() === 'y') {
-             console.log('\n📚 Documentation Reminder:');
+             console.log('\n📚 Documentation Update:');
+             console.log('Sistem akan menjalankan sinkronisasi otomatis:');
+             console.log('  - Menyalin file dari `doc/id` ke `website/docs`');
+             console.log('  - Menyalin file dari `doc/en` ke `website/en/docs`');
+             console.log('  - Mengubah nama file menjadi format URL-friendly (contoh: GETTING_STARTED.md -> getting-started.md)');
+
+             console.log('\n⚠️  Manual Action Required (If applicable):');
              console.log('Jika ada package/method baru, silakan update file berikut secara manual sekarang:');
              console.log('  - website/docs/packages.md');
              console.log('  - website/docs/api.md');
              
-             await question('Tekan Enter jika Anda sudah selesai update manual (atau jika tidak diperlukan)...');
+             await question('Tekan Enter untuk menjalankan sinkronisasi otomatis (setelah Anda selesai update manual)...');
 
              console.log('🔄 Syncing documentation...');
              execSync('node scripts/sync-docs.js', { cwd: websiteDir, stdio: 'inherit' });
@@ -228,10 +290,30 @@ Thank you for using Lapeh Framework!
                 ? `chore: release v${newVersion} - ${blogTitleEN}`
                 : `chore: release v${newVersion}`;
 
-            execSync('git add .', { stdio: 'inherit' });
-            execSync(`git commit -m "${commitMsg}"`, { stdio: 'inherit' });
+            try {
+                execSync('git add .', { stdio: 'inherit' });
+                execSync(`git commit -m "${commitMsg}"`, { stdio: 'inherit' });
+            } catch (e) {
+                console.log('⚠️  No changes to commit or commit failed. Continuing...');
+            }
+
+            try {
+                // Delete tag if it exists locally to avoid "already exists" error
+                execSync(`git tag -d v${newVersion}`, { stdio: 'ignore' });
+            } catch (e) {
+                // Ignore if tag doesn't exist
+            }
+
             execSync(`git tag v${newVersion}`, { stdio: 'inherit' });
-            execSync(`git push origin HEAD && git push origin v${newVersion}`, { stdio: 'inherit' });
+            execSync(`git push origin HEAD`, { stdio: 'inherit' });
+            
+            try {
+                execSync(`git push origin v${newVersion}`, { stdio: 'inherit' });
+            } catch (e) {
+                 console.log('⚠️  Tag push failed. Trying force push (updating existing tag)...');
+                 execSync(`git push origin v${newVersion} --force`, { stdio: 'inherit' });
+            }
+            
             console.log('✅ Git push & tag complete');
         } else {
             console.log('⏭️  Skipping Git push.');
@@ -240,8 +322,20 @@ Thank you for using Lapeh Framework!
         // 5. Question: NPM
         const publishNpm = await question('\n4. Apa ingin publish ke NPM? (y/n): ');
         if (publishNpm.toLowerCase() === 'y') {
-            execSync('npm publish', { stdio: 'inherit' });
-            console.log('✅ NPM publish complete');
+            try {
+                execSync('npm publish', { stdio: 'inherit' });
+                console.log('✅ NPM publish complete');
+            } catch (error) {
+                console.log('\n⚠️  NPM Publish failed. This might be due to 2FA.');
+                const otp = await question('🔐 Masukkan kode OTP (Authenticator App) Anda: ');
+                if (otp && otp.trim() !== '') {
+                     execSync(`npm publish --otp=${otp.trim()}`, { stdio: 'inherit' });
+                     console.log('✅ NPM publish complete');
+                } else {
+                    console.log('❌ NPM publish aborted.');
+                    throw error;
+                }
+            }
         } else {
              console.log('⏭️  Skipping NPM publish.');
         }

package/storage/logs/.0337f5062fe676994d1dc340156e089444e3d6e0-audit.json

@@ -19,6 +19,11 @@
             "date": 1767106155460,
             "name": "E:\\PROJECT\\ANY\\2026\\lapeh\\storage\\logs\\lapeh-2025-12-30.log",
             "hash": "f090b6426f3343ed97dadce1dfe5cf1b15b0e4f173b3a0b4fbfe19d9f86dec03"
+        },
+        {
+            "date": 1767116159016,
+            "name": "E:\\PROJECT\\ANY\\2026\\lapeh\\storage\\logs\\lapeh-2025-12-31.log",
+            "hash": "d0e8ef584ec2262b3b615e4747e50c0f7f2bf687c8d4264b6881edbe00f039e0"
         }
     ],
     "hashType": "sha256"