agentvibes 2.9.7 → 2.12.0

package/docs/architecture/provider-system.md

@@ -166,7 +166,7 @@ Each provider implements:
 - `.claude/tts-provider.txt` - Active provider name (project-local)
 - `~/.claude/tts-provider.txt` - Global fallback
 - `.claude/personalities/*.md` - Per-personality voice mappings
-- `.claude/plugins/bmad-voices.md` - BMAD agent voice table
+- `.agentvibes/bmad/bmad-voices.md` - BMAD agent voice table
 
 **State Flow:**
 ```
@@ -344,7 +344,7 @@ provider: piper  # Optional override
 
 ### BMAD Agent Voices
 
-**Location**: `.claude/plugins/bmad-voices.md`
+**Location**: `.agentvibes/bmad/bmad-voices.md`
 
 **Format**: Markdown table
 ```markdown
@@ -488,7 +488,7 @@ Create `.docs/providers/yourprovider-setup.md` with:
 |------|---------|
 | `.claude/tts-provider.txt` | Active provider name |
 | `.claude/personalities/*.md` | Voice mappings per personality |
-| `.claude/plugins/bmad-voices.md` | BMAD agent voice table |
+| `.agentvibes/bmad/bmad-voices.md` | BMAD agent voice table |
 
 ### Slash Commands
 

package/docs/bmad-v6-support.md

@@ -117,7 +117,7 @@ ls -la | grep bmad
 # - .bmad-core/     (v4)
 
 # Verify plugin is enabled
-ls -la .claude/plugins/bmad-voices-enabled.flag
+ls -la .agentvibes/bmad/bmad-voices-enabled.flag
 
 # Check activation instructions
 cat .claude/activation-instructions

package/docs/technical-deep-dive.md

@@ -727,7 +727,7 @@ AgentVibes can integrate with the BMAD METHOD (a multi-agent framework). When a
 1. BMAD agent activates (e.g., `/BMad:agents:pm` for project manager)
 2. BMAD writes agent ID to `.bmad-agent-context` file
 3. AgentVibes output style checks this file
-4. If BMAD plugin is enabled, looks up voice in `.claude/plugins/bmad-voices.md`
+4. If BMAD plugin is enabled, looks up voice in `.agentvibes/bmad/bmad-voices.md`
 5. Automatically switches to that voice
 
 This creates the illusion of multiple distinct AI personalities in conversations.

package/docs/voice-mapping-format.md

@@ -82,7 +82,7 @@ languages:
 
 ## BMAD Plugin Format
 
-**Agent Voice Table** (`.claude/plugins/bmad-voices.md`):
+**Agent Voice Table** (`.agentvibes/bmad/bmad-voices.md`):
 
 ```markdown
 | Agent ID | Agent Name | ElevenLabs Voice | Piper Voice | Personality |

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.9.7",
+  "version": "2.12.0",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [

package/src/installer.js

@@ -128,22 +128,27 @@ function showReleaseInfo() {
   console.log(
     boxen(
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n') +
-      chalk.cyan.bold('  📦 AgentVibes v2.8.0 - Piper Installer Fix\n') +
+      chalk.cyan.bold('  📦 AgentVibes v2.12.0 - .agentvibes/ Directory Migration\n') +
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
       chalk.green.bold('🎙️ WHAT\'S NEW:\n\n') +
-      chalk.cyan('AgentVibes v2.8.0 fixes the Piper installer double prompt bug!\n') +
-      chalk.cyan('This minor release resolves an issue where the Piper voice installer\n') +
-      chalk.cyan('would prompt twice for confirmation, causing failures when running\n') +
-      chalk.cyan('through npx due to stdin issues. The installer now automatically\n') +
-      chalk.cyan('downloads recommended voices after the initial confirmation.\n\n') +
+      chalk.cyan('AgentVibes v2.12.0 introduces a comprehensive directory reorganization,\n') +
+      chalk.cyan('migrating all AgentVibes configuration to a dedicated .agentvibes/ directory.\n') +
+      chalk.cyan('This eliminates namespace confusion with Claude Code and provides a clear,\n') +
+      chalk.cyan('predictable location for all AgentVibes state. Migration is fully automatic—\n') +
+      chalk.cyan('your settings are seamlessly moved during upgrade. Also includes BMAD testing\n') +
+      chalk.cyan('improvements and enhanced Piper voice installation.\n\n') +
       chalk.green.bold('✨ KEY HIGHLIGHTS:\n\n') +
-      chalk.gray('   🔧 Piper Installer Fix - Resolves double prompt bug\n') +
-      chalk.gray('   ✅ Auto Voice Download - Recommended voices download automatically\n') +
-      chalk.gray('   🐧 Linux Compatibility - Improved installation experience\n\n') +
-      chalk.cyan('Bug fixes and improvements:\n') +
-      chalk.gray('   Fixed stdin issues preventing voice downloads on Linux/npx\n') +
-      chalk.gray('   Piper voices now install smoothly without manual intervention\n') +
-      chalk.gray('   Enhanced npx installation experience\n\n') +
+      chalk.gray('   📁 Dedicated .agentvibes/ Directory - Clear namespace separation\n') +
+      chalk.gray('   🔄 Automatic Migration - Seamless upgrade from old locations\n') +
+      chalk.gray('   ✅ 100% Backward Compatible - No manual intervention needed\n') +
+      chalk.gray('   🧪 32 Passing Tests - Comprehensive migration validation\n') +
+      chalk.gray('   🎭 npx test-bmad-pr - One-line BMAD PR testing command\n') +
+      chalk.gray('   🎤 Enhanced Voice Detection - Better Piper installation status\n\n') +
+      chalk.cyan('Configuration Migration:\n') +
+      chalk.gray('   .claude/config/ → .agentvibes/config/\n') +
+      chalk.gray('   .claude/plugins/ → .agentvibes/bmad/\n') +
+      chalk.gray('   Automatic migration runs during update\n') +
+      chalk.gray('   All settings and voice mappings preserved\n\n') +
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
       chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
       chalk.gray('🌐 Website: https://agentvibes.org\n') +
@@ -650,20 +655,20 @@ async function copyPluginFiles(targetDir, spinner) {
  */
 async function copyBmadConfigFiles(targetDir, spinner) {
   spinner.start('Installing BMAD config files...');
-  const srcConfigDir = path.join(__dirname, '..', '.claude', 'config');
-  const destConfigDir = path.join(targetDir, '.claude', 'config');
+  const srcBmadDir = path.join(__dirname, '..', '.agentvibes', 'bmad');
+  const destBmadDir = path.join(targetDir, '.agentvibes', 'bmad');
 
-  await fs.mkdir(destConfigDir, { recursive: true });
+  await fs.mkdir(destBmadDir, { recursive: true });
 
   let fileCount = 0;
 
   // Copy bmad-voices.md if it exists
   const bmadVoicesFile = 'bmad-voices.md';
-  const srcPath = path.join(srcConfigDir, bmadVoicesFile);
+  const srcPath = path.join(srcBmadDir, bmadVoicesFile);
 
   try {
     await fs.access(srcPath);
-    const destPath = path.join(destConfigDir, bmadVoicesFile);
+    const destPath = path.join(destBmadDir, bmadVoicesFile);
     await fs.copyFile(srcPath, destPath);
     console.log(chalk.gray(`   ✓ ${bmadVoicesFile}`));
     fileCount++;
@@ -960,6 +965,66 @@ bmad-master,en_US-libritts_r-high
   }
 }
 
+/**
+ * Detect and migrate old configuration from .claude/config/ and .claude/plugins/
+ * @param {string} targetDir - Target installation directory
+ * @param {Object} spinner - Ora spinner instance
+ * @returns {Promise<boolean>} True if migration was performed
+ */
+async function detectAndMigrateOldConfig(targetDir, spinner) {
+  const oldConfigPaths = [
+    path.join(targetDir, '.claude', 'config', 'agentvibes.json'),
+    path.join(targetDir, '.claude', 'config', 'bmad-voices.md'),
+    path.join(targetDir, '.claude', 'config', 'bmad-voices-enabled.flag'),
+    path.join(targetDir, '.claude', 'plugins', 'bmad-voices-enabled.flag'),
+    path.join(targetDir, '.claude', 'plugins', 'bmad-party-mode-disabled.flag'),
+  ];
+
+  // Check if any old config exists
+  let hasOldConfig = false;
+  for (const oldPath of oldConfigPaths) {
+    try {
+      await fs.access(oldPath);
+      hasOldConfig = true;
+      break;
+    } catch {
+      // File doesn't exist, continue
+    }
+  }
+
+  if (!hasOldConfig) {
+    return false; // No migration needed
+  }
+
+  spinner.info(chalk.yellow('🔄 Old configuration detected - migrating to .agentvibes/'));
+
+  // Run migration script
+  const migrationScript = path.join(targetDir, '.claude', 'hooks', 'migrate-to-agentvibes.sh');
+
+  try {
+    await fs.access(migrationScript);
+
+    // Execute migration script
+    const { exec } = require('child_process');
+    const { promisify } = require('util');
+    const execPromise = promisify(exec);
+
+    await execPromise(`bash "${migrationScript}"`, { cwd: targetDir });
+
+    spinner.succeed(chalk.green('✓ Configuration migrated to .agentvibes/'));
+    console.log(chalk.gray('   Old locations: .claude/config/, .claude/plugins/'));
+    console.log(chalk.gray('   New location: .agentvibes/'));
+    console.log('');
+
+    return true;
+  } catch (error) {
+    spinner.warn(chalk.yellow('⚠️  Could not run migration script automatically'));
+    console.log(chalk.gray(`   You can run it manually: .claude/hooks/migrate-to-agentvibes.sh`));
+    console.log('');
+    return false;
+  }
+}
+
 /**
  * Handle BMAD integration (detection and TTS injection)
  * @param {string} targetDir - Target installation directory
@@ -981,11 +1046,11 @@ async function handleBmadIntegration(targetDir) {
   console.log(chalk.green(`\n🎉 BMAD-METHOD ${versionLabel} detected!`));
   console.log(chalk.gray(`   Location: ${bmadDetection.bmadPath}`));
 
-  const pluginsDir = path.join(claudeDir, 'plugins');
-  const enabledFlagPath = path.join(pluginsDir, 'bmad-voices-enabled.flag');
+  const bmadConfigDir = path.join(targetDir, '.agentvibes', 'bmad');
+  const enabledFlagPath = path.join(bmadConfigDir, 'bmad-voices-enabled.flag');
   const activationInstructionsPath = path.join(claudeDir, 'activation-instructions');
 
-  await fs.mkdir(pluginsDir, { recursive: true });
+  await fs.mkdir(bmadConfigDir, { recursive: true });
   await fs.writeFile(enabledFlagPath, '');
   console.log(chalk.green('🎤 Auto-enabled BMAD voice plugin'));
 
@@ -1161,6 +1226,10 @@ async function updateAgentVibes(targetDir, options) {
     spinner.text = 'Updating AgentVibes hook configuration...';
     await configureSessionStartHook(targetDir, { start: () => {}, succeed: () => {}, info: () => {}, fail: () => {} });
 
+    // Detect and migrate old configuration
+    spinner.text = 'Checking for old configuration...';
+    await detectAndMigrateOldConfig(targetDir, spinner);
+
     spinner.succeed(chalk.green.bold('\n✨ Update complete!\n'));
 
     console.log(chalk.cyan('📦 Update Summary:'));
@@ -1333,6 +1402,9 @@ async function install(options = {}) {
 
     spinner.succeed(chalk.green(`Provider set to: ${selectedProvider === 'elevenlabs' ? 'ElevenLabs' : 'Piper TTS'}\n`));
 
+    // Detect and migrate old configuration
+    await detectAndMigrateOldConfig(targetDir, spinner);
+
     // Auto-install Piper if selected
     if (selectedProvider === 'piper') {
       await checkAndInstallPiper(targetDir, options);