antigravity-seo-kit 1.2.6 → 1.2.8

package/README.md

@@ -4,6 +4,24 @@
 
 ## ⚡ Quick Install
 
+You can install SEO Kit either globally as an Antigravity plugin (recommended) or locally into a specific workspace.
+
+### 1. Global Plugin Installation (Recommended)
+This installs SEO Kit globally into your Antigravity config directory so it is available across all workspaces.
+
+```bash
+npx antigravity-seo-kit install-plugin --key=SK-XXXX-XXXX-XXXX
+# OR: npx antigravity-seo-kit install --global --key=SK-XXXX-XXXX-XXXX
+```
+
+When you start work in a new workspace, run the following command to sync the agent rules and folders locally:
+```bash
+npx antigravity-seo-kit setup-workspace
+```
+
+### 2. Local Workspace Installation
+This installs SEO Kit files directly into your current workspace.
+
 ```bash
 npx antigravity-seo-kit install --key=SK-XXXX-XXXX-XXXX
 ```
@@ -25,7 +43,13 @@ npx antigravity-seo-kit install --key=SK-XXXX-XXXX-XXXX
 ## CLI Commands
 
 ```bash
-# Install SEO Kit
+# Install globally as a plugin (recommended)
+npx antigravity-seo-kit install-plugin --key=SK-XXXX-XXXX-XXXX
+
+# Replicate .agent config directory from global plugin to local workspace
+npx antigravity-seo-kit setup-workspace
+
+# Install locally into current workspace
 npx antigravity-seo-kit install --key=SK-XXXX-XXXX-XXXX
 
 # Update to latest version

package/bin/cli.js

@@ -42,7 +42,36 @@ async function main() {
           error('Invalid key format. Expected: SK-XXXX-XXXX-XXXX');
           process.exit(1);
         }
-        await installer.install(key, cwd);
+        if (getFlag('global')) {
+          await installer.installPlugin(key);
+        } else {
+          await installer.install(key, cwd);
+        }
+        break;
+      }
+
+      case 'install-plugin': {
+        showBanner();
+        const key = getArg('key');
+        if (!key) {
+          error('License key required.');
+          console.log('');
+          console.log(`  Usage: ${colorize('cyan', 'npx antigravity-seo-kit install-plugin --key=SK-XXXX-XXXX-XXXX')}`);
+          console.log('');
+          console.log(`  Purchase: ${colorize('cyan', 'https://antigravity-seokit.solann.io/')}`);
+          process.exit(1);
+        }
+        if (!isValidKeyFormat(key)) {
+          error('Invalid key format. Expected: SK-XXXX-XXXX-XXXX');
+          process.exit(1);
+        }
+        await installer.installPlugin(key);
+        break;
+      }
+
+      case 'setup-workspace': {
+        showBanner();
+        await installer.setupWorkspace(cwd);
         break;
       }
 

package/lib/installer.js

@@ -4,9 +4,9 @@ const fs = require('fs');
 const path = require('path');
 const {
   success, error, warn, info, step, file, dir,
-  spinner, removeRecursive,
+  spinner, removeRecursive, copyRecursive,
   writeLicenseFile, removeLicenseFile, readLicenseFile,
-  colorize, PACKAGE_VERSION,
+  colorize, PACKAGE_VERSION, getGlobalPluginDir,
 } = require('./utils');
 const { generateFingerprint, getDeviceName } = require('./fingerprint');
 const api = require('./api');
@@ -383,6 +383,193 @@ function maskKey(key) {
   return key.substring(0, 7) + '*'.repeat(key.length - 11) + key.substring(key.length - 4);
 }
 
+async function installPlugin(licenseKey) {
+  const globalPluginDir = getGlobalPluginDir();
+  const deviceId = generateFingerprint();
+  const deviceName = getDeviceName();
+
+  // Step 1: Verify license
+  const spin = spinner('Verifying license key...').start();
+  let verifyResult;
+  try {
+    verifyResult = await api.verifyLicense(licenseKey, deviceId, deviceName);
+    spin.succeed('License verified!');
+  } catch (err) {
+    spin.fail('License verification failed');
+    const errCode = err.responseData?.error?.code || '';
+    if (errCode.includes('DeviceLimitReached') || err.message.includes('Device limit')) {
+      console.log('');
+      error(`Device limit reached. You have ${err.responseData?.error?.data?.current || '?'}/${err.responseData?.error?.data?.max || 3} devices activated.`);
+      console.log('');
+      info('Run the following to manage your devices:');
+      console.log(`  ${colorize('gray', 'npx antigravity-seo-kit devices')}`);
+      console.log(`  ${colorize('gray', 'npx antigravity-seo-kit devices remove <deviceId>')}`);
+    } else if (err.isNotFound || errCode.includes('LicenseNotFound')) {
+      error('Invalid license key. Please check your key and try again.');
+      console.log(`  Purchase: ${colorize('cyan', 'https://antigravitykit.solann.io/')}`);
+    } else if (errCode.includes('LicenseExpired')) {
+      error('License has expired. Please renew your license.');
+      console.log(`  Renew: ${colorize('cyan', 'https://antigravitykit.solann.io/')}`);
+    } else if (errCode.includes('LicenseSuspended') || errCode.includes('LicenseRevoked')) {
+      error('License has been suspended or revoked. Contact support.');
+    } else {
+      error(err.message);
+    }
+    process.exit(1);
+  }
+
+  // Ensure global plugin directory exists
+  fs.mkdirSync(globalPluginDir, { recursive: true });
+
+  // Step 2: Download assets from server
+  console.log('');
+  const spinDl = spinner('Downloading SEO Kit assets...').start();
+  let downloadResult;
+  try {
+    const downloadUrl = api.getAssetsDownloadUrl(PACKAGE_VERSION);
+    downloadResult = await downloadAndExtract(downloadUrl, licenseKey, globalPluginDir);
+    spinDl.succeed(`Downloaded and installed ${downloadResult.count} files`);
+  } catch (err) {
+    spinDl.fail('Asset download failed');
+    error(err.message);
+    info('If this persists, contact support@solann.io');
+    process.exit(1);
+  }
+
+  // Step 3: Move files/folders inside the `.agent/` subdirectory up to the plugin root
+  const agentDir = path.join(globalPluginDir, '.agent');
+  if (fs.existsSync(agentDir)) {
+    const entries = fs.readdirSync(agentDir);
+    for (const entry of entries) {
+      const srcPath = path.join(agentDir, entry);
+      const destPath = path.join(globalPluginDir, entry);
+      if (fs.existsSync(destPath)) {
+        removeRecursive(destPath);
+      }
+      fs.renameSync(srcPath, destPath);
+    }
+    removeRecursive(agentDir);
+  }
+
+  // Step 4: Generate plugin.json and installed_version.json
+  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",
+    author: {
+      name: "Antigravity SEO Kit"
+    },
+    license: "SEE LICENSE IN LICENSE",
+    keywords: [
+      "seo",
+      "universal-seo-kit",
+      "ai-agent",
+      "antigravity",
+      "seo-geo",
+      "seo-audit",
+      "seo-toolkit",
+      "agent-skills",
+      "seo-analysis",
+      "technical-seo",
+      "eeat"
+    ]
+  };
+  fs.writeFileSync(path.join(globalPluginDir, 'plugin.json'), JSON.stringify(pluginJson, null, 2), 'utf-8');
+  fs.writeFileSync(path.join(globalPluginDir, 'installed_version.json'), JSON.stringify({ version: PACKAGE_VERSION }), 'utf-8');
+
+  // Step 5: Save global license info + manifest
+  const LICENSE_FILE = '.seo-kit-license';
+  writeLicenseFile(globalPluginDir, {
+    key: licenseKey,
+    deviceId,
+    deviceName,
+    version: PACKAGE_VERSION,
+    installedAt: new Date().toISOString(),
+    plan: verifyResult?.license?.planName || verifyResult?.license?.plan || 'unknown',
+    installedFiles: downloadResult.files.map(f => f.replace(/^\.agent\//, '')),
+  });
+
+  // Done!
+  console.log('');
+  console.log(colorize('green', '═══════════════════════════════════════════════════════'));
+  success(`SEO Kit v${PACKAGE_VERSION} installed successfully as a global Antigravity plugin!`);
+  console.log(colorize('green', '═══════════════════════════════════════════════════════'));
+  console.log('');
+
+  info('Next steps:');
+  console.log(`  ${colorize('yellow', '1.')} Restart or open any workspace in ${colorize('bold', 'Google Antigravity')}`);
+  console.log(`  ${colorize('yellow', '2.')} The SEO Kit plugin will automatically load globally.`);
+  console.log('');
+
+  if (verifyResult?.devicesUsed != null) {
+    info(`Devices: ${verifyResult.devicesUsed}/${verifyResult.maxDevices} activated`);
+  }
+  console.log('');
+}
+
+function setupWorkspace(cwd) {
+  const globalDir = getGlobalPluginDir();
+  const localAgentDir = path.join(cwd, '.agent');
+
+  if (fs.existsSync(localAgentDir)) {
+    return;
+  }
+
+  if (!fs.existsSync(globalDir)) {
+    error('Global SEO Kit plugin is not installed.');
+    info('Please run: npx antigravity-seo-kit install-plugin --key=YOUR_KEY');
+    process.exit(1);
+  }
+
+  const spin = spinner('Replicating .agent directory to local workspace...').start();
+  try {
+    fs.mkdirSync(localAgentDir, { recursive: true });
+
+    // 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'];
+
+    let count = 0;
+    for (const dir of directoriesToCopy) {
+      const src = path.join(globalDir, dir);
+      const dest = path.join(localAgentDir, dir);
+      if (fs.existsSync(src)) {
+        if (dir === 'skills') {
+          // Keep scripts and assets, but exclude instruction/documentation markdown files
+          count += copyRecursive(src, dest, {
+            overwrite: true,
+            filter: (filePath) => !filePath.endsWith('.md')
+          });
+        } else {
+          count += copyRecursive(src, dest, { overwrite: true });
+        }
+      }
+    }
+    for (const file of filesToCopy) {
+      const src = path.join(globalDir, file);
+      const dest = path.join(localAgentDir, file);
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, dest);
+        count++;
+      }
+    }
+
+    const LICENSE_FILE = '.seo-kit-license';
+    const globalLicense = path.join(globalDir, LICENSE_FILE);
+    const localLicense = path.join(cwd, LICENSE_FILE);
+    if (fs.existsSync(globalLicense) && !fs.existsSync(localLicense)) {
+      fs.copyFileSync(globalLicense, localLicense);
+    }
+
+    spin.succeed(`Workspace setup complete! Copied ${count} files to .agent/`);
+  } catch (err) {
+    spin.fail('Workspace setup failed');
+    error(err.message);
+    process.exit(1);
+  }
+}
+
 // ─── Exports ────────────────────────────────────────────────────────────────
 
 module.exports = {
@@ -392,4 +579,6 @@ module.exports = {
   status,
   devices,
   deviceRemove,
+  installPlugin,
+  setupWorkspace,
 };

package/lib/utils.js

@@ -92,8 +92,9 @@ function spinner(message) {
  * Recursively copy a directory, merging with existing content.
  * Does not overwrite existing files unless `overwrite` is true.
  */
-function copyRecursive(src, dest, { overwrite = false, fileCallback = null } = {}) {
+function copyRecursive(src, dest, { overwrite = false, fileCallback = null, filter = null } = {}) {
   if (!fs.existsSync(src)) return 0;
+  if (filter && !filter(src)) return 0;
 
   let count = 0;
 
@@ -104,7 +105,7 @@ function copyRecursive(src, dest, { overwrite = false, fileCallback = null } = {
       count += copyRecursive(
         path.join(src, entry),
         path.join(dest, entry),
-        { overwrite, fileCallback }
+        { overwrite, fileCallback, filter }
       );
     }
   } else {
@@ -185,15 +186,19 @@ function showHelp() {
   console.log(`${colorize('bold', 'Usage:')} npx antigravity-seo-kit <command> [options]`);
   console.log('');
   console.log(`${colorize('bold', 'Commands:')}`);
-  console.log(`  ${colorize('green', 'install')}  --key=SK-XXXX-XXXX-XXXX   Install SEO Kit into current workspace`);
-  console.log(`  ${colorize('green', 'update')}                             Update to latest version`);
-  console.log(`  ${colorize('green', 'uninstall')}                          Remove SEO Kit from workspace`);
-  console.log(`  ${colorize('green', 'status')}                             Show license & installation info`);
-  console.log(`  ${colorize('green', 'devices')}                            List activated devices`);
-  console.log(`  ${colorize('green', 'devices remove')} <deviceId>          Remove a device from license`);
+  console.log(`  ${colorize('green', 'install')}         --key=SK-XXXX-XXXX-XXXX   Install SEO Kit into current workspace`);
+  console.log(`  ${colorize('green', 'install-plugin')}  --key=SK-XXXX-XXXX-XXXX   Install SEO Kit globally as an Antigravity plugin`);
+  console.log(`  ${colorize('green', 'setup-workspace')}                            Replicate .agent config directory to current workspace`);
+  console.log(`  ${colorize('green', 'update')}                                    Update to latest version`);
+  console.log(`  ${colorize('green', 'uninstall')}                                 Remove SEO Kit from workspace`);
+  console.log(`  ${colorize('green', 'status')}                                    Show license & installation info`);
+  console.log(`  ${colorize('green', 'devices')}                                   List activated devices`);
+  console.log(`  ${colorize('green', 'devices remove')} <deviceId>                 Remove a device from license`);
   console.log('');
   console.log(`${colorize('bold', 'Examples:')}`);
   console.log(`  ${colorize('gray', 'npx antigravity-seo-kit install --key=SK-A1B2-C3D4-E5F6')}`);
+  console.log(`  ${colorize('gray', 'npx antigravity-seo-kit install-plugin --key=SK-A1B2-C3D4-E5F6')}`);
+  console.log(`  ${colorize('gray', 'npx antigravity-seo-kit setup-workspace')}`);
   console.log(`  ${colorize('gray', 'npx antigravity-seo-kit devices')}`);
   console.log(`  ${colorize('gray', 'npx antigravity-seo-kit devices remove a1b2c3d4')}`);
   console.log('');
@@ -205,8 +210,15 @@ function showHelp() {
 
 const LICENSE_FILE = '.seo-kit-license';
 
+function getGlobalPluginDir() {
+  return path.join(require('os').homedir(), '.gemini', 'config', 'plugins', 'antigravity-seo-kit');
+}
+
 function readLicenseFile(cwd) {
-  const licensePath = path.join(cwd, LICENSE_FILE);
+  let licensePath = path.join(cwd, LICENSE_FILE);
+  if (!fs.existsSync(licensePath)) {
+    licensePath = path.join(getGlobalPluginDir(), LICENSE_FILE);
+  }
   if (!fs.existsSync(licensePath)) return null;
   try {
     const data = JSON.parse(fs.readFileSync(licensePath, 'utf-8'));
@@ -282,9 +294,10 @@ module.exports = {
   isValidKeyFormat,
   showBanner,
   showHelp,
+  getGlobalPluginDir,
   readLicenseFile,
   writeLicenseFile,
   removeLicenseFile,
   LICENSE_FILE,
-  PACKAGE_VERSION: '1.2.6',
+  PACKAGE_VERSION: '1.2.8',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antigravity-seo-kit",
-  "version": "1.2.6",
+  "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",
   "main": "lib/installer.js",
   "bin": {
@@ -18,6 +18,8 @@
     "cursor",
     "gemini-cli",
     "antigravity",
+    "antigravity-plugin",
+    "antigravity-seo-kit-plugin",
     "seo-geo",
     "seo-audit",
     "seo-toolkit",
@@ -31,5 +33,10 @@
   "homepage": "https://antigravityseokit.solann.io/",
   "engines": {
     "node": ">=18"
+  },
+  "scripts": {
+    "pack-assets": "node scripts/pack-assets.js",
+    "pack-npm": "npm pack --pack-destination dist",
+    "pack-all": "node scripts/pack-assets.js && npm pack --pack-destination dist"
   }
 }