@bostonuniversity/buwp-local 0.1.0 → 0.2.0

package/USAGE.md

@@ -5,7 +5,7 @@
 ### 1. Install in your project
 
 ```bash
-npm install --save-dev buwp-local
+npm install --save-dev @bostonuniversity/buwp-local
 ```
 
 ### 2. Initialize configuration
@@ -14,6 +14,12 @@ npm install --save-dev buwp-local
 npx buwp-local config --init
 ```
 
+```bash
+buwp-local config --init --plugin      # For plugins
+buwp-local config --init --mu-plugin   # For mu-plugins
+buwp-local config --init --theme       # For themes
+```
+
 This creates `.buwp-local.json` in your project directory.
 
 ### 3. Edit configuration
@@ -250,6 +256,14 @@ See the resolved configuration (with masked secrets):
 npx buwp-local config --show
 ```
 
+## WP-CLI Command
+```bash
+buwp-local wp user list
+buwp-local wp post list --format=json
+buwp-local wp plugin activate akismet
+```
+
+
 ## Next Steps
 
 - [ ] Phase 2: WP-CLI proxy command

package/bin/buwp-local.js

@@ -14,6 +14,8 @@ const startCommand = require('../lib/commands/start');
 const stopCommand = require('../lib/commands/stop');
 const destroyCommand = require('../lib/commands/destroy');
 const logsCommand = require('../lib/commands/logs');
+const wpCommand = require('../lib/commands/wp');
+const shellCommand = require('../lib/commands/shell');
 const configCommand = require('../lib/commands/config');
 
 const program = new Command();
@@ -70,10 +72,13 @@ program
   .command('wp <args...>')
   .description('Run WP-CLI commands in the WordPress container')
   .allowUnknownOption()
-  .action((args) => {
-    console.log(chalk.yellow('WP-CLI proxy not yet implemented'));
-    console.log('Would run:', args.join(' '));
-  });
+  .action(wpCommand);
+
+// Shell command
+program
+  .command('shell')
+  .description('Open an interactive bash shell in the WordPress container')
+  .action(shellCommand);
 
 // Error handling
 program.exitOverride();

package/lib/commands/shell.js

@@ -0,0 +1,71 @@
+/**
+ * Shell command - Open an interactive bash shell in the WordPress container
+ */
+
+const chalk = require('chalk');
+const { spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const { loadConfig } = require('../config');
+
+async function shellCommand(options) {
+  console.log(chalk.blue('🐚 Opening interactive shell...\n'));
+
+  try {
+    const projectPath = process.cwd();
+    const composePath = path.join(projectPath, '.buwp-local', 'docker-compose.yml');
+
+    // Check if docker-compose.yml exists
+    if (!fs.existsSync(composePath)) {
+      console.log(chalk.yellow('⚠️  No running environment found.'));
+      console.log(chalk.gray('Run "buwp-local start" to create an environment.\n'));
+      return;
+    }
+
+    // Load config to get project name
+    const config = loadConfig(projectPath);
+    const projectName = config.projectName || 'buwp-local';
+
+    // Check if Docker is running
+    try {
+      spawnSync('docker', ['info'], { stdio: 'ignore' });
+    } catch (err) {
+      console.error(chalk.red('❌ Docker is not running.'));
+      process.exit(1);
+    }
+
+    // Build docker compose exec command for interactive shell
+    const composeDir = path.dirname(composePath);
+    
+    // Use spawnSync instead of execSync for proper TTY handling
+    const result = spawnSync(
+      'docker',
+      [
+        'compose',
+        '-p', projectName,
+        '-f', composePath,
+        'exec',
+        'wordpress',
+        '/bin/bash'
+      ],
+      {
+        cwd: composeDir,
+        stdio: 'inherit',
+        shell: false
+      }
+    );
+
+    // Only show exit message if shell exited with error
+    if (result.status !== 0 && result.status !== null) {
+      console.log(chalk.yellow(`\n⚠️  Shell exited with code ${result.status}\n`));
+    } else {
+      console.log(chalk.gray('\n👋 Shell closed.\n'));
+    }
+
+  } catch (err) {
+    console.error(chalk.red('\n❌ Error:'), err.message);
+    process.exit(1);
+  }
+}
+
+module.exports = shellCommand;

package/lib/commands/wp.js

@@ -0,0 +1,57 @@
+/**
+ * WP-CLI proxy command - Execute WP-CLI commands in the WordPress container
+ */
+
+const chalk = require('chalk');
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const { loadConfig } = require('../config');
+
+async function wpCommand(args, options) {
+  try {
+    const projectPath = process.cwd();
+    const composePath = path.join(projectPath, '.buwp-local', 'docker-compose.yml');
+
+    // Check if docker-compose.yml exists
+    if (!fs.existsSync(composePath)) {
+      console.log(chalk.yellow('⚠️  No running environment found.'));
+      console.log(chalk.gray('Run "buwp-local start" to create an environment.\n'));
+      return;
+    }
+
+    // Load config to get project name
+    const config = loadConfig(projectPath);
+    const projectName = config.projectName || 'buwp-local';
+
+    // Check if Docker is running
+    try {
+      execSync('docker info', { stdio: 'ignore' });
+    } catch (err) {
+      console.error(chalk.red('❌ Docker is not running.'));
+      process.exit(1);
+    }
+
+    // Build docker compose exec command for WP-CLI
+    const composeDir = path.dirname(composePath);
+    const wpArgs = args.join(' ');
+    const command = `docker compose -p ${projectName} -f ${composePath} exec wordpress wp ${wpArgs}`;
+
+    // Execute WP-CLI command
+    try {
+      execSync(command, { 
+        cwd: composeDir,
+        stdio: 'inherit'
+      });
+    } catch (err) {
+      // WP-CLI may exit with error codes (e.g., failed import), don't exit harshly
+      // The error output is already shown via stdio: 'inherit'
+    }
+
+  } catch (err) {
+    console.error(chalk.red('\n❌ Error:'), err.message);
+    process.exit(1);
+  }
+}
+
+module.exports = wpCommand;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bostonuniversity/buwp-local",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Local WordPress development environment for Boston University projects",
   "main": "lib/index.js",
   "bin": {