@codigodoleo/wp-kit 3.1.1 → 3.3.0

package/lib/commands/init.js

@@ -9,7 +9,6 @@ import { Generator } from '../core/generator.js';
 import { log, color } from '../utils/logger.js';
 import { inferCiCapabilities } from '../core/infer-ci-capabilities.js';
 import { validateVersionCompatibility } from '../config/versions.js';
-import { installSuperpowersSage } from '../utils/git.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -20,12 +19,11 @@ export const initCommand = new Command('init')
   .option('--debug', 'Ativa modo debug para logs detalhados')
   .action(async ({ output, defaults, debug }) => {
     const target = path.resolve(output);
-    const { enabledModules, ...context } = await runPrompts({ defaults });
+    const { enabledModules: promptedModules, ...context } = await runPrompts({ defaults });
+    let enabledModules = [...promptedModules];
 
     // Normalização de chaves para consistência entre módulos
-    if (context.enable_sage === true) {
-      context.useSage = true;
-    }
+    context.useSage = context.enable_sage === true;
     if (context.git_provider && !context.gitProvider) {
       context.gitProvider = context.git_provider;
     }
@@ -34,12 +32,12 @@ export const initCommand = new Command('init')
     if (context.useSage && context.sageVersion === '11') {
       context.phpVersion = '8.3';
       context.nodeVersion = '22';
-      context.wpCoreVersion = '6.8.1';
+      context.wpCoreVersion = '6.9.4';
 
       log(color.orange, '🔧 Sage 11 selected — automatically adjusting versions:');
       log(color.orange, '  → PHP: 8.3');
       log(color.orange, '  → Node: 22');
-      log(color.orange, '  → WP Core: 6.8.1');
+      log(color.orange, '  → WP Core: 6.9.4');
     }
 
     // 📋 Validar compatibilidade de versões (se Sage está habilitado)
@@ -71,6 +69,9 @@ export const initCommand = new Command('init')
     if (context.ci.theme.paths.themeRoot) {
       log(color.blue, `  → themeRoot: ${context.ci.theme.paths.themeRoot}`);
     }
+    if (context.useSage) {
+      log(color.blue, '  → sageMode: advanced (automatic when Sage is enabled)');
+    }
 
     const generator = new Generator(target);
     await fs.ensureDir(target);
@@ -80,6 +81,13 @@ export const initCommand = new Command('init')
     await generator.generateFile('.env', context);
     await generator.generateFile('.editorconfig', context);
     await generator.generateFile('server/cmd/install-wp.sh', context);
+    await generator.generateFile('server/cmd/setup-php.sh', context);
+    await generator.generateFile('server/cmd/setup-node.sh', context);
+    await generator.generateFile('.devcontainer/devcontainer.json', context);
+    await generator.generateFile('.devcontainer/docker-compose.yml', context);
+    await generator.generateFile('.devcontainer/Dockerfile', context);
+    await generator.generateFile('.devcontainer/setup.sh', context);
+    await generator.generateFile('.devcontainer/config/nginx.conf', context);
 
     await generator.copyFile('.cspell.json');
 
@@ -93,6 +101,9 @@ export const initCommand = new Command('init')
 
     await fs.chmod(path.join(target, 'content/uploads'), 0o777);
     await fs.chmod(path.join(target, 'server/cmd/install-wp.sh'), 0o755);
+    await fs.chmod(path.join(target, 'server/cmd/setup-php.sh'), 0o755);
+    await fs.chmod(path.join(target, 'server/cmd/setup-node.sh'), 0o755);
+    await fs.chmod(path.join(target, '.devcontainer/setup.sh'), 0o755);
 
     await generator.generateFile('server/www/vhosts.conf', context);
     if (context.useRocket) {
@@ -101,6 +112,7 @@ export const initCommand = new Command('init')
 
     await generator.copyFile('wp-config.php');
     await generator.copyFile('index.php');
+    await generator.generateFile('wp-cli.yml', context);
 
     log(color.blue, `🧩 Enabled modules: ${enabledModules.join(', ')}`);
 
@@ -154,8 +166,5 @@ export const initCommand = new Command('init')
     // Gera CLAUDE.md com overview do projeto e referência ao AI Co-Pilot
     await generator.generateFile('CLAUDE.md', context);
 
-    // Instala superpowers-sage em .claude/ do projeto gerado
-    await installSuperpowersSage(target);
-
     log(color.green, '✅ Project initialized with templates.');
   });

package/lib/config/versions.js

@@ -53,8 +53,8 @@ export const VERSION_REGISTRY = {
    * Only actively supported versions per php.net
    */
   php: {
-    latest: '8.3',
-    supported: ['8.3', '8.2', '8.1'],
+    latest: '8.4',
+    supported: ['8.4', '8.3', '8.2', '8.1'],
     eol: ['8.0', '7.4', '7.3', '7.2'], // Deprecated - do not use
     description: 'Supported PHP versions. PHP 7.4+ reached EOL on 2022-11-28',
     // PHP version dates: https://www.php.net/supported-versions.php
@@ -70,9 +70,9 @@ export const VERSION_REGISTRY = {
    * Tracks LTS and current stable releases
    */
   node: {
-    latest: '22',
-    lts: ['22', '20', '18'],
-    all: ['22', '20', '18'],
+    latest: '24',
+    lts: ['24', '22', '20', '18'],
+    all: ['24', '22', '20', '18'],
     deprecated: ['16', '14', '12', '10'],
     description: 'Supported Node.js versions - prefer LTS releases',
     // LTS information: https://nodejs.org/en/about/releases/

package/lib/core/infer-ci-capabilities.js

@@ -84,6 +84,23 @@ export function inferCiCapabilities(context) {
       node: hasNode,
       sage: hasSage,
     },
+    lint: {
+      sage:
+        hasSage &&
+        Boolean(context.enable_lint) &&
+        (context.sage_lint_eslint !== false ||
+          context.sage_lint_pint !== false ||
+          context.sage_lint_stylelint !== false),
+      mu_plugin: Boolean(context.enable_mu_plugin && context.enable_lint),
+      plugin: Boolean(context.enable_plugin && context.enable_lint),
+      blank_theme: Boolean(context.enable_blank_theme && context.enable_lint),
+      any:
+        Boolean(context.enable_lint) &&
+        (hasSage ||
+          Boolean(context.enable_mu_plugin) ||
+          Boolean(context.enable_plugin) ||
+          Boolean(context.enable_blank_theme)),
+    },
     deploy: {
       docker: context.deploy_strategy === 'docker',
     },

package/lib/prompts/index.js

@@ -6,6 +6,14 @@ import { Generator } from '../core/generator.js';
 
 import { loadModulePrompts } from './loadModulePrompts.js';
 
+function parseBooleanEnv(value) {
+  if (typeof value !== 'string') return null;
+  const normalized = value.trim().toLowerCase();
+  if (['1', 'true', 'yes', 'on'].includes(normalized)) return true;
+  if (['0', 'false', 'no', 'off'].includes(normalized)) return false;
+  return null;
+}
+
 export async function runPrompts({ defaults = false } = {}) {
   const defaultsGit = getGitUserDefaults();
 
@@ -46,20 +54,7 @@ export async function runPrompts({ defaults = false } = {}) {
       message: 'Repository URL:',
       default: defaultsGit.gitRepository,
     },
-    {
-      type: 'list',
-      name: 'phpVersion',
-      message: 'PHP version:',
-      choices: ['8.3', '8.2', '8.1'],
-      default: '8.3',
-    },
-    {
-      type: 'list',
-      name: 'nodeVersion',
-      message: 'Node.js version:',
-      choices: ['22', '20', '18'],
-      default: '22',
-    },
+    // phpVersion and nodeVersion are locked to '8.4' / '24' — injected into context, not prompted
     {
       type: 'list',
       name: 'wpCoreVersion',
@@ -90,13 +85,26 @@ export async function runPrompts({ defaults = false } = {}) {
     for (const prompt of allPrompts) {
       if (prompt.when && !prompt.when(defaultAnswers)) continue;
       const def = prompt.default;
-      defaultAnswers[prompt.name] = typeof def === 'function' ? def() : def;
+      defaultAnswers[prompt.name] = typeof def === 'function' ? def(defaultAnswers) : def;
+    }
+
+    const envEnableSage = parseBooleanEnv(process.env.WP_KIT_ENABLE_SAGE);
+    if (envEnableSage !== null) {
+      defaultAnswers.enable_sage = envEnableSage;
     }
+
+    const envGitProvider = process.env.WP_KIT_GIT_PROVIDER;
+    if (envGitProvider) {
+      defaultAnswers.gitProvider = envGitProvider;
+    }
+
     const enabledModules = Object.keys(modulePromptDefs).filter(
-      (mod) => defaultAnswers[`enable_${mod}`] === true
+      (mod) => defaultAnswers[`enable_${mod.replace(/-/g, '_')}`] === true
     );
     return {
       ...defaultAnswers,
+      phpVersion: '8.4',
+      nodeVersion: '24',
       enabledModules,
       projectDomain: `${defaultAnswers.projectName}.lndo.site`,
       salts: Generator.generateSalts(),
@@ -106,10 +114,12 @@ export async function runPrompts({ defaults = false } = {}) {
   const answers = await inquirer.prompt(allPrompts);
 
   const enabledModules = Object.keys(modulePromptDefs).filter(
-    (mod) => answers[`enable_${mod}`] === true
+    (mod) => answers[`enable_${mod.replace(/-/g, '_')}`] === true
   );
   return {
     ...answers,
+    phpVersion: '8.4',
+    nodeVersion: '24',
     enabledModules,
     projectDomain: `${answers.projectName}.lndo.site`,
     salts: Generator.generateSalts(),

package/lib/utils/git.js

@@ -23,16 +23,45 @@ export function getGitUserDefaults() {
 }
 
 /**
- * Clona codigodoleo/superpowers-sage e copia seu conteúdo para <targetDir>/.claude
+ * Dirs que cada destino copia do repositório superpowers-sage.
+ * A subpasta de destino dentro do projeto é TARGET_CONFIG[key].dest.
+ */
+const TARGET_CONFIG = {
+  claude: {
+    dest: '.claude/plugins/superpowers-sage',
+    dirs: ['.claude-plugin', 'skills', 'agents', 'hooks'],
+    label: 'Claude Code (.claude/)',
+  },
+  cursor: {
+    dest: '.cursor/plugins/local/superpowers-sage',
+    dirs: ['.cursor-plugin', 'skills', 'agents', 'hooks', 'rules'],
+    label: 'Cursor (.cursor/)',
+  },
+  ai: {
+    dest: '.ai/superpowers-sage',
+    dirs: ['skills', 'agents', 'hooks'],
+    label: 'Agnóstico (.ai/)',
+  },
+};
+
+/**
+ * Clona codigodoleo/superpowers-sage e copia o conteúdo para os destinos selecionados.
  * Requer git instalado no host.
+ *
  * @param {string} targetDir - Caminho absoluto do projeto gerado
+ * @param {string[]} targets - Lista de destinos: 'claude' | 'cursor' | 'ai'
  */
-export async function installSuperpowersSage(targetDir) {
+export async function installSuperpowersSage(targetDir, targets = ['claude']) {
   const repo = 'https://github.com/codigodoleo/superpowers-sage.git';
   const tmpDir = path.join(os.tmpdir(), `superpowers-sage-${Date.now()}`);
-  const claudeDir = path.join(targetDir, '.claude');
 
-  log(color.blue, '🔌 Installing superpowers-sage...');
+  const validTargets = targets.filter((t) => TARGET_CONFIG[t]);
+  if (validTargets.length === 0) {
+    log(color.orange, '[skills] Nenhum destino válido informado. Pulando.');
+    return;
+  }
+
+  log(color.blue, `🔌 Clonando superpowers-sage para: ${validTargets.join(', ')}...`);
 
   const result = spawnSync('git', ['clone', '--depth=1', repo, tmpDir], {
     stdio: 'inherit',
@@ -41,19 +70,27 @@ export async function installSuperpowersSage(targetDir) {
   if (result.status !== 0) {
     log(
       color.orange,
-      '⚠️  Could not clone superpowers-sage (no network or git unavailable). Skipping.'
+      '⚠️  Não foi possível clonar superpowers-sage (sem rede ou git indisponível). Pulando.'
     );
     return;
   }
 
-  // Copia o conteúdo completo do clone (exceto .git) para .claude do projeto
-  await fs.ensureDir(claudeDir);
-  await fs.copy(tmpDir, claudeDir, {
-    overwrite: true,
-    filter: (src) => !src.includes(`${path.sep}.git`),
-  });
+  for (const key of validTargets) {
+    const cfg = TARGET_CONFIG[key];
+    const destBase = path.join(targetDir, cfg.dest);
 
-  await fs.remove(tmpDir);
+    await fs.ensureDir(destBase);
+
+    for (const dir of cfg.dirs) {
+      const srcDir = path.join(tmpDir, dir);
+      if (!(await fs.pathExists(srcDir))) continue;
+
+      const destDir = path.join(destBase, dir);
+      await fs.copy(srcDir, destDir, { overwrite: true });
+    }
 
-  log(color.green, '✅ superpowers-sage installed at .claude/');
+    log(color.green, `✅ superpowers-sage instalado em ${cfg.dest}`);
+  }
+
+  await fs.remove(tmpDir);
 }

package/modules/blank-theme/index.js

@@ -0,0 +1,71 @@
+import path from 'path';
+
+import fs from 'fs-extra';
+
+import { log, color } from '../../lib/utils/logger.js';
+
+export async function setupModule(context, generator) {
+  const themeName = context.blank_theme_name || `${context.projectName}-theme`;
+  const themeDir = `content/themes/${themeName}`;
+  const absoluteThemeDir = path.join(generator.cwd, themeDir);
+
+  log(color.blue, `[blank-theme] 📂 Scaffolding blank theme: ${themeDir}`);
+
+  // 1. Ensure directories exist
+  await fs.ensureDir(path.join(absoluteThemeDir, 'src', 'js'));
+  await fs.ensureDir(path.join(absoluteThemeDir, 'src', 'scss'));
+  await fs.ensureDir(path.join(absoluteThemeDir, 'php'));
+
+  // 2. Generate static files
+  await generator.generateFile(
+    'style.css',
+    { ...context, blank_theme_name: themeName },
+    'blank-theme',
+    `${themeDir}/style.css`
+  );
+  await generator.generateFile(
+    'functions.php',
+    { ...context, blank_theme_name: themeName },
+    'blank-theme',
+    `${themeDir}/functions.php`
+  );
+  await generator.generateFile(
+    'vite.config.js',
+    { ...context, blank_theme_name: themeName },
+    'blank-theme',
+    `${themeDir}/vite.config.js`
+  );
+  await generator.generateFile(
+    'package.json',
+    { ...context, blank_theme_name: themeName },
+    'blank-theme',
+    `${themeDir}/package.json`
+  );
+
+  // 3. src/ scaffolds
+  await fs.ensureFile(path.join(absoluteThemeDir, 'src', 'js', 'app.js'));
+  await fs.ensureFile(path.join(absoluteThemeDir, 'src', 'scss', 'app.scss'));
+
+  // 4. Lint configs co-located in theme — always installed (IDE/editor support)
+  log(color.blue, '[blank-theme] 🔧 Installing lint configurations...');
+  await generator.copyFile('lint/.prettierrc.json', 'blank-theme', `${themeDir}/.prettierrc.json`);
+  if (context.blank_theme_lint_eslint !== false) {
+    await generator.copyFile(
+      'lint/eslint.config.mjs',
+      'blank-theme',
+      `${themeDir}/eslint.config.mjs`
+    );
+  }
+  if (context.blank_theme_lint_pint !== false) {
+    await generator.copyFile('lint/pint.json', 'blank-theme', `${themeDir}/pint.json`);
+  }
+  if (context.blank_theme_lint_stylelint !== false) {
+    await generator.copyFile(
+      'lint/.stylelintrc.json',
+      'blank-theme',
+      `${themeDir}/.stylelintrc.json`
+    );
+  }
+
+  log(color.green, `[blank-theme] ✅ Blank theme scaffolded: ${themeDir}`);
+}

package/modules/blank-theme/lint/.prettierrc.json

@@ -0,0 +1,12 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "overrides": [
+    { "files": "*.blade.php", "options": { "parser": "html" } },
+    { "files": "*.vue", "options": { "parser": "vue" } },
+    { "files": "*.scss", "options": { "singleQuote": false } }
+  ]
+}

package/modules/blank-theme/lint/.stylelintrc.json

@@ -0,0 +1,7 @@
+{
+  "extends": ["stylelint-config-standard-scss"],
+  "rules": {
+    "color-hex-length": "short",
+    "string-quotes": "double"
+  }
+}

package/modules/{lint → blank-theme/lint}/eslint.config.mjs

@@ -5,17 +5,11 @@ import globals from 'globals';
 
 export default [
   {
-    ignores: [
-      '**/node_modules/**',
-      '**/vendor/**',
-      '**/wp/**',
-      '**/public/build/**',
-      '**/dist/**',
-      'eslint.config.mjs',
-    ],
+    ignores: ['node_modules/**', 'vendor/**', 'dist/**'],
   },
   js.configs.recommended,
   {
+    files: ['src/js/**/*.{js,mjs,ts}'],
     languageOptions: {
       ecmaVersion: 2022,
       sourceType: 'module',

package/modules/blank-theme/lint/pint.json

@@ -0,0 +1,11 @@
+{
+  "preset": "psr12",
+  "rules": {
+    "array_syntax": {
+      "syntax": "short"
+    },
+    "binary_operator_spaces": {
+      "default": "single_space"
+    }
+  }
+}

package/modules/blank-theme/prompts.js

@@ -0,0 +1,36 @@
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_blank_theme',
+    message: 'Enable Blank Theme scaffold (Vite + SCSS, no Sage)?',
+    default: false,
+  },
+  {
+    type: 'input',
+    name: 'blank_theme_name',
+    message: 'Blank theme slug (used as directory name):',
+    default: (answers) => `${answers.projectName || 'wordpress'}-theme`,
+    when: (answers) => answers.enable_blank_theme,
+  },
+  {
+    type: 'confirm',
+    name: 'blank_theme_lint_eslint',
+    message: 'Blank Theme: enable ESLint for JS/TS?',
+    default: true,
+    when: (answers) => answers.enable_blank_theme && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'blank_theme_lint_stylelint',
+    message: 'Blank Theme: enable Stylelint for CSS/SCSS?',
+    default: true,
+    when: (answers) => answers.enable_blank_theme && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'blank_theme_lint_pint',
+    message: 'Blank Theme: enable Pint for PHP?',
+    default: true,
+    when: (answers) => answers.enable_blank_theme && answers.enable_lint,
+  },
+];

package/modules/blank-theme/templates/.lando.yml.hbs

@@ -0,0 +1,26 @@
+tooling:
+  bt-dev:
+    service: build
+    description: Run Vite dev server for blank theme
+    cmd: npm run dev --prefix /app/content/themes/{{blank_theme_name}}
+  bt-build:
+    service: build
+    description: Build blank theme assets
+    cmd: npm run build --prefix /app/content/themes/{{blank_theme_name}}
+{{#if enable_lint}}
+  bt-eslint:
+    service: build
+    description: Lint JS/TS in blank theme
+    cmd: npx eslint --fix src/js/ --config /app/content/themes/{{blank_theme_name}}/eslint.config.mjs
+    dir: /app/content/themes/{{blank_theme_name}}
+  bt-stylelint:
+    service: build
+    description: Lint CSS/SCSS in blank theme
+    cmd: npx stylelint --fix "src/scss/**/*.scss" --config /app/content/themes/{{blank_theme_name}}/.stylelintrc.json
+    dir: /app/content/themes/{{blank_theme_name}}
+  bt-pint:
+    service: appserver
+    description: Lint PHP in blank theme
+    dir: /app/content/themes/{{blank_theme_name}}
+    cmd: ./vendor/bin/pint
+{{/if}}

package/modules/blank-theme/templates/functions.php.hbs

@@ -0,0 +1,46 @@
+<?php
+/**
+ * Theme functions and definitions.
+ *
+ * @package {{blank_theme_name}}
+ */
+
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+define('{{blank_theme_name}}_VERSION', '{{projectVersion}}');
+define('{{blank_theme_name}}_DIR', get_template_directory());
+define('{{blank_theme_name}}_URI', get_template_directory_uri());
+
+/**
+ * Enqueue Vite-compiled assets.
+ */
+add_action('wp_enqueue_scripts', function () {
+    $manifest = {{blank_theme_name}}_DIR . '/dist/.vite/manifest.json';
+
+    if (!file_exists($manifest)) {
+        return;
+    }
+
+    $data = json_decode(file_get_contents($manifest), true);
+
+    if (isset($data['src/js/app.js']['file'])) {
+        wp_enqueue_script(
+            '{{blank_theme_name}}-app',
+            {{blank_theme_name}}_URI . '/dist/' . $data['src/js/app.js']['file'],
+            [],
+            null,
+            true
+        );
+    }
+
+    if (isset($data['src/scss/app.scss']['file'])) {
+        wp_enqueue_style(
+            '{{blank_theme_name}}-app',
+            {{blank_theme_name}}_URI . '/dist/' . $data['src/scss/app.scss']['file'],
+            [],
+            null
+        );
+    }
+});

package/modules/blank-theme/templates/package.json.hbs

@@ -0,0 +1,16 @@
+{
+  "name": "{{blank_theme_name}}",
+  "version": "{{projectVersion}}",
+  "description": "{{projectDescription}}",
+  "private": true,
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "lint": "eslint src/js --ext .js,.ts",
+    "lint:css": "stylelint \"src/scss/**/*.scss\""
+  },
+  "devDependencies": {
+    "vite": "^6.0.0",
+    "sass-embedded": "^1.77.0"
+  }
+}

package/modules/blank-theme/templates/style.css.hbs

@@ -0,0 +1,7 @@
+/*
+Theme Name:  {{blank_theme_name}}
+Description: {{projectDescription}}
+Version:     {{projectVersion}}
+Author:      {{author}}
+Text Domain: {{blank_theme_name}}
+*/

package/modules/blank-theme/templates/vite.config.js.hbs

@@ -0,0 +1,23 @@
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  base: '/app/content/themes/{{blank_theme_name}}/dist/',
+  build: {
+    outDir: 'dist',
+    rollupOptions: {
+      input: {
+        app: 'src/js/app.js',
+        styles: 'src/scss/app.scss',
+      },
+    },
+    manifest: true,
+    emptyOutDir: true,
+  },
+  css: {
+    preprocessorOptions: {
+      scss: {
+        api: 'modern-compiler',
+      },
+    },
+  },
+});