antigravity-seo-kit 2.0.0

package/lib/utils.js

@@ -0,0 +1,254 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+// ─── ANSI Colors ────────────────────────────────────────────────────────────
+
+const SUPPORTS_COLOR = process.stdout.isTTY && !process.env.NO_COLOR;
+
+const colors = {
+  reset:   SUPPORTS_COLOR ? '\x1b[0m'  : '',
+  bold:    SUPPORTS_COLOR ? '\x1b[1m'  : '',
+  dim:     SUPPORTS_COLOR ? '\x1b[2m'  : '',
+  red:     SUPPORTS_COLOR ? '\x1b[31m' : '',
+  green:   SUPPORTS_COLOR ? '\x1b[32m' : '',
+  yellow:  SUPPORTS_COLOR ? '\x1b[33m' : '',
+  blue:    SUPPORTS_COLOR ? '\x1b[34m' : '',
+  magenta: SUPPORTS_COLOR ? '\x1b[35m' : '',
+  cyan:    SUPPORTS_COLOR ? '\x1b[36m' : '',
+  white:   SUPPORTS_COLOR ? '\x1b[37m' : '',
+  gray:    SUPPORTS_COLOR ? '\x1b[90m' : '',
+};
+
+function colorize(color, text) {
+  return `${colors[color]}${text}${colors.reset}`;
+}
+
+// ─── Formatted Output ───────────────────────────────────────────────────────
+
+function success(msg) { console.log(`${colorize('green', '✅')} ${msg}`); }
+function error(msg)   { console.error(`${colorize('red', '❌')} ${msg}`); }
+function warn(msg)    { console.log(`${colorize('yellow', '⚠️')}  ${msg}`); }
+function info(msg)    { console.log(`${colorize('cyan', 'ℹ️')}  ${msg}`); }
+function step(msg)    { console.log(`${colorize('blue', '→')} ${msg}`); }
+function file(msg)    { console.log(`  ${colorize('dim', '📄')} ${colorize('gray', msg)}`); }
+function dir(msg)     { console.log(`  ${colorize('dim', '📁')} ${colorize('gray', msg)}`); }
+
+// ─── Spinner ────────────────────────────────────────────────────────────────
+
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+
+class Spinner {
+  constructor(message) {
+    this.message = message;
+    this.frameIndex = 0;
+    this.interval = null;
+  }
+
+  start() {
+    if (!SUPPORTS_COLOR) {
+      console.log(`⏳ ${this.message}`);
+      return this;
+    }
+    process.stdout.write('\x1b[?25l'); // hide cursor
+    this.interval = setInterval(() => {
+      const frame = SPINNER_FRAMES[this.frameIndex % SPINNER_FRAMES.length];
+      process.stdout.write(`\r${colorize('cyan', frame)} ${this.message}`);
+      this.frameIndex++;
+    }, 80);
+    return this;
+  }
+
+  succeed(msg) {
+    this._stop();
+    success(msg || this.message);
+  }
+
+  fail(msg) {
+    this._stop();
+    error(msg || this.message);
+  }
+
+  _stop() {
+    if (this.interval) {
+      clearInterval(this.interval);
+      this.interval = null;
+    }
+    if (SUPPORTS_COLOR) {
+      process.stdout.write('\r\x1b[K'); // clear line
+      process.stdout.write('\x1b[?25h'); // show cursor
+    }
+  }
+}
+
+function spinner(message) {
+  return new Spinner(message);
+}
+
+// ─── File Operations ────────────────────────────────────────────────────────
+
+/**
+ * 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 } = {}) {
+  if (!fs.existsSync(src)) return 0;
+
+  let count = 0;
+
+  if (fs.statSync(src).isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src);
+    for (const entry of entries) {
+      count += copyRecursive(
+        path.join(src, entry),
+        path.join(dest, entry),
+        { overwrite, fileCallback }
+      );
+    }
+  } else {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    if (overwrite || !fs.existsSync(dest)) {
+      fs.copyFileSync(src, dest);
+      count = 1;
+      if (fileCallback) fileCallback(dest);
+    }
+  }
+
+  return count;
+}
+
+/**
+ * Recursively remove a directory and all its contents.
+ */
+function removeRecursive(target) {
+  if (!fs.existsSync(target)) return 0;
+
+  let count = 0;
+
+  if (fs.statSync(target).isDirectory()) {
+    const entries = fs.readdirSync(target);
+    for (const entry of entries) {
+      count += removeRecursive(path.join(target, entry));
+    }
+    fs.rmdirSync(target);
+  } else {
+    fs.unlinkSync(target);
+    count = 1;
+  }
+
+  return count;
+}
+
+/**
+ * Count files in a directory recursively.
+ */
+function countFiles(dir) {
+  if (!fs.existsSync(dir)) return 0;
+  let count = 0;
+  if (fs.statSync(dir).isDirectory()) {
+    for (const entry of fs.readdirSync(dir)) {
+      count += countFiles(path.join(dir, entry));
+    }
+  } else {
+    count = 1;
+  }
+  return count;
+}
+
+// ─── License Key Validation ────────────────────────────────────────────────
+
+const LICENSE_KEY_REGEX = /^SK-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/;
+
+function isValidKeyFormat(key) {
+  return LICENSE_KEY_REGEX.test(key);
+}
+
+// ─── Banner ─────────────────────────────────────────────────────────────────
+
+const BANNER = `
+${colorize('cyan', '╔═══════════════════════════════════════════════════════╗')}
+${colorize('cyan', '║')}  ${colorize('bold', '🔍 SEO Kit for Google Antigravity')}                   ${colorize('cyan', '║')}
+${colorize('cyan', '║')}  ${colorize('dim', 'v2.0.0 — Professional SEO Analysis Toolkit')}         ${colorize('cyan', '║')}
+${colorize('cyan', '╚═══════════════════════════════════════════════════════╝')}
+`;
+
+function showBanner() {
+  console.log(BANNER);
+}
+
+// ─── Help ───────────────────────────────────────────────────────────────────
+
+function showHelp() {
+  showBanner();
+  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('');
+  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 devices')}`);
+  console.log(`  ${colorize('gray', 'npx antigravity-seo-kit devices remove a1b2c3d4')}`);
+  console.log('');
+  console.log(`${colorize('bold', 'Purchase:')} https://github.com/nguyendev/seo-kit`);
+  console.log('');
+}
+
+// ─── Config File ────────────────────────────────────────────────────────────
+
+const LICENSE_FILE = '.seo-kit-license';
+
+function readLicenseFile(cwd) {
+  const licensePath = path.join(cwd, LICENSE_FILE);
+  if (!fs.existsSync(licensePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(licensePath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeLicenseFile(cwd, data) {
+  const licensePath = path.join(cwd, LICENSE_FILE);
+  fs.writeFileSync(licensePath, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+function removeLicenseFile(cwd) {
+  const licensePath = path.join(cwd, LICENSE_FILE);
+  if (fs.existsSync(licensePath)) {
+    fs.unlinkSync(licensePath);
+  }
+}
+
+// ─── Exports ────────────────────────────────────────────────────────────────
+
+module.exports = {
+  colors,
+  colorize,
+  success,
+  error,
+  warn,
+  info,
+  step,
+  file,
+  dir,
+  spinner,
+  copyRecursive,
+  removeRecursive,
+  countFiles,
+  isValidKeyFormat,
+  showBanner,
+  showHelp,
+  readLicenseFile,
+  writeLicenseFile,
+  removeLicenseFile,
+  LICENSE_FILE,
+  PACKAGE_VERSION: '2.0.0',
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "antigravity-seo-kit",
+  "version": "2.0.0",
+  "description": "Professional SEO Analysis Toolkit for Google Antigravity AI Agent — 18 specialized skills covering technical audit, E-E-A-T, schema, GEO, local SEO & more",
+  "bin": {
+    "antigravity-seo-kit": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    ".agent/",
+    "extensions/",
+    "docs/",
+    "requirements.txt",
+    "requirements-google.txt",
+    "pyproject.toml"
+  ],
+  "keywords": [
+    "seo",
+    "antigravity",
+    "google-antigravity",
+    "ai-agent",
+    "seo-audit",
+    "seo-toolkit",
+    "agent-skills",
+    "seo-analysis",
+    "technical-seo",
+    "eeat"
+  ],
+  "author": "nguyendev",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nguyendev/seo-kit"
+  },
+  "homepage": "https://github.com/nguyendev/seo-kit",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/pyproject.toml

@@ -0,0 +1,11 @@
+[project]
+name = "seo-kit"
+version = "2.0.0"
+description = "Comprehensive SEO analysis skill for AI coding agents (Antigravity compatible)"
+requires-python = ">=3.11"
+license = "MIT"
+readme = "README.md"
+
+[project.urls]
+Homepage = "https://github.com/AgriciDaniel/claude-seo"
+Repository = "https://github.com/AgriciDaniel/claude-seo"

package/requirements-google.txt

@@ -0,0 +1,15 @@
+# SEO Kit - Google API Dependencies (Optional)
+# Install: pip install -r requirements-google.txt
+# Required for: seo-google skill (Google SEO APIs)
+# Last updated: March 28, 2026
+
+# Report generation (for PDF reports with charts)
+matplotlib>=3.8.0,<4.0.0              # No known CVEs
+weasyprint>=61.0,<70.0                # No known CVEs
+
+# Google API dependencies
+google-api-python-client>=2.100.0,<3.0.0   # No known CVEs
+google-auth>=2.20.0,<3.0.0                  # No known CVEs
+google-auth-oauthlib>=1.0.0,<2.0.0          # No known CVEs
+google-auth-httplib2>=0.2.0,<1.0.0           # No known CVEs
+google-analytics-data>=0.18.0,<1.0.0         # No known CVEs

package/requirements.txt

@@ -0,0 +1,11 @@
+# Claude SEO - Python Dependencies
+# Bounded version pinning with security-conscious minimums
+# Last updated: February 7, 2026
+
+beautifulsoup4>=4.12.0,<5.0.0     # No known CVEs
+requests>=2.32.4,<3.0.0           # CVE-2024-47081, CVE-2024-35195 fixes
+lxml>=6.0.2,<7.0.0                # CVE-2025-24928 + additional libxml2 security patches
+playwright>=1.56.0,<2.0.0         # CVE-2025-59288 fix (macOS)
+Pillow>=12.1.0,<13.0.0            # CVE-2025-48379 fix
+urllib3>=2.6.3,<3.0.0             # CRITICAL: CVE-2026-21441 (CVSS 8.9), CVE-2025-66418
+validators>=0.22.0,<1.0.0         # No known CVEs