similarbuild 0.1.0

package/lib/copy-templates.mjs

@@ -0,0 +1,52 @@
+// Copia templates/* pras paths corretas no projeto destino.
+// install: sobrescreve templates (commands/skills/memory/presets/reports são framework code, versionada via release).
+// update: idem — só preserva o que é state do user (config, per-user memory) e isso fica fora do escopo desta função.
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+const SKIP_DIRS = new Set(['node_modules', '.git']);
+const SKIP_FILES = new Set(['.DS_Store', 'Thumbs.db']);
+
+async function copyDir(src, dest) {
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+  for (const e of entries) {
+    if (e.isDirectory() && SKIP_DIRS.has(e.name)) continue;
+    if (e.isFile() && SKIP_FILES.has(e.name)) continue;
+    const s = path.join(src, e.name);
+    const d = path.join(dest, e.name);
+    if (e.isDirectory()) await copyDir(s, d);
+    else if (e.isFile()) await fs.copyFile(s, d);
+    else if (e.isSymbolicLink()) {
+      const target = await fs.readlink(s);
+      try { await fs.unlink(d); } catch {}
+      await fs.symlink(target, d);
+    }
+  }
+}
+
+export async function copyTemplates({ pluginRoot, destRoot }) {
+  const tpl = path.join(pluginRoot, 'templates');
+  // Sanidade: pluginRoot deve conter templates/
+  try { await fs.access(tpl); }
+  catch { throw new Error(`templates/ não encontrado em ${pluginRoot} — pacote corrompido?`); }
+
+  const mappings = [
+    { src: path.join(tpl, 'commands'), dest: path.join(destRoot, '.claude', 'commands') },
+    { src: path.join(tpl, 'skills'), dest: path.join(destRoot, '.claude', 'skills') },
+    { src: path.join(tpl, 'memory'), dest: path.join(destRoot, '.claude', 'skills', 'sb-shared', 'memory') },
+    { src: path.join(tpl, 'presets'), dest: path.join(destRoot, '.claude', 'skills', 'sb-shared', 'presets') },
+    { src: path.join(tpl, 'reports'), dest: path.join(destRoot, '.claude', 'templates', 'reports') },
+  ];
+
+  for (const { src, dest } of mappings) {
+    try { await fs.access(src); }
+    catch {
+      process.stderr.write(`[similarbuild] aviso: ${path.relative(pluginRoot, src)} não existe — pulando\n`);
+      continue;
+    }
+    process.stderr.write(`[similarbuild] copiando ${path.relative(pluginRoot, src)} → ${path.relative(destRoot, dest)}\n`);
+    await copyDir(src, dest);
+  }
+}

package/lib/install-deps.mjs

@@ -0,0 +1,62 @@
+// Instala deps npm no projeto destino + (opcionalmente) baixa Chromium.
+// Spawn herda stdio do parent — user vê o output do npm direto.
+
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+
+export const RUNTIME_DEPS = Object.freeze([
+  'playwright',
+  'playwright-extra',
+  'puppeteer-extra-plugin-stealth',
+  'sharp',
+  'pixelmatch',
+  'pngjs',
+  'cheerio',
+  'js-yaml',
+  'liquidjs',
+  'prettier',
+]);
+
+function run(cmd, args, cwd) {
+  return new Promise((resolve, reject) => {
+    const proc = spawn(cmd, args, { cwd, stdio: 'inherit', shell: process.platform === 'win32' });
+    proc.on('error', reject);
+    proc.on('exit', (code, signal) => {
+      if (code === 0) resolve();
+      else reject(new Error(`${cmd} ${args.join(' ')} exited ${code ?? 'signal=' + signal}`));
+    });
+  });
+}
+
+export async function ensurePackageJson(destRoot) {
+  const pkgPath = path.join(destRoot, 'package.json');
+  try {
+    await fs.access(pkgPath);
+    return false;
+  } catch {
+    const slug = (path.basename(destRoot) || 'sb-project')
+      .toLowerCase()
+      .replace(/[^a-z0-9-]+/g, '-')
+      .replace(/^-+|-+$/g, '') || 'sb-project';
+    const stub = {
+      name: slug,
+      version: '0.0.0',
+      private: true,
+      type: 'module',
+    };
+    await fs.writeFile(pkgPath, JSON.stringify(stub, null, 2) + '\n');
+    process.stderr.write(`[similarbuild] criou package.json stub (name: ${slug})\n`);
+    return true;
+  }
+}
+
+export async function installDeps(destRoot) {
+  process.stderr.write(`[similarbuild] npm install --save ${RUNTIME_DEPS.join(' ')}\n`);
+  await run('npm', ['install', '--save', ...RUNTIME_DEPS], destRoot);
+}
+
+export async function installChromium(destRoot) {
+  process.stderr.write(`[similarbuild] npx playwright install chromium\n`);
+  await run('npx', ['--yes', 'playwright', 'install', 'chromium'], destRoot);
+}

package/lib/prompt-config.mjs

@@ -0,0 +1,83 @@
+// Lê config interativamente OU retorna defaults com --yes.
+// Usa readline nativo (zero dep) — só 5 perguntas, não vale a pena puxar `prompts`.
+
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+
+export const DEFAULTS = Object.freeze({
+  output_folder: './sb-output',
+  default_target: 'wp',
+  default_viewport: 390,
+  auto_correct_max_iterations: 2,
+  diff_threshold_percent: 15,
+});
+
+const TARGETS = new Set(['wp', 'shopify']);
+
+function prefix(msg) {
+  return `[similarbuild] ${msg}`;
+}
+
+async function askText(rl, prompt, def) {
+  const answer = (await rl.question(`${prompt} [${def}]: `)).trim();
+  return answer || String(def);
+}
+
+async function askInt(rl, prompt, def, { min, max } = {}) {
+  while (true) {
+    const raw = await askText(rl, prompt, def);
+    const n = parseInt(raw, 10);
+    if (Number.isNaN(n)) {
+      process.stderr.write(prefix(`valor inválido: "${raw}" — esperava número inteiro\n`));
+      continue;
+    }
+    if (typeof min === 'number' && n < min) {
+      process.stderr.write(prefix(`valor abaixo do mínimo (${min})\n`));
+      continue;
+    }
+    if (typeof max === 'number' && n > max) {
+      process.stderr.write(prefix(`valor acima do máximo (${max})\n`));
+      continue;
+    }
+    return n;
+  }
+}
+
+async function askChoice(rl, prompt, def, choices) {
+  while (true) {
+    const raw = (await askText(rl, `${prompt} (${choices.join('/')})`, def)).toLowerCase();
+    if (choices.includes(raw)) return raw;
+    process.stderr.write(prefix(`valor inválido: "${raw}" — opções: ${choices.join(', ')}\n`));
+  }
+}
+
+export async function promptConfig({ yes = false } = {}) {
+  if (yes) return { ...DEFAULTS };
+  const rl = readline.createInterface({ input, output });
+  try {
+    process.stderr.write(prefix('Configuração inicial — Enter aceita o default.\n'));
+    const cfg = {
+      output_folder: await askText(rl, 'Pasta de output (relativa ao projeto)', DEFAULTS.output_folder),
+      default_target: await askChoice(rl, 'Destino padrão', DEFAULTS.default_target, [...TARGETS]),
+      default_viewport: await askInt(rl, 'Viewport mobile-first (px)', DEFAULTS.default_viewport, { min: 240, max: 2048 }),
+      auto_correct_max_iterations: await askInt(rl, 'Tentativas de auto-correção antes de escalar', DEFAULTS.auto_correct_max_iterations, { min: 0, max: 10 }),
+      diff_threshold_percent: await askInt(rl, 'Threshold de diff% pra "bate com a live"', DEFAULTS.diff_threshold_percent, { min: 0, max: 100 }),
+    };
+    return cfg;
+  } finally {
+    rl.close();
+  }
+}
+
+export async function confirm(question, { defaultYes = true, yes = false } = {}) {
+  if (yes) return defaultYes;
+  const rl = readline.createInterface({ input, output });
+  try {
+    const suffix = defaultYes ? '[S/n]' : '[s/N]';
+    const answer = (await rl.question(`${question} ${suffix}: `)).trim().toLowerCase();
+    if (!answer) return defaultYes;
+    return ['s', 'sim', 'y', 'yes'].includes(answer);
+  } finally {
+    rl.close();
+  }
+}

package/lib/verify-env.mjs

@@ -0,0 +1,19 @@
+// Pattern #16: stderr prefix `[similarbuild]` para todo log do installer.
+const MIN_NODE_MAJOR = 20;
+
+export function verifyNode() {
+  const v = process.versions.node;
+  const major = parseInt(v.split('.')[0], 10);
+  if (Number.isNaN(major) || major < MIN_NODE_MAJOR) {
+    process.stderr.write(`[similarbuild] Node ${MIN_NODE_MAJOR}+ required. Detected v${v}.\n`);
+    process.stderr.write(`[similarbuild] Instale Node 20+: https://nodejs.org/\n`);
+    return false;
+  }
+  return true;
+}
+
+export function verifyNpm() {
+  // npm vem junto com Node, mas se o user tiver removido, falhamos rápido.
+  // Verificação real só roda quando installDeps for chamado (spawn npm).
+  return true;
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "similarbuild",
+  "version": "0.1.0",
+  "description": "Visual migration framework for Claude Code — clone a live page, get a paste-ready WordPress/Elementor or Shopify section file, validated and auto-corrected.",
+  "type": "module",
+  "bin": {
+    "similarbuild": "bin/install.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "scripts/",
+    "templates/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "sync-templates": "node scripts/sync-templates.mjs",
+    "prepublishOnly": "node scripts/sync-templates.mjs",
+    "smoke:install": "node bin/install.js --help",
+    "test": "echo \"no top-level test suite — see .claude/skills/sb-*/scripts/tests/ for per-skill tests\""
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "anthropic",
+    "wordpress",
+    "elementor",
+    "shopify",
+    "liquid",
+    "visual-migration",
+    "page-clone",
+    "playwright",
+    "scaffold",
+    "installer"
+  ],
+  "author": "SimilarBuild Authors <noreply@github.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/eggonbassoli/similarbuild#readme",
+  "bugs": {
+    "url": "https://github.com/eggonbassoli/similarbuild/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eggonbassoli/similarbuild.git"
+  },
+  "devDependencies": {
+    "cheerio": "^1.2.0",
+    "js-yaml": "^4.1.1",
+    "liquidjs": "^10.25.7",
+    "pixelmatch": "^7.2.0",
+    "playwright": "^1.59.1",
+    "playwright-extra": "^4.3.6",
+    "pngjs": "^7.0.0",
+    "prettier": "^3.8.3",
+    "puppeteer-extra-plugin-stealth": "^2.11.2",
+    "sharp": "^0.34.5"
+  }
+}

package/scripts/sync-templates.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+// Sync .claude/{commands,skills/sb-*} → templates/{commands,skills/}
+// Roda antes de `npm publish` (prepublishOnly) e como conveniência manual durante dev.
+// Mantém `templates/` como source-of-truth pro tarball; `.claude/` é o working dir.
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, '..');
+
+const SKIP_DIRS = new Set(['node_modules', '.git', '.DS_Store']);
+const SKIP_FILES = new Set(['.DS_Store', 'Thumbs.db']);
+
+async function rmrf(p) {
+  await fs.rm(p, { recursive: true, force: true });
+}
+
+async function copyDir(src, dest) {
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+  for (const e of entries) {
+    if (e.isDirectory() && SKIP_DIRS.has(e.name)) continue;
+    if (e.isFile() && SKIP_FILES.has(e.name)) continue;
+    const s = path.join(src, e.name);
+    const d = path.join(dest, e.name);
+    if (e.isDirectory()) await copyDir(s, d);
+    else if (e.isFile()) await fs.copyFile(s, d);
+    else if (e.isSymbolicLink()) {
+      const target = await fs.readlink(s);
+      await fs.symlink(target, d);
+    }
+  }
+}
+
+async function syncCommands() {
+  const src = path.join(ROOT, '.claude', 'commands');
+  const dest = path.join(ROOT, 'templates', 'commands');
+  process.stderr.write(`[sync-templates] commands: ${path.relative(ROOT, src)} → ${path.relative(ROOT, dest)}\n`);
+  await rmrf(dest);
+  await copyDir(src, dest);
+}
+
+async function syncSkills() {
+  const src = path.join(ROOT, '.claude', 'skills');
+  const dest = path.join(ROOT, 'templates', 'skills');
+  process.stderr.write(`[sync-templates] skills: ${path.relative(ROOT, src)}/sb-* → ${path.relative(ROOT, dest)}/\n`);
+  await rmrf(dest);
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+  let count = 0;
+  for (const e of entries) {
+    if (!e.isDirectory()) continue;
+    if (!e.name.startsWith('sb-')) continue;
+    await copyDir(path.join(src, e.name), path.join(dest, e.name));
+    count++;
+  }
+  process.stderr.write(`[sync-templates] sincronizou ${count} skills sb-*\n`);
+}
+
+async function main() {
+  await syncCommands();
+  await syncSkills();
+  process.stderr.write('[sync-templates] ok\n');
+}
+
+main().catch((e) => {
+  process.stderr.write(`[sync-templates] erro: ${e.stack || e.message}\n`);
+  process.exit(1);
+});