@thanhthi2895/luna-ai 2.16.3 → 2.16.4

package/README.md

@@ -4,13 +4,29 @@ Agentic Workflow Framework for the **Vibe Coding** era, with an integrated **Dyn
 
 ## 🚀 Quick Start
 
+### Global Installation (Recommended)
+Installs the framework globally, available for all your projects.
+
+```bash
+# 1. Install the framework globally into ~/.claude
+npx @thanhthi2895/luna-ai -g
+
+# 2. Initialize global metadata (first time only)
+luna init -g
+
+# 3. Open Claude Code in any project and start Vibe Coding!
+claude
+```
+
+### Local Project Installation
+Installs the framework directly into the current project's directory.
+
 ```bash
-# 1. Install the framework
-npx @thanhthi2895/luna-ai          # local project
-npx @thanhthi2895/luna-ai -g       # global
+# 1. Install the framework locally
+npx @thanhthi2895/luna-ai
 
-# 2. Initialize project data
-luna
+# 2. Initialize project structure and memory
+luna init
 
 # 3. Open Claude Code and start Vibe Coding!
 claude
@@ -21,7 +37,7 @@ claude
 ## 🎯 Goal: Vibe Coding - Full Auto
 Users simply provide an idea. The system automatically coordinates a team of specialized Agents to assess risk, create multi-level plans, execute with TDD standards, and deliver the product at optimal speed.
 
-## 🚀 Breakthrough Features (V2.5)
+## 🚀 Breakthrough Features (V2.16)
 - **Layered Cache**: Multi-level memory cache (L1/L2/L3) for large projects (20+ modules, 200+ files).
 - **Semantic Code Graph**: Uses `lu:gkg` (GitLab Knowledge Graph) to see all project connections and run impact analysis.
 - **Context Distilling**: Automatically filters out code noise, helping AI think faster and save tokens.

package/bin/commands/install.js

@@ -439,6 +439,27 @@ async function copyClaude_global(rootDir, claudeHome) {
     throw new Error(`Canonical Claude directory missing: ${srcClaude}`);
   }
   const destClaude = claudeHome;
+  
+  // PREVENT fs-extra "Source and destination must not be the same" error
+  // If destClaude contains symlinks pointing to srcClaude elements, fs.copy will crash.
+  // We remove those specific symlinks before copying.
+  try {
+    const srcItems = await fs.readdir(srcClaude);
+    for (const item of srcItems) {
+      const destPath = path.join(destClaude, item);
+      try {
+        const tgtStat = await fs.lstat(destPath);
+        if (tgtStat.isSymbolicLink()) {
+          await fs.remove(destPath);
+        }
+      } catch (e) {
+        // Ignore if doesn't exist
+      }
+    }
+  } catch (err) {
+    console.error(` Warning: Could not run symlink cleanup in ${destClaude}:`, err.message);
+  }
+
   const skipPaths = [
     path.join(srcClaude, 'ai-cache'),
     path.join(srcClaude, 'hook-state'),          // Runtime data, don't copy
@@ -690,21 +711,27 @@ export async function installGlobal(rootDir) {
       // Copy statusline.cjs and its lib/ dependency from canonical .claude/ to ~/.claude/
       const canonicalClaude = getCanonicalClaudeDir(rootDir);
       const statuslineSrc = path.join(canonicalClaude, 'statusline.cjs');
+      const statuslineDest = path.join(claudeHome, 'statusline.cjs');
+      const libDest = path.join(claudeHome, 'lib');
       if (await fs.pathExists(statuslineSrc)) {
-        await fs.copy(statuslineSrc, path.join(claudeHome, 'statusline.cjs'), { overwrite: true });
+        try { await fs.remove(statuslineDest); } catch(e){}
+        await fs.copy(statuslineSrc, statuslineDest, { overwrite: true });
         // statusline.cjs requires ./lib/ — copy lib/ to ~/.claude/lib/
         const libSrc = path.join(canonicalClaude, 'lib');
         if (await fs.pathExists(libSrc)) {
-          await fs.copy(libSrc, path.join(claudeHome, 'lib'), { overwrite: true });
+          try { await fs.remove(libDest); } catch(e){}
+          await fs.copy(libSrc, libDest, { overwrite: true });
         }
         console.log(` Copied statusline.cjs + lib/ → ~/.claude/`);
       }
 
       // Copy canonical .luna.json to ~/.claude/.luna.json
       const lunaJsonSrc = path.join(rootDir, 'agentic', 'claude', '.luna.json');
+      const lunaJsonDest = path.join(claudeHome, '.luna.json');
 
       if (await fs.pathExists(lunaJsonSrc)) {
-        await fs.copy(lunaJsonSrc, path.join(claudeHome, '.luna.json'), { overwrite: true });
+        try { await fs.remove(lunaJsonDest); } catch(e){}
+        await fs.copy(lunaJsonSrc, lunaJsonDest, { overwrite: true });
         console.log(` Copied .luna.json → ~/.claude/.luna.json`);
       } else {
         console.log(' Warning: canonical agentic/claude/.luna.json missing. Skip publishing ~/.claude/.luna.json');
@@ -714,12 +741,16 @@ export async function installGlobal(rootDir) {
       await ensureLunaCli(claudeHome);
 
       // Copy CLAUDE.md into ~/.claude/ (Claude Code reads global instructions from here)
-      await fs.copy(getCanonicalClaudeMd(rootDir), path.join(claudeHome, 'CLAUDE.md'), { overwrite: true });
+      const claudeMdDest = path.join(claudeHome, 'CLAUDE.md');
+      try { await fs.remove(claudeMdDest); } catch(e){}
+      await fs.copy(getCanonicalClaudeMd(rootDir), claudeMdDest, { overwrite: true });
       await ensureGeminiSymlink(claudeHome);
     }
 
     // Copy CLAUDE.md + GEMINI.md symlink into ~/.luna-ai/ (as reference)
-    await fs.copy(getCanonicalClaudeMd(rootDir), path.join(lunaHome, 'CLAUDE.md'), { overwrite: true });
+    const lunaAiClaudeMdDest = path.join(lunaHome, 'CLAUDE.md');
+    try { await fs.remove(lunaAiClaudeMdDest); } catch(e){}
+    await fs.copy(getCanonicalClaudeMd(rootDir), lunaAiClaudeMdDest, { overwrite: true });
     await ensureGeminiSymlink(lunaHome);
 
     // Create plans/archive directory at ~/.luna-ai/
@@ -827,6 +858,7 @@ async function writeGlobalSettingsJson(rootDir, claudeHome) {
 
   if (!await fs.pathExists(srcPath)) return;
 
+  try { await fs.remove(destPath); } catch (e) {}
   await fs.copy(srcPath, destPath, { overwrite: true });
   console.log(` Copied .agents/settings.json → ~/.claude/settings.json`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanhthi2895/luna-ai",
-  "version": "2.16.3",
+  "version": "2.16.4",
   "description": "Agentic Workflow Framework cho Claude - Tự động hóa quy trình lập trình Vibe Coding",
   "type": "module",
   "private": false,