@codigodoleo/wp-kit 1.0.0

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

@@ -0,0 +1,119 @@
+import path from 'path';
+import fs from 'fs-extra';
+
+function fileExists(filePath) {
+  try {
+    return fs.pathExistsSync(filePath);
+  } catch {
+    return false;
+  }
+}
+
+function detectThemePaths(context, hasSage) {
+  const projectName = context.projectName;
+  const candidates = [
+    path.join(context.cwd, 'content', 'themes', projectName),
+    path.join(context.cwd, 'web', 'app', 'themes', projectName),
+    path.join(context.cwd, 'wp-content', 'themes', projectName)
+  ];
+
+  for (const abs of candidates) {
+    if (fileExists(abs)) {
+      const rel = path.relative(context.cwd, abs);
+      return {
+        themeRootAbs: abs,
+        themeRoot: rel,
+        packageJson: path.join(abs, 'package.json'),
+        composerJson: path.join(abs, 'composer.json'),
+        // Bud/Sage pode gerar em public/ ou dist/
+        distCandidates: [
+          path.join(rel, 'public'),
+          path.join(rel, 'dist')
+        ]
+      };
+    }
+  }
+
+  // Se Sage estiver habilitado, assumir caminho preferencial mesmo antes de existir
+  if (hasSage && projectName) {
+    const abs = path.join(context.cwd, 'content', 'themes', projectName);
+    const rel = path.relative(context.cwd, abs);
+    return {
+      themeRootAbs: abs,
+      themeRoot: rel,
+      packageJson: path.join(abs, 'package.json'),
+      composerJson: path.join(abs, 'composer.json'),
+      distCandidates: [
+        path.join(rel, 'public'),
+        path.join(rel, 'dist')
+      ]
+    };
+  }
+
+  return {
+    themeRootAbs: null,
+    themeRoot: null,
+    packageJson: null,
+    composerJson: null,
+    distCandidates: []
+  };
+}
+
+export function inferCiCapabilities(context) {
+  const hasSage = Boolean(context.enable_sage || context.useSage);
+  const theme = detectThemePaths(context, hasSage);
+
+  const rootComposer = path.join(context.cwd, 'composer.json');
+  const rootPackage = path.join(context.cwd, 'package.json');
+  const existsRootComposer = fileExists(rootComposer);
+  const existsThemeComposer = Boolean(theme.composerJson && fileExists(theme.composerJson));
+  const existsRootPackage = fileExists(rootPackage);
+  const existsThemePackage = Boolean(theme.packageJson && fileExists(theme.packageJson));
+
+  const hasComposer = Boolean(
+    existsRootComposer || existsThemeComposer || hasSage
+  );
+
+  const hasNode = Boolean(
+    existsRootPackage || existsThemePackage || hasSage
+  );
+
+  let nodeVersion = context.nodeVersion;
+  if (!nodeVersion) {
+    if (hasSage && context.sageVersion === '11') {
+      nodeVersion = '23';
+    } else {
+      nodeVersion = '18';
+    }
+  }
+
+  const ci = {
+    build: {
+      composer: hasComposer,
+      node: hasNode,
+      sage: hasSage
+    },
+    deploy: {
+      docker: context.deploy_strategy === 'docker'
+    },
+    nodeVersion,
+    theme: {
+      paths: theme
+    },
+    detect: {
+      existsRootComposer,
+      existsThemeComposer,
+      existsRootPackage,
+      existsThemePackage,
+      themeRootExists: Boolean(theme.themeRootAbs && fileExists(theme.themeRootAbs))
+    },
+    cache: {
+      packageGlobs: ['**/package.json'],
+      composerGlobs: ['**/composer.json']
+    }
+  };
+
+  return ci;
+}
+
+

package/lib/prompts/index.js

@@ -0,0 +1,105 @@
+// lib/prompts/index.js
+import inquirer from 'inquirer';
+import { getGitUserDefaults } from '../utils/git.js';
+import { loadModulePrompts } from './loadModulePrompts.js';
+import { Generator } from '../core/generator.js';
+
+export async function runPrompts({ defaults = false } = {}) {
+  const defaultsGit = getGitUserDefaults();
+
+  const corePrompts = [
+    {
+      type: 'input',
+      name: 'projectName',
+      message: 'Project name:',
+      default: 'wordpress-dev'
+    },
+    {
+      type: 'input',
+      name: 'projectDescription',
+      message: 'Project description:',
+      default: 'Generated with wp-devops'
+    },
+    {
+      type: 'input',
+      name: 'projectVersion',
+      message: 'Project version:',
+      default: '1.0.0'
+    },
+    {
+      type: 'input',
+      name: 'author',
+      message: 'Author:',
+      default: defaultsGit.author
+    },
+    {
+      type: 'input',
+      name: 'authorEmail',
+      message: 'Author email:',
+      default: defaultsGit.authorEmail
+    },
+    {
+      type: 'input',
+      name: 'gitRepository',
+      message: 'Repository URL:',
+      default: defaultsGit.gitRepository
+    },
+    {
+      type: 'list',
+      name: 'phpVersion',
+      message: 'PHP version:',
+      choices: ['8.3', '8.2', '8.1', '7.4'],
+      default: '8.3'
+    },
+    {
+      type: 'list',
+      name: 'nodeVersion',
+      message: 'Node.js version:',
+      choices: ['22', '21', '20', '18', '16'],
+      default: '22'
+    },
+    {
+      type: 'list',
+      name: 'wpCoreVersion',
+      message: 'WordPress core version:',
+      choices: ['6.8.1', '6.7', '6.6', '6.5', '6.0'],
+      default: '6.8.1'
+    },
+    {
+      type: 'confirm',
+      name: 'useRocket',
+      message: 'Use WP Rocket?',
+      default: true
+    },
+    {
+      type: 'confirm',
+      name: 'enableDebug',
+      message: 'Enable debug mode?',
+      default: false
+    }
+  ];
+
+  const modulePromptDefs = await loadModulePrompts();
+  const modulePrompts = Object.values(modulePromptDefs).flat();
+  const allPrompts = [...corePrompts, ...modulePrompts];
+
+  if (defaults) {
+    const defaultAnswers = { };
+    for (const prompt of allPrompts) {
+      if (prompt.when && !prompt.when(defaultAnswers)) continue;
+      const def = prompt.default;
+      defaultAnswers[prompt.name] = typeof def === 'function' ? def() : def;
+    }
+    const enabledModules = Object.keys(modulePromptDefs).filter(
+      (mod) => defaultAnswers[`enable_${mod}`] === true
+    );
+    return { ...defaultAnswers, enabledModules, projectDomain: `${defaultAnswers.projectName}.lndo.site`, salts: Generator.generateSalts() };
+  }
+
+  const answers = await inquirer.prompt(allPrompts);
+
+  const enabledModules = Object.keys(modulePromptDefs).filter(
+    (mod) => answers[`enable_${mod}`] === true
+  );
+  return { ...answers, enabledModules, projectDomain: `${answers.projectName}.lndo.site`, salts: Generator.generateSalts() };
+}

package/lib/prompts/loadModulePrompts.js

@@ -0,0 +1,27 @@
+import fs from 'fs-extra';
+import path from 'path';
+
+export async function loadModulePrompts(modulesDir = 'modules') {
+  const modules = await fs.readdir(modulesDir);
+  const promptsMap = {};
+
+  for (const name of modules) {
+    const promptPath = path.join(modulesDir, name, 'prompts.js');
+    if (await fs.pathExists(promptPath)) {
+      const { default: prompts } = await import(path.resolve(promptPath));
+      promptsMap[name] = Array.isArray(prompts) ? prompts : await prompts();
+    } else {
+      // basic fallback: just ask if you want to enable the module
+      promptsMap[name] = [
+        {
+          type: 'confirm',
+          name: `enable_${name}`,
+          message: `Enable ${name} module?`,
+          default: false,
+        }
+      ];
+    }
+  }
+
+  return promptsMap;
+}

package/lib/utils/generate-from-template.js

@@ -0,0 +1,17 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { fileURLToPath } from 'url';
+import handlebars from 'handlebars';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export async function generateFromTemplate(templateName, outputPath, context) {
+  const templateDir = path.resolve(__dirname, '../../templates/base');
+  const templateFile = path.join(templateDir, `${templateName}.hbs`);
+
+  const raw = await fs.readFile(templateFile, 'utf-8');
+  const compiled = handlebars.compile(raw);
+  const content = compiled(context);
+
+  await fs.writeFile(outputPath, content, 'utf-8');
+}

package/lib/utils/git.js

@@ -0,0 +1,17 @@
+import { execSync } from 'child_process';
+
+export function getGitUserDefaults() {
+  const exec = (cmd) => {
+    try {
+      return execSync(cmd).toString().trim();
+    } catch {
+      return '';
+    }
+  };
+
+  return {
+    author: exec('git config --get user.name') || 'Developer',
+    authorEmail: exec('git config --get user.email') || 'developer@example.com',
+    gitRepository: exec('git config --get remote.origin.url') || '',
+  };
+}

package/lib/utils/logger.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+
+export const color = {
+  blue: chalk.cyan,
+  green: chalk.green,
+  yellow: chalk.yellow,
+  red: chalk.red,
+  magenta: chalk.magenta,
+  orange: chalk.hex('#FFA500'),
+  gray: chalk.gray,
+  bold: chalk.bold,
+  underline: chalk.underline,
+  success: chalk.green,
+  error: chalk.red,
+  warning: chalk.yellow,
+  info: chalk.blue,
+  debug: chalk.hex('#FFA500'),
+};
+
+/**
+ * Prints a formatted message with prefix [wp-devops] and optional color
+ * @param {Function} colorFn - Chalk color function (e.g. color.green)
+ * @param {string} message - The message to print
+ */
+export function log(colorFn, message) {
+  const prefix = chalk.bold.gray('[leo-wp]');
+  console.log(`${prefix} ${colorFn(message)}`);
+}

package/modules/deploy/index.js

@@ -0,0 +1,39 @@
+import { log, color } from '../../lib/utils/logger.js';
+
+export async function setupModule(context, generator) {
+  if (!context.enable_deploy) {
+    log(color.orange, '[deploy] Deploy desabilitado. Nenhuma ação será executada.');
+    return;
+  }
+
+  log(color.blue, '[deploy] Gerando pipeline de CI baseado em context.ci');
+
+  try {
+    if (context.gitProvider === 'gitlab') {
+      await generator.generateFile('.gitlab/gitlab-ci.yml', context, 'deploy', '.gitlab-ci.yml');
+      log(color.green, '[deploy] .gitlab-ci.yml gerado com sucesso.');
+    }
+    if (context.gitProvider === 'github') {
+      await generator.generateFile('.github/workflows/ci.yml', context, 'deploy', '.github/workflows/ci.yml');
+      log(color.green, '[deploy] GitHub Actions workflow gerado com sucesso.');
+    }
+    if (context.gitProvider === 'bitbucket') {
+      await generator.generateFile('bitbucket-pipelines.yml', context, 'deploy', 'bitbucket-pipelines.yml');
+      log(color.green, '[deploy] Bitbucket Pipelines gerado com sucesso.');
+    }
+    // Avisos inteligentes
+    if (context.ci) {
+      if (context.ci.build.composer && !context.ci.detect.existsRootComposer && !context.ci.detect.existsThemeComposer) {
+        log(color.orange, '[deploy] Aviso: Build de Composer habilitado, mas nenhum composer.json encontrado.');
+      }
+      if (context.ci.build.node && !context.ci.detect.existsRootPackage && !context.ci.detect.existsThemePackage) {
+        log(color.orange, '[deploy] Aviso: Build de Node habilitado, mas nenhum package.json encontrado.');
+      }
+      if (context.ci.build.sage && !context.ci.detect.themeRootExists) {
+        log(color.orange, '[deploy] Aviso: Sage habilitado, mas diretório do tema não foi encontrado.');
+      }
+    }
+  } catch (err) {
+    log(color.red, `[deploy] Falha ao gerar pipeline: ${err.message}`);
+  }
+}

package/modules/deploy/prompts.js

@@ -0,0 +1,27 @@
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_deploy',
+    message: 'Habilitar Pipelines de CI/CD?',
+    default: true
+  },
+  {
+    type: 'list',
+    name: 'deploy_strategy',
+    message: 'Qual estratégia de deploy você prefere?',
+    choices: [
+      {
+        name: 'Docker',
+        value: 'docker'
+      },
+      {
+        name: 'SSH',
+        value: 'ssh',
+        disabled: true,
+        description: 'Em breve'
+      }
+    ],
+    default: 'docker',
+    when: (answers) => answers.enable_deploy,
+  }
+];

package/modules/deploy/templates/.github/workflows/ci.yml.hbs

@@ -0,0 +1,103 @@
+# 🚀 WordPress CI (GitHub Actions)
+
+name: CI
+
+on:
+  push:
+    branches: [ main, develop, staging ]
+  pull_request:
+    branches: [ main, develop, staging ]
+
+jobs:
+  build-basic:
+    name: Build basic
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ '{{' }} env.NODE_VERSION {{ '}}' }}
+      - name: Install deps (if present)
+        run: |
+          if [ -f package.json ]; then npm ci; fi
+
+  {{#if ci.build.composer}}
+  build-composer:
+    name: Build Composer
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ '{{' }} env.PHP_VERSION {{ '}}' }}
+      - name: Install Composer deps
+        run: |
+          if [ -f composer.json ]; then composer install --no-dev --optimize-autoloader; fi
+  {{/if}}
+
+  {{#if ci.build.sage}}
+  build-sage:
+    name: Build Sage Theme
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ '{{' }} env.NODE_VERSION {{ '}}' }}
+      - name: Build theme
+        run: |
+          THEME="{{ci.theme.paths.themeRoot}}"
+          if [ -d "$THEME" ]; then
+            cd "$THEME"
+            if [ -f package.json ]; then npm ci; fi
+            if [ -f yarn.lock ]; then yarn install --frozen-lockfile; fi
+            if [ -f package.json ]; then npm run build || yarn build; fi
+          else
+            echo "Tema não encontrado em $THEME — pulando build do tema"
+          fi
+  {{/if}}
+
+  test-basic:
+    name: Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ '{{' }} env.NODE_VERSION {{ '}}' }}
+      - name: Run basic tests
+        run: echo "No tests yet"
+
+  {{#if ci.deploy.docker}}
+  deploy-docker:
+    if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/staging'
+    name: Deploy Docker
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ '{{' }} github.actor {{ '}}' }}
+          password: ${{ '{{' }} secrets.GITHUB_TOKEN {{ '}}' }}
+      - name: Build (placeholder)
+        run: echo "Deploy Docker"
+  {{/if}}
+
+env:
+  PHP_VERSION: "{{phpVersion}}"
+  NODE_VERSION: "{{ci.nodeVersion}}"
+  WORDPRESS_VERSION: "{{wpCoreVersion}}"
+  PROJECT_NAME: "{{projectName}}"

package/modules/deploy/templates/.gitlab/gitlab-ci.yml.hbs

@@ -0,0 +1,154 @@
+# 🚀 WordPress CI/CD Pipeline (dinâmico)
+
+variables:
+  PHP_VERSION: "{{phpVersion}}"
+  WORDPRESS_VERSION: "{{wpCoreVersion}}"
+  PROJECT_NAME: "{{projectName}}"
+  NODE_VERSION: "{{ci.nodeVersion}}"
+
+workflow:
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main"
+      variables:
+        ENVIRONMENT: "production"
+      when: always
+    - if: $CI_COMMIT_BRANCH == "staging"
+      variables:
+        ENVIRONMENT: "staging"
+      when: always
+    - if: $CI_COMMIT_BRANCH == "develop"
+      variables:
+        ENVIRONMENT: "development"
+      when: always
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+      when: always
+    - when: never
+
+stages:
+  - build
+  - test
+  - deploy
+
+cache:
+  key:
+    files:
+      {{#each ci.cache.packageGlobs}}
+      - {{this}}
+      {{/each}}
+      {{#each ci.cache.composerGlobs}}
+      - {{this}}
+      {{/each}}
+  paths:
+    - **/node_modules/
+    - **/vendor/
+
+default:
+  interruptible: true
+  retry:
+    max: 1
+    when:
+      - runner_system_failure
+      - stuck_or_timeout_failure
+
+# ===== BUILD =====
+
+build:basic:
+  stage: build
+  image: node:{{ci.nodeVersion}}-alpine
+  before_script:
+    - apk add --no-cache git
+  script:
+    - echo "🚀 Build básico"
+    - if [ -f package.json ]; then npm ci --cache .npm --prefer-offline; fi
+  artifacts:
+    paths:
+      - **/node_modules/
+    expire_in: 1 hour
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == "main"
+    - if: $CI_COMMIT_BRANCH == "staging"
+    - if: $CI_COMMIT_BRANCH == "develop"
+
+{{#if ci.build.composer}}
+build:composer:
+  stage: build
+  image: composer:latest
+  before_script:
+    - apk add --no-cache git
+  script:
+    - echo "📦 Composer install"
+    - if [ -f composer.json ]; then composer install --no-dev --optimize-autoloader; fi
+  artifacts:
+    paths:
+      - **/vendor/
+    expire_in: 1 hour
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == "main"
+    - if: $CI_COMMIT_BRANCH == "staging"
+    - if: $CI_COMMIT_BRANCH == "develop"
+{{/if}}
+
+{{#if ci.build.sage}}
+build:sage:
+  stage: build
+  image: node:{{ci.nodeVersion}}-alpine
+  before_script:
+    - apk add --no-cache git
+  script:
+    - echo "🎨 Build do tema Sage"
+    - |
+      THEME="{{ci.theme.paths.themeRoot}}"
+      if [ -d "$THEME" ]; then
+        cd "$THEME"
+        if [ -f package.json ]; then npm ci --cache .npm --prefer-offline; fi
+        if [ -f yarn.lock ]; then yarn install --frozen-lockfile; fi
+        if [ -f package.json ]; then npm run build || yarn build; fi
+      else
+        echo "Tema não encontrado em $THEME — pulando build do tema"
+      fi
+  artifacts:
+    paths:
+      - {{ci.theme.paths.themeRoot}}/public/
+      - {{ci.theme.paths.themeRoot}}/dist/
+    when: always
+    expire_in: 1 day
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == "main"
+    - if: $CI_COMMIT_BRANCH == "staging"
+    - if: $CI_COMMIT_BRANCH == "develop"
+{{/if}}
+
+# ===== TEST =====
+
+test:basic:
+  stage: test
+  image: node:{{ci.nodeVersion}}-alpine
+  script:
+    - echo "🧪 Testes básicos"
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == "main"
+    - if: $CI_COMMIT_BRANCH == "staging"
+    - if: $CI_COMMIT_BRANCH == "develop"
+
+# ===== DEPLOY =====
+
+{{#if ci.deploy.docker}}
+deploy:docker:
+  stage: deploy
+  image: docker:latest
+  services:
+    - docker:dind
+  before_script:
+    - docker info
+  script:
+    - echo "🐳 Deploy Docker (placeholder)"
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main"
+    - if: $CI_COMMIT_BRANCH == "staging"
+{{/if}}
+
+