zark-seo 1.0.0

package/bin/cli.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+import { promises as fs } from 'node:fs';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = path.resolve(__dirname, '../templates');
+const PKG_PATH = path.resolve(__dirname, '../package.json');
+
+const c = {
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+  dim: (s) => `\x1b[2m${s}\x1b[0m`,
+};
+
+function banner(title) {
+  const line = '═'.repeat(Math.max(title.length + 4, 50));
+  console.log(c.cyan(`\n╔${line}╗`));
+  console.log(c.cyan(`║  ${c.bold(title)}${' '.repeat(line.length - title.length - 2)}║`));
+  console.log(c.cyan(`╚${line}╝\n`));
+}
+
+async function getVersion() {
+  try {
+    const pkg = JSON.parse(await fs.readFile(PKG_PATH, 'utf-8'));
+    return pkg.version;
+  } catch {
+    return 'unknown';
+  }
+}
+
+async function copyDir(src, dest) {
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const sp = path.join(src, entry.name);
+    const dp = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      await copyDir(sp, dp);
+    } else if (entry.isFile()) {
+      await fs.copyFile(sp, dp);
+    }
+  }
+}
+
+async function appendNoteToContextFiles(targetRoot, skillsDirName) {
+  const note = `\n\n## SEO & GEO Skills (ZARK)\nEste projeto tem o **ZARK SEO & GEO Skills Stack** instalado em \`${skillsDirName}/\` — 13 skills especialistas (1 orquestrador + 12 especialistas) em SEO Local, SEO de conteúdo e GEO (otimização para LLMs).\n\n**Como usar:**\n- Em pedidos amplos ("monta plano de SEO completo", "cliente novo chegou", "como começo SEO") → consulte \`${skillsDirName}/seo-orchestrator-SKILL.md\` que roteia pra sequência correta.\n- Em pedidos específicos ("auditoria do site", "criar schema", "otimizar GBP", "página de cidade", "GEO/LLM SEO") → consulte a skill correspondente em \`${skillsDirName}/\`.\n- Lista completa de skills + pipelines documentados em \`${skillsDirName}/README.md\`.\n\nCada skill tem frontmatter \`name\` + \`description\` com triggers naturais — Claude Code roteia automaticamente; em outros clientes (Cursor/Codex/Aider) a IA usa o README como índice.\n\nFoco BR (CNPJ, CEP, +55, diretórios BR, idioma PT-BR). Stack derivado de auditoria real (não teórico).\n`;
+
+  const candidates = [
+    path.join(targetRoot, '.ai-context', 'CONTEXT.md'),
+    path.join(targetRoot, 'CLAUDE.md'),
+  ];
+
+  for (const file of candidates) {
+    if (!existsSync(file)) continue;
+    try {
+      const stat = await fs.lstat(file);
+      const realFile = stat.isSymbolicLink()
+        ? path.resolve(path.dirname(file), await fs.readlink(file))
+        : file;
+      const current = await fs.readFile(realFile, 'utf-8');
+      if (current.includes('ZARK SEO & GEO Skills')) {
+        return realFile + ' (já tem nota — pulando)';
+      }
+      await fs.writeFile(realFile, current + note, 'utf-8');
+      return realFile + ' (nota adicionada)';
+    } catch {
+      // continue
+    }
+  }
+  return null;
+}
+
+function printHelp(version) {
+  banner(`zark-seo v${version}`);
+  console.log(`  ${c.bold('Comandos:')}\n`);
+  console.log(`    ${c.green('init')} ${c.dim('[pasta]')}   instala 13 skills SEO/GEO (default: ./seo-skills)`);
+  console.log(`    ${c.green('help')}            mostra esta ajuda`);
+  console.log(`    ${c.green('version')}         mostra a versão\n`);
+  console.log(`  ${c.bold('Uso:')}`);
+  console.log(`    npx zark-seo init                    ${c.dim('# instala em ./seo-skills')}`);
+  console.log(`    npx zark-seo init ./skills           ${c.dim('# instala em ./skills')}`);
+  console.log(`    npx zark-seo init --force            ${c.dim('# sobrescreve se já existe')}\n`);
+  console.log(`  ${c.bold('Filosofia:')}`);
+  console.log(`    13 skills (1 orquestrador + 12 especialistas) em SEO Local, conteúdo e GEO.`);
+  console.log(`    Cada skill tem frontmatter com triggers naturais — Claude Code roteia auto;`);
+  console.log(`    em outros clientes a IA usa o README como índice. Foco mercado brasileiro.\n`);
+  console.log(`  ${c.bold('Skills incluídas:')}`);
+  console.log(`    ${c.dim('Orquestrador:')}  seo-orchestrator`);
+  console.log(`    ${c.dim('Diagnóstico:')}   seo-local-auditor · competitor-gap-analyzer`);
+  console.log(`    ${c.dim('Local SEO:')}     gbp-optimizer · service-area-page-builder · citations-builder-br`);
+  console.log(`    ${c.dim('Técnico:')}       schema-jsonld-builder · meta-tags-optimizer · core-web-vitals-fixer`);
+  console.log(`    ${c.dim('Conteúdo:')}      topical-authority-architect · seo-content-writer-br`);
+  console.log(`    ${c.dim('Off-site:')}      review-acquisition-engine`);
+  console.log(`    ${c.dim('LLM/GEO:')}       geo-llm-optimizer ★\n`);
+}
+
+async function runInit(args) {
+  const force = args.includes('--force');
+  const positional = args.filter((a) => !a.startsWith('--'));
+  const target = path.resolve(positional[0] ?? './seo-skills');
+  const skillsDirName = path.basename(target);
+  const projectRoot = path.dirname(target);
+
+  banner('🚀 zark-seo — install');
+
+  if (existsSync(target)) {
+    if (!force) {
+      console.error(c.red(`✗ Pasta '${target}' já existe.`));
+      console.error(c.dim(`  Use --force pra sobrescrever, ou escolha outro nome.`));
+      process.exit(1);
+    }
+    console.log(c.yellow(`⚠ Sobrescrevendo ${target} (--force)`));
+    await fs.rm(target, { recursive: true, force: true });
+  }
+
+  console.log(c.dim(`  origem: ${TEMPLATES_DIR}`));
+  console.log(c.dim(`  destino: ${target}\n`));
+
+  await copyDir(TEMPLATES_DIR, target);
+
+  const fileList = [];
+  async function walk(dir, base = '') {
+    for (const e of await fs.readdir(dir, { withFileTypes: true })) {
+      const sub = path.join(base, e.name);
+      if (e.isDirectory()) await walk(path.join(dir, e.name), sub);
+      else fileList.push(sub);
+    }
+  }
+  await walk(target);
+
+  for (const f of fileList) {
+    console.log(`  ${c.green('✓')}  ${f}`);
+  }
+
+  console.log('');
+  const noteResult = await appendNoteToContextFiles(projectRoot, skillsDirName);
+  if (noteResult) {
+    console.log(`  ${c.green('✓')}  ${noteResult}`);
+  } else {
+    console.log(c.dim(`  (sem .ai-context/CONTEXT.md ou CLAUDE.md no projeto — sem auto-nota)`));
+  }
+
+  console.log('');
+  console.log(c.green(`✓ 13 skills instaladas em ${skillsDirName}/`));
+  console.log('');
+  console.log(c.bold('Próximo passo:'));
+  console.log(`  ${c.dim('•')} Diga pra IA: "leia ${skillsDirName}/README.md e use as skills SEO/GEO conforme contexto"`);
+  console.log(`  ${c.dim('•')} Pra pedidos amplos, mencione: "use o seo-orchestrator pra montar o plano"`);
+  console.log(`  ${c.dim('•')} Pra pedidos específicos, a IA detecta a skill via descriptions automaticamente.`);
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const cmd = argv[0] ?? 'help';
+  const version = await getVersion();
+
+  try {
+    switch (cmd) {
+      case 'init':
+        await runInit(argv.slice(1));
+        return;
+      case 'version':
+      case '--version':
+      case '-v':
+        console.log(version);
+        return;
+      case 'help':
+      case '--help':
+      case '-h':
+      default:
+        printHelp(version);
+        return;
+    }
+  } catch (e) {
+    console.error(c.red(`✗ ${e.message ?? e}`));
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "zark-seo",
+  "version": "1.0.0",
+  "description": "ZARK SEO & GEO Skills Stack — install via `npx zark-seo init` to drop 13 SEO/GEO specialist skills (Local SEO, content, GEO/LLM optimization) as REFERENCE for AI in any project. Brazilian market focus, derived from real ZARK audits.",
+  "type": "module",
+  "bin": {
+    "zark-seo": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "templates/"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "seo",
+    "local-seo",
+    "geo",
+    "llm-seo",
+    "ai-context",
+    "claude-code",
+    "skills",
+    "zark",
+    "brasil",
+    "google-business-profile",
+    "schema-jsonld"
+  ],
+  "author": "Maycon Jordan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mayconjordanr/zark-seo.git"
+  }
+}