@zibby/cli 0.1.16 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/cli",
-  "version": "0.1.16",
+  "version": "0.1.19",
   "description": "Zibby CLI - Test automation generator and runner",
   "type": "module",
   "bin": {
@@ -32,8 +32,9 @@
   },
   "dependencies": {
     "@aws-sdk/client-sqs": "^3.1000.0",
-    "@zibby/skills": "^0.1.2",
-    "@zibby/core": "^0.1.13",
+    "@zibby/skills": "^0.1.3",
+    "@zibby/core": "^0.1.15",
+    "@zibby/memory": "^0.1.3",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "dotenv": "^17.2.3",
@@ -55,9 +56,6 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "optionalDependencies": {
-    "@zibby/memory": "*"
-  },
   "devDependencies": {
     "vitest": "^4.0.18"
   }

package/src/commands/init.js

@@ -1,18 +1,120 @@
 import { mkdir, writeFile, readFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import { join, resolve, dirname } from 'path';
+import { homedir } from 'os';
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 import ora from 'ora';
-import { spawn } from 'child_process';
+import { spawn, execSync } from 'child_process';
 import { fileURLToPath } from 'url';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
+async function checkNpmGlobalBinInPath() {
+  try {
+    const isWindows = process.platform === 'win32';
+    
+    // Get npm global bin directory
+    const npmPrefix = execSync('npm config get prefix', { encoding: 'utf-8' }).trim();
+    const npmGlobalBin = isWindows ? npmPrefix : `${npmPrefix}/bin`;
+    const npmGlobalBinExpanded = npmGlobalBin.replace(/^~/, homedir());
+    
+    // Check if it's in PATH
+    const pathSeparator = isWindows ? ';' : ':';
+    const pathDirs = process.env.PATH.split(pathSeparator);
+    const isInPath = pathDirs.some(dir => {
+      const normalizedDir = dir.replace(/^~/, homedir());
+      return normalizedDir === npmGlobalBinExpanded || normalizedDir === npmGlobalBin;
+    });
+    
+    if (isInPath) {
+      return; // Already configured
+    }
+    
+    // Not in PATH - offer to add it
+    console.log(chalk.yellow('⚠️  npm global bin not in PATH'));
+    console.log(chalk.gray(`   Location: ${npmGlobalBinExpanded}`));
+    console.log();
+    
+    const { shouldAddPath } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'shouldAddPath',
+      message: 'Add npm global bin to your shell PATH automatically?',
+      default: true
+    }]);
+    
+    if (!shouldAddPath) {
+      if (isWindows) {
+        console.log(chalk.gray('\n💡 To add manually on Windows:'));
+        console.log(chalk.gray('   1. Search "Environment Variables" in Start menu'));
+        console.log(chalk.gray('   2. Edit "Path" in User variables'));
+        console.log(chalk.gray(`   3. Add: ${npmGlobalBinExpanded}\n`));
+      } else {
+        console.log(chalk.gray('\n💡 To add manually, run:'));
+        console.log(chalk.gray(`   echo 'export PATH="${npmGlobalBinExpanded}:$PATH"' >> ~/.zshrc`));
+        console.log(chalk.gray(`   source ~/.zshrc\n`));
+      }
+      return;
+    }
+    
+    // Windows: Can't auto-add to PATH (requires registry changes)
+    if (isWindows) {
+      console.log(chalk.yellow('⚠️  Cannot auto-add PATH on Windows'));
+      console.log(chalk.gray('   Please add manually:'));
+      console.log(chalk.gray('   1. Search "Environment Variables" in Start menu'));
+      console.log(chalk.gray('   2. Edit "Path" in User variables'));
+      console.log(chalk.gray(`   3. Add: ${npmGlobalBinExpanded}\n`));
+      return;
+    }
+    
+    // Unix/Linux: Auto-add to shell config
+    const shell = process.env.SHELL || '';
+    let shellRc = '';
+    
+    if (shell.includes('zsh')) {
+      shellRc = join(homedir(), '.zshrc');
+    } else if (shell.includes('bash')) {
+      // Linux often uses .bashrc, macOS uses .bash_profile
+      shellRc = existsSync(join(homedir(), '.bashrc')) 
+        ? join(homedir(), '.bashrc')
+        : join(homedir(), '.bash_profile');
+    } else {
+      console.log(chalk.yellow(`⚠️  Unknown shell: ${shell}`));
+      console.log(chalk.gray('   Please add manually:'));
+      console.log(chalk.gray(`   export PATH="${npmGlobalBinExpanded}:$PATH"`));
+      return;
+    }
+    
+    // Check if already in shell config
+    if (existsSync(shellRc)) {
+      const rcContent = await readFile(shellRc, 'utf-8');
+      if (rcContent.includes(npmGlobalBinExpanded) || (rcContent.includes('npm') && rcContent.includes('global') && rcContent.includes('bin'))) {
+        console.log(chalk.yellow(`⚠️  PATH entry found in ${shellRc} but not active`));
+        console.log(chalk.gray(`   Run: source ${shellRc}\n`));
+        return;
+      }
+    }
+    
+    // Add to shell config
+    const pathEntry = `\n# npm global bin (added by zibby)\nexport PATH="${npmGlobalBinExpanded}:$PATH"\n`;
+    await writeFile(shellRc, (existsSync(shellRc) ? await readFile(shellRc, 'utf-8') : '') + pathEntry);
+    
+    console.log(chalk.green(`✅ Added to ${shellRc}`));
+    console.log(chalk.yellow('\n💡 Run this to activate in current session:'));
+    console.log(chalk.gray(`   source ${shellRc}\n`));
+    
+  } catch {
+    // Silently fail - don't block init if this check fails
+  }
+}
+
 export async function initCommand(projectName, options) {
   console.log(chalk.bold.cyan('\n🎭 Welcome to Zibby Test Automation!\n'));
 
+  // Check if npm global bin is in PATH
+  await checkNpmGlobalBinInPath();
+
   const targetDir = projectName ? resolve(process.cwd(), projectName) : process.cwd();
   const projectNameActual = projectName || 'zibby-tests';
   const isNewProject = !!projectName;
@@ -188,9 +290,25 @@ export async function initCommand(projectName, options) {
     const envContent = generateEnvFile(answers, options);
     await writeFile(join(targetDir, '.env.example'), envContent);
     
-    // Create/update .env file if API key provided
+    // Create/update .env file
+    const envPath = join(targetDir, '.env');
     if (answers.apiKey && answers.apiKey.trim()) {
       await createOrUpdateEnvFile(targetDir, answers.apiKey.trim(), answers, options);
+    } else if (!existsSync(envPath)) {
+      // Create .env from .env.example if it doesn't exist
+      await writeFile(envPath, envContent);
+    } else if (options.force) {
+      // On force reinit, merge memory vars into existing .env if using --mem
+      if (options.mem) {
+        let existingEnv = await readFile(envPath, 'utf-8');
+        if (!existingEnv.includes('ZIBBY_MEMORY_MAX_RUNS')) {
+          existingEnv += `\n# Test Memory (Dolt DB) - Auto-compaction settings\n`;
+          existingEnv += `# ZIBBY_MEMORY_MAX_RUNS=3000         # Max test runs to keep per spec\n`;
+          existingEnv += `# ZIBBY_MEMORY_MAX_AGE=1095          # Max age in days for stale data (~3 years)\n`;
+          existingEnv += `# ZIBBY_MEMORY_COMPACT_EVERY=1500    # Auto-compact every N runs (0 to disable)\n`;
+          await writeFile(envPath, existingEnv);
+        }
+      }
     }
 
 
@@ -435,8 +553,8 @@ function generateConfig(answers, _options = {}) {
 `;
 }
 
-function generateEnvFile(answers, _options = {}) {
-  const content = `# Zibby Test Automation - Environment Variables
+function generateEnvFile(answers, options = {}) {
+  let content = `# Zibby Test Automation - Environment Variables
 
 # AI Provider Keys
 ${answers.agent === 'claude' ? '# Claude (Anthropic) - Direct API\nANTHROPIC_API_KEY=sk-ant-your_key_here\n' : '# ANTHROPIC_API_KEY=sk-ant-your_key_here\n'}
@@ -450,6 +568,16 @@ ${answers.agent === 'cursor' ? '# Cursor Agent (uses cursor-agent CLI)\n# No API
 # SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK/URL
 `;
 
+  // Add memory configuration if --mem flag is used
+  if (options.mem) {
+    content += `
+# Test Memory (Dolt DB) - Auto-compaction settings
+# ZIBBY_MEMORY_MAX_RUNS=3000         # Max test runs to keep per spec
+# ZIBBY_MEMORY_MAX_AGE=1095          # Max age in days for stale data (~3 years)
+# ZIBBY_MEMORY_COMPACT_EVERY=1500    # Auto-compact every N runs (0 to disable)
+`;
+  }
+
   return content;
 }
 
@@ -481,8 +609,8 @@ async function createOrUpdateEnvFile(targetDir, apiKey, answers, options = {}) {
   await writeFile(envPath, envContent);
 }
 
-function generateEnvFileWithKey(answers, apiKey, _options = {}) {
-  const content = `# Zibby Test Automation - Environment Variables
+function generateEnvFileWithKey(answers, apiKey, options = {}) {
+  let content = `# Zibby Test Automation - Environment Variables
 
 # AI Provider Keys
 ${answers.agent === 'claude' ? 'ANTHROPIC_API_KEY=sk-ant-your_key_here\n' : '# ANTHROPIC_API_KEY=sk-ant-your_key_here\n'}
@@ -494,6 +622,16 @@ ZIBBY_API_KEY=${apiKey}
 # SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK/URL
 `;
 
+  // Add memory configuration if --mem flag is used
+  if (options.mem) {
+    content += `
+# Test Memory (Dolt DB) - Auto-compaction settings
+# ZIBBY_MEMORY_MAX_RUNS=3000         # Max test runs to keep per spec
+# ZIBBY_MEMORY_MAX_AGE=1095          # Max age in days for stale data (~3 years)
+# ZIBBY_MEMORY_COMPACT_EVERY=1500    # Auto-compact every N runs (0 to disable)
+`;
+  }
+
   return content;
 }
 
@@ -509,8 +647,8 @@ function generatePackageJson(projectName, _answers) {
       'test:headed': 'playwright test --headed'
     },
     dependencies: {
-      '@zibby/cli': '^0.1.0',
-      '@zibby/core': '^0.1.0'
+      '@zibby/cli': '^0.1.19',
+      '@zibby/core': '^0.1.15'
     },
     devDependencies: {
       '@playwright/test': '^1.49.0',