antigravity-ide 4.0.5 → 4.0.6

package/README.md

@@ -2,6 +2,8 @@
 
 The First AI-Native IDE designed for Vibe Coding & Agentic Workflow. 🛰️🚀
 
+**Official Website**: [antigravity-ide-cli.vercel.app](https://antigravity-ide-cli.vercel.app/)
+
 > [!IMPORTANT]
 > **AntiGravity IDE** is a conceptual expansion of the original Antigravity framework, optimized for senior-level engineering, security, and high-performance web development.
 
@@ -22,7 +24,7 @@ npx antigravity-ide@latest my-project --skip-prompts
 > [!TIP]
 > **New to npx?** Check our [NPX Installation Guide](file:///docs/INSTALL_NPX_GUIDE.vi.md) for a step-by-step setup.
 
-### ✨ Setup Wizard Features (v4.0.5 - Modular Architecture)
+### ✨ Setup Wizard Features (v4.0.6 - Docs & CLI Upgrade)
 The new interactive CLI features a **Modular Installation Engine** that adapts to your exact needs:
 
 1.  **Scale-Adaptive Architecture**: 
@@ -57,9 +59,14 @@ Meet your new virtual team:
 
 ## 📈 Release History
 
+#### v4.0.6 (Full Docs & Workflow Sync)
+- Synchronized all 30 Workflows and 22 Specialist Agents.
+- Added comprehensive FAQ, Update, and Uninstall guides.
+- Improved CLI conflict resolution with `--force` flag.
+
 #### v4.0.5 (Final Sync)
 - Rebranded to AntiGravity IDE.
-- Standardized all 72 Master Skills to v4.0.5 metadata.
+- Standardized all 72 Master Skills to v4.0.6 metadata.
 - Integrated Python environment awareness.
 - Unified License & Credits.
 

package/README.vi.md

@@ -2,6 +2,8 @@
 
 IDE đầu tiên được thiết kế dành riêng cho "Vibe Coding" và Quy trình Tác chiến AI (Agentic Workflow). 🛰️🚀
 
+**Trang chủ chính thức**: [antigravity-ide-cli.vercel.app](https://antigravity-ide-cli.vercel.app/)
+
 > [!IMPORTANT]
 > **AntiGravity IDE** là một bản mở rộng đột phá của framework Antigravity gốc, được tối ưu hóa cho kỹ thuật phần mềm cấp cao, bảo mật và phát triển web hiệu năng cao.
 
@@ -20,12 +22,13 @@ npx antigravity-ide@latest my-project --skip-prompts
 ```
 
 > [!TIP]
-> **Mới làm quen với npx?** Xem [Hướng dẫn Cài đặt NPX](file:///docs/INSTALL_NPX_GUIDE.vi.md) để bắt đầu từng bước.
+> **Mới làm quen với npx?** Xem [Hướng dẫn Cài đặt NPX](file:///docs/INSTALL_NPX_GUIDE.vi.md) để bắt đầu.
+> **Cần hỗ trợ?** Xem [FAQ](file:///docs/FAQ.vi.md) hoặc [Hướng dẫn Cập nhật](file:///docs/UPDATE_GUIDE.vi.md).
 
 > [!WARNING]
-> **Lưu ý quan trọng:** Không nên cài đặt Global (`npm install -g antigravity-ide`) vì sẽ gây xung đột phiên bản cũ/mới. Luôn dùng `npx ...@latest` để đảm bảo project được khởi tạo với Engine mới nhất.
+> **Lưu ý quan trọng:** Không nên cài đặt Global (`npm install -g antigravity-ide`) vì sẽ gây xung đột. Xem [Hướng dẫn Gỡ cài đặt](file:///docs/UNINSTALL_GUIDE.vi.md) nếu đã lỡ cài.
 
-### ✨ Tính năng Setup Wizard (v4.0.5 - Big Update)
+### ✨ Tính năng Setup Wizard (v4.0.6 - Build Update)
 Trải nghiệm dòng lệnh (CLI) đẳng cấp Premium với **Cơ chế Thích ứng theo Quy mô**:
 
 1.  **Kiến trúc Thích ứng theo Quy mô (Scale-Adaptive)**: 
@@ -58,11 +61,14 @@ Chúng tôi cung cấp thư viện 72 kỹ năng "Senior-Grade" được phân l
 
 ---
 
-## 📈 Lịch sử Phiên bản
+#### v4.0.6 (Nâng cấp tài liệu & CLI)
+- Đồng bộ hóa toàn bộ 30 Workflows và 22 Agents.
+- Bổ sung tài liệu FAQ, Update và Uninstall.
+- Tối ưu hóa cơ chế xử lý xung đột file (--force).
 
 #### v4.0.5 (Đồng bộ cuối)
 - Đổi tên thương hiệu thành AntiGravity IDE.
-- Chuẩn hóa toàn bộ 72 Master Skills sang metadata v4.0.5.
+- Chuẩn hóa toàn bộ 72 Master Skills sang metadata v4.0.6.
 - Tích hợp nhận diện môi trường Python.
 - Nhất quán License & Credits.
 

package/VERSION

@@ -1 +1 @@
-4.0.5
+4.0.6

package/cli/create.js

@@ -7,7 +7,7 @@ const path = require('path');
 const chalk = require('chalk');
 const ora = require('ora');
 const { execSync } = require('child_process');
-const { getProjectConfig, getSkillsForCategories } = require('./prompts');
+const { getProjectConfig, getSkillsForCategories, confirmOverwrite } = require('./prompts');
 const gradient = require('gradient-string');
 const { getRulesList, getAgentsList } = require('./logic/manifest-manager');
 
@@ -19,6 +19,9 @@ async function createProject(projectName, options, predefinedConfig = null) {
 
         // Get configuration
         const config = predefinedConfig || await getProjectConfig(options.skipPrompts, isCurrentDir ? targetName : projectName);
+        // Merge CLI options
+        config.force = options.force; 
+        config.skipPrompts = options.skipPrompts;
 
         // Resolve final project path
         const projectPath = isCurrentDir ? process.cwd() : path.resolve(process.cwd(), config.projectName);
@@ -118,7 +121,17 @@ async function createProject(projectName, options, predefinedConfig = null) {
             config.productType, 
             finalProjectName
         );
-        fs.writeFileSync(path.join(projectPath, 'GEMINI.md'), geminiContent);
+        const rootGeminiPath = path.join(projectPath, 'GEMINI.md');
+        const rootGeminiDecision = await handleCoreFileConflict(rootGeminiPath, 'GEMINI.md', config.force, config.skipPrompts);
+        
+        if (rootGeminiDecision.shouldWrite) {
+            fs.writeFileSync(rootGeminiDecision.targetPath, geminiContent);
+            if (rootGeminiDecision.isBackup) {
+                console.log(chalk.yellow(`  ℹ️  Root GEMINI.md exists, created ${path.basename(rootGeminiDecision.targetPath)}`));
+            } else if (rootGeminiDecision.isOverwrite) {
+                console.log(chalk.green(`  ✓ Overwrote existing Root GEMINI.md`));
+            }
+        }
         
         const stats = {
             rules: rulesToInstall.length,
@@ -136,11 +149,23 @@ async function createProject(projectName, options, predefinedConfig = null) {
 }
 
 // Helper to handle core file conflicts (auto-create backup if exists)
-function handleCoreFileConflict(filePath, fileName) {
+async function handleCoreFileConflict(filePath, fileName, force = false, skipPrompts = false) {
     if (!fs.existsSync(filePath)) {
         return { shouldWrite: true, targetPath: filePath };
     }
 
+    if (force) {
+        return { shouldWrite: true, targetPath: filePath, isOverwrite: true };
+    }
+
+    // Interactive Prompt (Only if prompts are allowed)
+    if (!skipPrompts) {
+        const shouldOverwrite = await confirmOverwrite(fileName);
+        if (shouldOverwrite) {
+            return { shouldWrite: true, targetPath: filePath, isOverwrite: true };
+        }
+    }
+
     // File exists - create backup with .new extension
     const dir = path.dirname(filePath);
     const ext = path.extname(fileName);
@@ -211,13 +236,15 @@ async function copyModularStructure(projectPath, config, rulesList, agentsList)
 
     // 5. Copy GEMINI.md (Core file)
     const geminiPath = path.join(destAgentDir, 'GEMINI.md');
-    const geminiDecision = handleCoreFileConflict(geminiPath, 'GEMINI.md');
+    const geminiDecision = await handleCoreFileConflict(geminiPath, 'GEMINI.md', config.force, config.skipPrompts);
 
     if (geminiDecision.shouldWrite) {
         const geminiContent = generateGeminiMd(config.rules, config.language, config.industryDomain, config.agentName);
         fs.writeFileSync(geminiDecision.targetPath, geminiContent);
         if (geminiDecision.isBackup) {
             console.log(chalk.yellow(`  ℹ️  GEMINI.md exists, created ${path.basename(geminiDecision.targetPath)}`));
+        } else if (geminiDecision.isOverwrite) {
+             console.log(chalk.green(`  ✓ Overwrote existing GEMINI.md`));
         }
     }
 
@@ -225,27 +252,49 @@ async function copyModularStructure(projectPath, config, rulesList, agentsList)
     const startHereSource = path.join(sourceAgentDir, 'START_HERE.md');
     if (fs.existsSync(startHereSource)) {
         const startHereDest = path.join(destAgentDir, 'START_HERE.md');
-        const decision = handleCoreFileConflict(startHereDest, 'START_HERE.md');
+        const decision = await handleCoreFileConflict(startHereDest, 'START_HERE.md', config.force, config.skipPrompts);
         if (decision.shouldWrite) {
             fs.copyFileSync(startHereSource, decision.targetPath);
+             if (decision.isOverwrite) {
+                 console.log(chalk.green(`  ✓ Overwrote existing START_HERE.md`));
+            }
         }
     }
 
     // 7. Copy README, .gitignore
     const files = ['README.md', '.gitignore'];
     const rootDir = path.join(__dirname, '..');
-    files.forEach(file => {
+    
+    for (const file of files) {
         const source = path.join(rootDir, file);
         const dest = path.join(projectPath, file);
-        if (fs.existsSync(source) && !fs.existsSync(dest)) {
-            fs.copyFileSync(source, dest);
+        
+        if (fs.existsSync(source)) {
+            const decision = await handleCoreFileConflict(dest, file, config.force, config.skipPrompts);
+            if (decision.shouldWrite) {
+                fs.copyFileSync(source, decision.targetPath);
+                if (decision.isBackup) {
+                    console.log(chalk.yellow(`  ℹ️  ${file} exists, created ${path.basename(decision.targetPath)}`));
+                } else if (decision.isOverwrite) {
+                    console.log(chalk.green(`  ✓ Overwrote existing ${file}`));
+                }
+            }
         }
-    });
+    }
 
     // 8. Copy RESOURCES.md to .agent/
     const resourcesSource = path.join(sourceAgentDir, 'RESOURCES.md');
     if (fs.existsSync(resourcesSource)) {
-         fs.copyFileSync(resourcesSource, path.join(destAgentDir, 'RESOURCES.md'));
+         const resourcesDest = path.join(destAgentDir, 'RESOURCES.md');
+         const decision = await handleCoreFileConflict(resourcesDest, 'RESOURCES.md', config.force, config.skipPrompts);
+         if (decision.shouldWrite) {
+             fs.copyFileSync(resourcesSource, decision.targetPath);
+             if (decision.isBackup) {
+                 console.log(chalk.yellow(`  ℹ️  RESOURCES.md exists, created ${path.basename(decision.targetPath)}`));
+             } else if (decision.isOverwrite) {
+                 console.log(chalk.green(`  ✓ Overwrote existing RESOURCES.md`));
+             }
+         }
     }
 }
 
@@ -288,10 +337,11 @@ async function copyWorkflows(projectPath, workflows) {
 }
 
 async function generateConfigs(projectPath, config) {
-    // Generate package.json only if it doesn't exist
+    // Generate package.json
     const packageJsonPath = path.join(projectPath, 'package.json');
+    const pkgDecision = await handleCoreFileConflict(packageJsonPath, 'package.json', config.force, config.skipPrompts);
 
-    if (!fs.existsSync(packageJsonPath)) {
+    if (pkgDecision.shouldWrite) {
         const packageJson = {
             name: config.projectName,
             version: '1.0.0',
@@ -307,26 +357,42 @@ async function generateConfigs(projectPath, config) {
         };
 
         fs.writeFileSync(
-            packageJsonPath,
+            pkgDecision.targetPath,
             JSON.stringify(packageJson, null, 2)
         );
-        console.log(chalk.green('  ✓ Created package.json'));
+        if (pkgDecision.isBackup) {
+             console.log(chalk.yellow(`  ℹ️  package.json exists, created ${path.basename(pkgDecision.targetPath)}`));
+        } else if (pkgDecision.isOverwrite || !fs.existsSync(packageJsonPath)) {
+             console.log(chalk.green('  ✓ Created package.json'));
+        }
     }
 
     // Generate .editorconfig
     const editorconfigPath = path.join(projectPath, '.editorconfig');
-    if (!fs.existsSync(editorconfigPath)) {
+    const ecDecision = await handleCoreFileConflict(editorconfigPath, '.editorconfig', config.force, config.skipPrompts);
+
+    if (ecDecision.shouldWrite) {
         const editorConfig = `root = true\n\n[*]\ncharset = utf-8\nend_of_line = lf\ninsert_final_newline = true\nindent_style = space\nindent_size = 2\ntrim_trailing_whitespace = true\n\n[*.md]\ntrim_trailing_whitespace = false\n`;
-        fs.writeFileSync(editorconfigPath, editorConfig);
-        console.log(chalk.green('  ✓ Created .editorconfig'));
+        fs.writeFileSync(ecDecision.targetPath, editorConfig);
+        if (ecDecision.isBackup) {
+             console.log(chalk.yellow(`  ℹ️  .editorconfig exists, created ${path.basename(ecDecision.targetPath)}`));
+        } else if (ecDecision.isOverwrite || !fs.existsSync(editorconfigPath)) {
+             console.log(chalk.green('  ✓ Created .editorconfig'));
+        }
     }
 
     // Generate .gitattributes
     const gitAttributesPath = path.join(projectPath, '.gitattributes');
-    if (!fs.existsSync(gitAttributesPath)) {
+    const gaDecision = await handleCoreFileConflict(gitAttributesPath, '.gitattributes', config.force, config.skipPrompts);
+
+    if (gaDecision.shouldWrite) {
         const gitAttributes = `* text=auto eol=lf\n*.js text eol=lf\n*.sh text eol=lf\nbin/* text eol=lf\n`;
-        fs.writeFileSync(gitAttributesPath, gitAttributes);
-        console.log(chalk.green('  ✓ Created .gitattributes'));
+        fs.writeFileSync(gaDecision.targetPath, gitAttributes);
+        if (gaDecision.isBackup) {
+             console.log(chalk.yellow(`  ℹ️  .gitattributes exists, created ${path.basename(gaDecision.targetPath)}`));
+        } else if (gaDecision.isOverwrite || !fs.existsSync(gitAttributesPath)) {
+             console.log(chalk.green('  ✓ Created .gitattributes'));
+        }
     }
 }
 

package/cli/index.js

@@ -24,6 +24,7 @@ const { checkAndApplyUpdates } = require('./lib/auto-update');
       .argument('[project-name]', 'Name of the project', '.')
       .option('-t, --template <type>', 'Project template (minimal, standard, full)', 'standard')
       .option('-s, --skip-prompts', 'Skip interactive prompts and use defaults')
+      .option('-f, --force', 'Overwrite existing configuration files')
       .action(async (projectName, options) => {
         await createProject(projectName, options);
       });

package/cli/prompts.js

@@ -184,8 +184,19 @@ async function getProjectConfig(skipPrompts = false, predefinedName = null) {
   return { ...responses, ...settings, skillCategories: Array.from(allSkills) };
 }
 
+async function confirmOverwrite(fileName) {
+  const response = await prompts({
+    type: 'confirm',
+    name: 'value',
+    message: chalk.yellow(`⚠️  File "${fileName}" already exists. Overwrite? / File đã tồn tại. Ghi đè?`),
+    initial: false
+  });
+  return response.value;
+}
+
 module.exports = {
   getProjectConfig,
   getSkillsForCategories,
-  skillCategories
+  skillCategories,
+  confirmOverwrite
 };

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "antigravity-ide",
-  "version": "4.0.5",
+  "version": "4.0.6",
   "description": "The First AI-Native IDE designed for Vibe Coding & Agentic Workflow.",
+  "homepage": "https://antigravity-ide-cli.vercel.app/",
   "main": "cli/index.js",
   "bin": {
     "antigravity": "./cli/index.js",

package/setup.js

@@ -8,6 +8,7 @@ const chalk = require('chalk');
 const gradient = require('gradient-string');
 const boxen = require('boxen');
 const prompts = require('prompts');
+const packageJson = require('./package.json');
 
 const GLOBAL_DIR = path.join(os.homedir(), '.antigravity');
 const SOURCE_DIR = path.join(__dirname, '.agent');
@@ -30,7 +31,7 @@ async function setup() {
     
     console.log(gradient.rainbow.multiline(branding));
     console.log(gradient.atlas('━'.repeat(60)));
-    console.log(chalk.gray(`  Google Antigravity • Global Setup Wizard • v3.5.61`));
+    console.log(chalk.gray(`  Google Antigravity • Global Setup Wizard • v${packageJson.version}`));
     console.log(chalk.gray('  Developed with 💡 by Dokhacgiakhoa'));
     console.log(gradient.atlas('━'.repeat(60)) + '\n');
     console.log(chalk.bold.hex('#00ffee')('🚀 Antigravity Global Setup Starting...\n'));