antigravity-seo-kit 1.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', 'v1.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://antigravityseokit.solann.io/`);
+  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: '1.0.0',
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "antigravity-seo-kit",
+  "version": "1.0.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": {
+    "antigravity-seo-kit": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/"
+  ],
+  "keywords": [
+    "seo",
+    "antigravity",
+    "antigravity-kit",
+    "antigravity-seo-kit",
+    "google-antigravity",
+    "ai-agent",
+    "seo-geo",
+    "seo-audit",
+    "seo-toolkit",
+    "agent-skills",
+    "seo-analysis",
+    "technical-seo",
+    "eeat"
+  ],
+  "author": "Antigravity SEO Kit",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://antigravityseokit.solann.io/",
+  "engines": {
+    "node": ">=18"
+  }
+}