antigravity-seo-kit 1.2.8 → 2.0.1

package/README.md

@@ -1,6 +1,6 @@
 # SEO Kit for Google Antigravity
 
-> **Professional SEO Analysis Toolkit** — Comprehensive AI-powered SEO analysis with specialized skills for technical audit, E-E-A-T, schema markup, GEO optimization, and more. Built for [Google Antigravity](https://deepmind.google/technologies/antigravity/) AI agent platform.
+> **Professional Agentic SEO Platform** — Comprehensive autonomous AI-powered SEO analysis with specialized skills for technical audit, E-E-A-T, schema markup, GEO optimization, and more. Built for [Google Antigravity 2](https://deepmind.google/technologies/antigravity/) AI agent platform.
 
 ## ⚡ Quick Install
 
@@ -30,15 +30,14 @@ npx antigravity-seo-kit install --key=SK-XXXX-XXXX-XXXX
 
 ## Features
 
-- **Full SEO Lifecycle** — Onboard, Research, Audit, Strategy, Execute, Monitor
-- **Technical SEO Audit** — Crawlability, indexability, Core Web Vitals, and more
-- **E-E-A-T Content Quality** analysis aligned with latest Google QRG
-- **Schema Markup** — Detection, validation, and JSON-LD generation
-- **AI Search Optimization (GEO)** — Visibility in AI Overviews, ChatGPT, Perplexity
-- **Content Strategy** — Gap analysis, topical authority, entity SEO
-- **Local SEO** — GBP, NAP consistency, Maps intelligence
-- **Auto-Fix Generator** — Ready-to-use meta tags, schema, robots.txt, redirects
-- **Extension System** for third-party SEO data providers
+- **Autonomous Auto-Pilot Mode (`/seo-auto-run`)** — Runs full SEO lifecycle sequentially without manual intervention, outputting structured reports and directly applying fixes.
+- **Dynamic Multi-Agent Auto-Routing** — Smart routing delegating tasks to 23 specialized directors across Technical, Content, Off-Page, and R&D departments.
+- **Full SEO Lifecycle** — Phase-aware execution covering Onboard, Research, Audit, Strategy, Execute, and Monitor.
+- **Smart Configuration Protection** — Smart Deep Merge automatically preserves user-specific API keys and custom settings during package updates.
+- **Generative Engine Optimization (GEO)** — Optimizes and monitors content visibility across AI Search engines like Google AIO, ChatGPT, and Perplexity.
+- **Technical SEO Auto-Fixes** — Deep audits for crawlability, indexability, Core Web Vitals, and auto-generates schema, meta tags, redirects, and robots.txt.
+- **E-E-A-T & Topical Authority** — Content quality evaluation mapped to Google Quality Raters Guidelines, semantic clustering, and Information Gain analysis.
+- **Multi-Client Dashboard & MCP Server** — Visual HTML tracking for multiple domains coupled with a native Model Context Protocol server for direct A2A agent integration.
 
 ## CLI Commands
 
@@ -70,7 +69,7 @@ npx antigravity-seo-kit uninstall --confirm
 
 - **Node.js** ≥ 18 (for CLI installer)
 - **Python** ≥ 3.11 (for analysis scripts)
-- **Google Antigravity** or compatible AI agent platform
+- **Google Antigravity 2** or compatible AI agent platform
 
 ## License Management
 

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

@@ -455,14 +455,16 @@ async function installPlugin(licenseKey) {
   const pluginJson = {
     name: "antigravity-seo-kit",
     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",
+    description: "Professional Agentic SEO Platform for Google Antigravity 2 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);
@@ -171,7 +245,7 @@ function isValidKeyFormat(key) {
 const BANNER = `
 ${colorize('cyan', '╔═══════════════════════════════════════════════════════╗')}
 ${colorize('cyan', '║')}  ${colorize('bold', '🔍 SEO Kit for Google Antigravity')}                   ${colorize('cyan', '║')}
-${colorize('cyan', '║')}  ${colorize('dim', 'v1.2.6 — Professional SEO Analysis Toolkit')}         ${colorize('cyan', '║')}
+${colorize('cyan', '║')}  ${colorize('dim', 'v2.0.1 — Professional Agentic SEO Platform')}         ${colorize('cyan', '║')}
 ${colorize('cyan', '╚═══════════════════════════════════════════════════════╝')}
 `;
 
@@ -299,5 +373,7 @@ module.exports = {
   writeLicenseFile,
   removeLicenseFile,
   LICENSE_FILE,
-  PACKAGE_VERSION: '1.2.8',
+  PACKAGE_VERSION: '2.0.1',
+  deepMergeJson,
+  smartMergeJsonFile,
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "antigravity-seo-kit",
-  "version": "1.2.8",
-  "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",
+  "version": "2.0.1",
+  "description": "Professional Agentic SEO Platform for Google Antigravity 2 AI Agent — 44 specialized skills covering technical audit, E-E-A-T, schema, GEO, local SEO & more",
   "main": "lib/installer.js",
   "bin": {
     "antigravity-seo-kit": "bin/cli.js"