antigravity-seo-kit 1.2.8 → 1.3.0

package/lib/downloader.js

@@ -4,6 +4,7 @@ const https = require('https');
 const zlib = require('zlib');
 const fs = require('fs');
 const path = require('path');
+const { smartMergeJsonFile } = require('./utils');
 
 // ─── Download ───────────────────────────────────────────────────────────────
 
@@ -145,8 +146,24 @@ function extractTarGz(gzBuffer, targetDir) {
       fs.mkdirSync(targetPath, { recursive: true });
     } else if (typeFlag === ASCII_0 || typeFlag === 0) {
       // Regular file
+      const isConfigJson = fullName.endsWith('.json') &&
+        (fullName.startsWith('config/') ||
+         fullName.startsWith('.agent/config/') ||
+         fullName.includes('/config/'));
+
       fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-      fs.writeFileSync(targetPath, tarBuffer.subarray(offset, offset + size));
+
+      if (isConfigJson && fs.existsSync(targetPath)) {
+        const tempPath = targetPath + '.tmp';
+        fs.writeFileSync(tempPath, tarBuffer.subarray(offset, offset + size));
+        smartMergeJsonFile(tempPath, targetPath);
+        try {
+          fs.unlinkSync(tempPath);
+        } catch (e) {}
+      } else {
+        fs.writeFileSync(targetPath, tarBuffer.subarray(offset, offset + size));
+      }
+
       files.push(fullName);
       count++;
     }

package/lib/installer.js

@@ -457,12 +457,14 @@ async function installPlugin(licenseKey) {
     version: PACKAGE_VERSION,
     description: "Professional SEO Analysis Toolkit for Google Antigravity AI Agent — 44 specialized skills covering technical audit, E-E-A-T, schema, GEO, local SEO & more",
     author: {
-      name: "Antigravity SEO Kit"
+      name: "Antigravity SEO Kit",
+      email: "admin@solann.io",
     },
+    repository: "https://solann.io/antigravity-seo-kit",
     license: "SEE LICENSE IN LICENSE",
     keywords: [
       "seo",
-      "universal-seo-kit",
+      "agentic-seo",
       "ai-agent",
       "antigravity",
       "seo-geo",
@@ -528,7 +530,7 @@ function setupWorkspace(cwd) {
     // Only copy necessary directories. agents and rules are loaded globally via the plugin.
     // skills are copied but filtered to exclude .md files to save space and avoid duplicate prompts/instructions.
     const directoriesToCopy = ['.shared', 'config', 'dashboard', 'docs', 'scripts', 'workflows'];
-    const filesToCopy = ['ARCHITECTURE.md'];
+    const filesToCopy = ['seo-architecture.md'];
 
     let count = 0;
     for (const dir of directoriesToCopy) {
@@ -541,6 +543,8 @@ function setupWorkspace(cwd) {
             overwrite: true,
             filter: (filePath) => !filePath.endsWith('.md')
           });
+        } else if (dir === 'config') {
+          count += copyRecursive(src, dest, { overwrite: true, mergeJson: true });
         } else {
           count += copyRecursive(src, dest, { overwrite: true });
         }

package/lib/utils.js

@@ -88,11 +88,80 @@ function spinner(message) {
 
 // ─── File Operations ────────────────────────────────────────────────────────
 
+/**
+ * Check if a value is a plain object.
+ */
+function isObject(item) {
+  return (item && typeof item === 'object' && !Array.isArray(item));
+}
+
+/**
+ * Recursively merge two JSON objects (deep merge).
+ * Prioritizes properties from sourceObj (user config) while preserving/appending new properties from targetObj (template config).
+ */
+function deepMergeJson(targetObj, sourceObj) {
+  const output = { ...targetObj };
+  if (isObject(targetObj) && isObject(sourceObj)) {
+    for (const key of Object.keys(sourceObj)) {
+      if (isObject(sourceObj[key])) {
+        if (!(key in targetObj)) {
+          output[key] = sourceObj[key];
+        } else {
+          output[key] = deepMergeJson(targetObj[key], sourceObj[key]);
+        }
+      } else {
+        output[key] = sourceObj[key];
+      }
+    }
+  }
+  return output;
+}
+
+/**
+ * Merges JSON file from srcPath (new template) into destPath (existing user config) safely.
+ */
+function smartMergeJsonFile(srcPath, destPath) {
+  if (!fs.existsSync(srcPath)) return;
+
+  if (!fs.existsSync(destPath)) {
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    fs.copyFileSync(srcPath, destPath);
+    return;
+  }
+
+  let newJson;
+  try {
+    newJson = JSON.parse(fs.readFileSync(srcPath, 'utf-8'));
+  } catch (err) {
+    fs.copyFileSync(srcPath, destPath);
+    return;
+  }
+
+  let oldJson;
+  try {
+    oldJson = JSON.parse(fs.readFileSync(destPath, 'utf-8'));
+  } catch (err) {
+    const bakPath = destPath + '.bak';
+    try {
+      fs.copyFileSync(destPath, bakPath);
+      warn(`File cấu hình bị lỗi cú pháp JSON và đã được sao lưu thành: ${path.basename(bakPath)}`);
+    } catch (bakErr) {
+      warn(`Không thể sao lưu file cấu hình lỗi: ${bakErr.message}`);
+    }
+    fs.copyFileSync(srcPath, destPath);
+    return;
+  }
+
+  const merged = deepMergeJson(newJson, oldJson);
+  fs.writeFileSync(destPath, JSON.stringify(merged, null, 2), 'utf-8');
+}
+
 /**
  * Recursively copy a directory, merging with existing content.
  * Does not overwrite existing files unless `overwrite` is true.
+ * Supports smart JSON merging if `mergeJson` is enabled.
  */
-function copyRecursive(src, dest, { overwrite = false, fileCallback = null, filter = null } = {}) {
+function copyRecursive(src, dest, { overwrite = false, fileCallback = null, filter = null, mergeJson = false } = {}) {
   if (!fs.existsSync(src)) return 0;
   if (filter && !filter(src)) return 0;
 
@@ -105,12 +174,17 @@ function copyRecursive(src, dest, { overwrite = false, fileCallback = null, filt
       count += copyRecursive(
         path.join(src, entry),
         path.join(dest, entry),
-        { overwrite, fileCallback, filter }
+        { overwrite, fileCallback, filter, mergeJson }
       );
     }
   } else {
     fs.mkdirSync(path.dirname(dest), { recursive: true });
-    if (overwrite || !fs.existsSync(dest)) {
+    const isJson = src.endsWith('.json');
+    if (isJson && mergeJson && fs.existsSync(dest)) {
+      smartMergeJsonFile(src, dest);
+      count = 1;
+      if (fileCallback) fileCallback(dest);
+    } else if (overwrite || !fs.existsSync(dest)) {
       fs.copyFileSync(src, dest);
       count = 1;
       if (fileCallback) fileCallback(dest);
@@ -299,5 +373,7 @@ module.exports = {
   writeLicenseFile,
   removeLicenseFile,
   LICENSE_FILE,
-  PACKAGE_VERSION: '1.2.8',
+  PACKAGE_VERSION: '1.3.0',
+  deepMergeJson,
+  smartMergeJsonFile,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antigravity-seo-kit",
-  "version": "1.2.8",
+  "version": "1.3.0",
   "description": "Professional SEO Analysis Toolkit for Google Antigravity AI Agent — 44 specialized skills covering technical audit, E-E-A-T, schema, GEO, local SEO & more",
   "main": "lib/installer.js",
   "bin": {