agentvibes 5.11.2 → 5.12.0-alpha.0

package/bin/mcp-server.js

@@ -1,122 +1,122 @@
 #!/usr/bin/env node
-
-/**
- * AgentVibes MCP Server Launcher (Cross-Platform)
- *
- * This Node.js script replaces the bash wrapper to work on Windows, macOS, and Linux.
- * It auto-installs Python dependencies and launches the Python MCP server.
- */
-
-import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import { existsSync } from 'fs';
-import { platform } from 'os';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Package root is one level up from bin/
-const PACKAGE_ROOT = join(__dirname, '..');
-const MCP_SERVER = join(PACKAGE_ROOT, 'mcp-server', 'server.py');
-const INSTALL_DEPS = join(PACKAGE_ROOT, 'mcp-server', 'install-deps.js');
-
-// Check if Python MCP server exists
-if (!existsSync(MCP_SERVER)) {
-  console.error(`❌ Error: MCP server not found at ${MCP_SERVER}`);
-  process.exit(1);
-}
-
-// Function to find available Python command
-async function findPythonCommand() {
-  const commands = platform() === 'win32' ? ['python', 'py', 'python3'] : ['python3', 'python'];
-
-  for (const cmd of commands) {
-    try {
-      const checkCmd = platform() === 'win32' ? 'where' : 'which';
-      const proc = spawn(checkCmd, [cmd], { stdio: 'ignore' });
-      const exists = await new Promise((resolve) => {
-        proc.on('close', (code) => resolve(code === 0));
-      });
-
-      if (exists) {
-        return cmd;
-      }
-    } catch (err) {
-      // Try next command
-    }
-  }
-
-  return null;
-}
-
-// Function to check if Python module is installed
-function checkPythonModule(pythonCmd, moduleName) {
-  return new Promise((resolve) => {
-    const proc = spawn(pythonCmd, ['-c', `import ${moduleName}`], { stdio: 'ignore' });
-    proc.on('close', (code) => resolve(code === 0));
-  });
-}
-
-// Main setup and launch function
-async function main() {
-  // Silent mode - no output to avoid breaking MCP JSON protocol
-
-  // Find Python command
-  const pythonCmd = await findPythonCommand();
-  if (!pythonCmd) {
-    console.error('ERROR: Python 3 not found. Install from https://python.org and restart Claude Desktop.');
-    process.exit(1);
-  }
-
-  // Check if MCP Python package is installed
-  const hasMCP = await checkPythonModule(pythonCmd, 'mcp');
-  if (!hasMCP) {
-    // Try to install MCP package directly
-    try {
-      const installCmd = `${pythonCmd} -m pip install --user mcp`;
-      const installProc = spawn(pythonCmd, ['-m', 'pip', 'install', '--user', 'mcp'], {
-        stdio: 'pipe',
-        shell: false
-      });
-
-      await new Promise((resolve, reject) => {
-        installProc.on('close', (code) => {
-          if (code === 0) {
-            resolve();
-          } else {
-            console.error('ERROR: Failed to install Python mcp package. Run: pip install mcp');
-            reject(new Error('Dependency installation failed'));
-          }
-        });
-      });
-    } catch (err) {
-      console.error('ERROR: Failed to install Python mcp package. Run: pip install mcp');
-      process.exit(1);
-    }
-  }
-
-  // Launch the Python MCP server
-  const serverProc = spawn(pythonCmd, [MCP_SERVER], {
-    stdio: 'inherit',
-    env: process.env
-  });
-
-  serverProc.on('error', (err) => {
-    console.error('❌ Failed to start MCP server:', err.message);
-    process.exit(1);
-  });
-
-  serverProc.on('close', (code) => {
-    process.exit(code || 0);
-  });
-
-  // Handle termination signals
-  process.on('SIGINT', () => serverProc.kill('SIGINT'));
-  process.on('SIGTERM', () => serverProc.kill('SIGTERM'));
-}
-
-main().catch((err) => {
-  console.error('❌ Error:', err.message);
-  process.exit(1);
-});
+
+/**
+ * AgentVibes MCP Server Launcher (Cross-Platform)
+ *
+ * This Node.js script replaces the bash wrapper to work on Windows, macOS, and Linux.
+ * It auto-installs Python dependencies and launches the Python MCP server.
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync } from 'fs';
+import { platform } from 'os';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Package root is one level up from bin/
+const PACKAGE_ROOT = join(__dirname, '..');
+const MCP_SERVER = join(PACKAGE_ROOT, 'mcp-server', 'server.py');
+const INSTALL_DEPS = join(PACKAGE_ROOT, 'mcp-server', 'install-deps.js');
+
+// Check if Python MCP server exists
+if (!existsSync(MCP_SERVER)) {
+  console.error(`❌ Error: MCP server not found at ${MCP_SERVER}`);
+  process.exit(1);
+}
+
+// Function to find available Python command
+async function findPythonCommand() {
+  const commands = platform() === 'win32' ? ['python', 'py', 'python3'] : ['python3', 'python'];
+
+  for (const cmd of commands) {
+    try {
+      const checkCmd = platform() === 'win32' ? 'where' : 'which';
+      const proc = spawn(checkCmd, [cmd], { stdio: 'ignore' });
+      const exists = await new Promise((resolve) => {
+        proc.on('close', (code) => resolve(code === 0));
+      });
+
+      if (exists) {
+        return cmd;
+      }
+    } catch (err) {
+      // Try next command
+    }
+  }
+
+  return null;
+}
+
+// Function to check if Python module is installed
+function checkPythonModule(pythonCmd, moduleName) {
+  return new Promise((resolve) => {
+    const proc = spawn(pythonCmd, ['-c', `import ${moduleName}`], { stdio: 'ignore' });
+    proc.on('close', (code) => resolve(code === 0));
+  });
+}
+
+// Main setup and launch function
+async function main() {
+  // Silent mode - no output to avoid breaking MCP JSON protocol
+
+  // Find Python command
+  const pythonCmd = await findPythonCommand();
+  if (!pythonCmd) {
+    console.error('ERROR: Python 3 not found. Install from https://python.org and restart Claude Desktop.');
+    process.exit(1);
+  }
+
+  // Check if MCP Python package is installed
+  const hasMCP = await checkPythonModule(pythonCmd, 'mcp');
+  if (!hasMCP) {
+    // Try to install MCP package directly
+    try {
+      const installCmd = `${pythonCmd} -m pip install --user mcp`;
+      const installProc = spawn(pythonCmd, ['-m', 'pip', 'install', '--user', 'mcp'], {
+        stdio: 'pipe',
+        shell: false
+      });
+
+      await new Promise((resolve, reject) => {
+        installProc.on('close', (code) => {
+          if (code === 0) {
+            resolve();
+          } else {
+            console.error('ERROR: Failed to install Python mcp package. Run: pip install mcp');
+            reject(new Error('Dependency installation failed'));
+          }
+        });
+      });
+    } catch (err) {
+      console.error('ERROR: Failed to install Python mcp package. Run: pip install mcp');
+      process.exit(1);
+    }
+  }
+
+  // Launch the Python MCP server
+  const serverProc = spawn(pythonCmd, [MCP_SERVER], {
+    stdio: 'inherit',
+    env: process.env
+  });
+
+  serverProc.on('error', (err) => {
+    console.error('❌ Failed to start MCP server:', err.message);
+    process.exit(1);
+  });
+
+  serverProc.on('close', (code) => {
+    process.exit(code || 0);
+  });
+
+  // Handle termination signals
+  process.on('SIGINT', () => serverProc.kill('SIGINT'));
+  process.on('SIGTERM', () => serverProc.kill('SIGTERM'));
+}
+
+main().catch((err) => {
+  console.error('❌ Error:', err.message);
+  process.exit(1);
+});

package/bin/mcp-server.sh

@@ -72,7 +72,7 @@ if ! python3 -c "import mcp" 2>/dev/null; then
     print_section "📦 Installing Python MCP Package"
     echo "Installing 'mcp' package to enable Claude Desktop integration..." >&2
 
-    if python3 -m pip install --user mcp --quiet 2>&1; then
+    if python3 -m pip install --user mcp --quiet >&2; then
         echo "✅ Python MCP package installed successfully!" >&2
     else
         echo "❌ Failed to auto-install MCP package" >&2
@@ -86,9 +86,10 @@ else
     echo "✅ Python MCP package already installed" >&2
 fi
 
-# Check provider (Piper vs ElevenLabs)
+# Check provider — ElevenLabs was removed from the product; Piper (free,
+# offline) is the only provider this wrapper does auto-setup for.
 PROVIDER_FILE="$PACKAGE_ROOT/.claude/tts-provider.txt"
-PROVIDER="elevenlabs"  # Default
+PROVIDER="piper"  # Default
 
 if [ -f "$PROVIDER_FILE" ]; then
     PROVIDER=$(cat "$PROVIDER_FILE" | tr -d '[:space:]')
@@ -104,7 +105,7 @@ if [ "$PROVIDER" = "piper" ]; then
             print_section "📦 Installing pipx"
             echo "pipx is needed to install Piper TTS..." >&2
 
-            if python3 -m pip install --user pipx --quiet 2>&1; then
+            if python3 -m pip install --user pipx --quiet >&2; then
                 # Add pipx to PATH for this session
                 export PATH="$HOME/.local/bin:$PATH"
 
@@ -137,7 +138,7 @@ if [ "$PROVIDER" = "piper" ]; then
             print_section "📦 Installing Piper TTS"
             echo "Installing Piper TTS (free, offline voice synthesis)..." >&2
 
-            if pipx install piper-tts --quiet 2>&1; then
+            if pipx install piper-tts --quiet >&2; then
                 echo "✅ Piper TTS installed successfully!" >&2
 
                 # Add pipx bin to PATH
@@ -181,20 +182,6 @@ if [ "$PROVIDER" = "piper" ]; then
             fi
         fi
     fi
-elif [ "$PROVIDER" = "elevenlabs" ]; then
-    # Check for ElevenLabs API key
-    if [ -z "$ELEVENLABS_API_KEY" ]; then
-        echo "⚠️  ElevenLabs selected but ELEVENLABS_API_KEY not set" >&2
-        echo "" >&2
-        echo "📖 Set your API key:" >&2
-        echo "   export ELEVENLABS_API_KEY='your-key-here'" >&2
-        echo "" >&2
-        echo "💡 Or switch to Piper TTS (free):" >&2
-        echo "   echo 'piper' > $PACKAGE_ROOT/.claude/tts-provider.txt" >&2
-        echo "" >&2
-    else
-        echo "✅ ElevenLabs API key configured" >&2
-    fi
 fi
 
 # All checks passed, run the MCP server

package/bin/resolve-utterance.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+/**
+ * File: bin/resolve-utterance.js
+ *
+ * CLI bridge between the pure Node utterance resolver and the bash/PowerShell/
+ * Python player scripts (Story AVI-S8.5, Stage 2). Reads all config once via the
+ * loader, resolves the plan, and prints it as one line of JSON on stdout.
+ *
+ * Players call this ONCE and execute the returned plan verbatim — they no longer
+ * read config or make precedence decisions themselves.
+ *
+ * Usage:
+ *   resolve-utterance.js --text "hello" [--llm claude-code] [--voice af_bella]
+ *       [--voice-source user-explicit] [--project-dir /path] [--personality pirate]
+ *
+ * Output (stdout):
+ *   default / --format json : a single JSON object (the UtterancePlan).
+ *   --format sh             : safe `AV_<FIELD>=<single-quoted>` lines a POSIX
+ *                             shell can `eval`. Booleans emit 'true'/'false';
+ *                             nested music/ssh fields flatten to AV_MUSIC_*,
+ *                             AV_SSH_*. This is how bash/zsh players consume the
+ *                             plan without a JSON parser.
+ * Nothing else is printed to stdout so callers can parse it directly;
+ * diagnostics go to stderr. Exit codes: 0 = plan emitted; 2 = the resolved plan
+ * failed validation (a loud failure — never emit a silently-wrong plan).
+ */
+
+'use strict';
+
+import os from 'node:os';
+import { gatherInputs } from '../src/services/utterance-loader.js';
+import { resolveUtterance, validatePlan } from '../src/services/utterance-resolver.js';
+
+/** Minimal --flag value parser (no external deps; players pass simple flags). */
+// Flags that take a value. For these we ALWAYS consume the next token as the
+// value — even if it starts with "--" (a message like "-- shipping now" must not
+// be misread as an absent value and turned into boolean true, which would make
+// TTS literally speak "true"). Anything else is treated as a boolean flag.
+const VALUE_FLAGS = new Set([
+  'text', 'voice', 'voiceSource', 'llm', 'personality',
+  'projectDir', 'packageRoot', 'format', 'language',
+]);
+function parseArgs(argv) {
+  const out = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (!a.startsWith('--')) continue;
+    const key = a.slice(2).replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+    if (VALUE_FLAGS.has(key)) {
+      out[key] = (i + 1 < argv.length) ? argv[++i] : '';
+    } else {
+      out[key] = true;
+    }
+  }
+  return out;
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const ctx = {
+    text: args.text ?? '',
+    voice: args.voice,
+    voiceSource: args.voiceSource,
+    llm: args.llm,
+    personality: args.personality,
+    projectDir: args.projectDir,
+    packageRoot: args.packageRoot,
+    homeDir: os.homedir(),
+    cwd: process.cwd(),
+    env: process.env,
+  };
+
+  let plan;
+  try {
+    const inputs = gatherInputs(ctx);
+    plan = resolveUtterance(inputs);
+  } catch (err) {
+    process.stderr.write(`resolve-utterance: failed to resolve plan: ${err.message}\n`);
+    process.exit(2);
+  }
+
+  const problems = validatePlan(plan);
+  if (problems.length) {
+    // Fail loud — a malformed plan must never be executed (silent-wrong audio).
+    process.stderr.write(`resolve-utterance: invalid plan: ${problems.join('; ')}\n`);
+    process.exit(2);
+  }
+
+  if (args.format === 'sh') {
+    process.stdout.write(toShell(plan));
+  } else {
+    process.stdout.write(JSON.stringify(plan) + '\n');
+  }
+}
+
+/** Single-quote a value for safe POSIX-shell eval (wrap, escaping embedded quotes). */
+function shq(v) {
+  return `'${String(v).replace(/'/g, `'\\''`)}'`;
+}
+
+/** Flatten a plan into `AV_<FIELD>=<quoted>` lines for `eval` in a shell player. */
+function toShell(plan) {
+  const b = (x) => (x ? 'true' : 'false');
+  const m = plan.music || {};
+  const s = plan.sshTarget || {};
+  const lines = [
+    `AV_TEXT=${shq(plan.text ?? '')}`,
+    `AV_VOICE=${shq(plan.voice ?? '')}`,
+    `AV_VOICE_IS_OVERRIDE=${b(plan.voiceIsOverride)}`,
+    `AV_ENGINE=${shq(plan.engine ?? '')}`,
+    `AV_TRANSPORT=${shq(plan.transport ?? 'local')}`,
+    `AV_VOICE_MODEL=${shq(plan.voiceModel ?? '')}`,
+    `AV_SPEAKER_ID=${shq(plan.speakerId ?? '')}`,
+    `AV_PERSONALITY=${shq(plan.personality ?? '')}`,
+    `AV_LANGUAGE=${shq(plan.language ?? '')}`,
+    `AV_PRETEXT=${shq(plan.pretext ?? '')}`,
+    `AV_SPEED=${shq(plan.speed ?? '')}`,
+    `AV_REVERB=${shq(plan.reverb ?? 'off')}`,
+    `AV_EFFECTS=${shq(plan.effects ?? '')}`,
+    `AV_MUSIC_ENABLED=${b(m.enabled)}`,
+    `AV_MUSIC_TRACK=${shq(m.track ?? '')}`,
+    `AV_MUSIC_VOLUME=${shq(m.volume ?? '')}`,
+    `AV_MUTE=${b(plan.mute)}`,
+    `AV_RDP_MODE=${b(plan.rdpMode)}`,
+    `AV_NO_PLAYBACK=${b(plan.noPlayback)}`,
+    `AV_TEST_MODE=${b(plan.testMode)}`,
+    `AV_LLM_KEY=${shq(plan.llmKey ?? '')}`,
+    `AV_PROJECT_DIR=${shq(plan.projectDir ?? '')}`,
+    `AV_SSH_HOST=${shq(s.host ?? '')}`,
+    `AV_SSH_PORT=${shq(s.port ?? '')}`,
+    `AV_SSH_PASS_PORT_FLAG=${b(s.passPortFlag)}`,
+    `AV_SSH_KEY=${shq(s.key ?? '')}`,
+  ];
+  return lines.join('\n') + '\n';
+}
+
+main();

package/bin/test-bmad-pr

@@ -1,79 +1,79 @@
 #!/usr/bin/env bash
-#
-# AgentVibes BMAD PR Testing Command
-# Quick command to test BMAD PRs with AgentVibes integration
-#
-# Usage:
-#   npx agentvibes test-bmad-pr [PR_NUMBER]
-#   npx agentvibes test-bmad-pr 934
-#
-
-set -e
-
-# Colors
-GREEN='\033[0;32m'
-BLUE='\033[0;34m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-NC='\033[0m' # No Color
-
-# Default PR number
-PR_NUMBER="${1:-934}"
-
-clear
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo -e "${CYAN}🎙️  AgentVibes BMAD PR Testing Tool${NC}"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo -e "${BLUE}Testing PR #${PR_NUMBER}${NC}"
-echo ""
-echo -e "${YELLOW}This will download and run the automated test script for${NC}"
-echo -e "${YELLOW}BMAD's AgentVibes integration with multi-agent party mode.${NC}"
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-# Create temp directory for the script
-TEMP_DIR=$(mktemp -d)
-SCRIPT_PATH="$TEMP_DIR/test-bmad-pr.sh"
-
-echo -e "${BLUE}📥 Downloading test script...${NC}"
-
-# Download the test script from the PR branch
-SCRIPT_URL="https://raw.githubusercontent.com/paulpreibisch/BMAD-METHOD/feature/agentvibes-tts-integration/test-bmad-pr.sh"
-
-if curl -fsSL "$SCRIPT_URL" -o "$SCRIPT_PATH"; then
-    chmod +x "$SCRIPT_PATH"
-    echo -e "${GREEN}✓ Test script downloaded${NC}"
-    echo ""
-
-    # Run the test script
-    exec "$SCRIPT_PATH"
-else
-    echo -e "${YELLOW}⚠ Could not download test script from PR branch${NC}"
-    echo ""
-    echo "Trying alternative: Official BMAD repository..."
-    echo ""
-
-    # Fallback to official repo
-    SCRIPT_URL="https://raw.githubusercontent.com/bmad-code-org/BMAD-METHOD/refs/pull/${PR_NUMBER}/merge/test-bmad-pr.sh"
-
-    if curl -fsSL "$SCRIPT_URL" -o "$SCRIPT_PATH"; then
-        chmod +x "$SCRIPT_PATH"
-        echo -e "${GREEN}✓ Test script downloaded${NC}"
-        echo ""
-        exec "$SCRIPT_PATH"
-    else
-        echo -e "${YELLOW}⚠ Could not download test script${NC}"
-        echo ""
-        echo "Please try manual testing:"
-        echo -e "${GREEN}git clone https://github.com/bmad-code-org/BMAD-METHOD.git${NC}"
-        echo -e "${GREEN}cd BMAD-METHOD${NC}"
-        echo -e "${GREEN}git fetch origin pull/${PR_NUMBER}/head:test-pr-${PR_NUMBER}${NC}"
-        echo -e "${GREEN}git checkout test-pr-${PR_NUMBER}${NC}"
-        echo ""
-        exit 1
-    fi
-fi
+#
+# AgentVibes BMAD PR Testing Command
+# Quick command to test BMAD PRs with AgentVibes integration
+#
+# Usage:
+#   npx agentvibes test-bmad-pr [PR_NUMBER]
+#   npx agentvibes test-bmad-pr 934
+#
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Default PR number
+PR_NUMBER="${1:-934}"
+
+clear
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${CYAN}🎙️  AgentVibes BMAD PR Testing Tool${NC}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${BLUE}Testing PR #${PR_NUMBER}${NC}"
+echo ""
+echo -e "${YELLOW}This will download and run the automated test script for${NC}"
+echo -e "${YELLOW}BMAD's AgentVibes integration with multi-agent party mode.${NC}"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Create temp directory for the script
+TEMP_DIR=$(mktemp -d)
+SCRIPT_PATH="$TEMP_DIR/test-bmad-pr.sh"
+
+echo -e "${BLUE}📥 Downloading test script...${NC}"
+
+# Download the test script from the PR branch
+SCRIPT_URL="https://raw.githubusercontent.com/paulpreibisch/BMAD-METHOD/feature/agentvibes-tts-integration/test-bmad-pr.sh"
+
+if curl -fsSL "$SCRIPT_URL" -o "$SCRIPT_PATH"; then
+    chmod +x "$SCRIPT_PATH"
+    echo -e "${GREEN}✓ Test script downloaded${NC}"
+    echo ""
+
+    # Run the test script
+    exec "$SCRIPT_PATH"
+else
+    echo -e "${YELLOW}⚠ Could not download test script from PR branch${NC}"
+    echo ""
+    echo "Trying alternative: Official BMAD repository..."
+    echo ""
+
+    # Fallback to official repo
+    SCRIPT_URL="https://raw.githubusercontent.com/bmad-code-org/BMAD-METHOD/refs/pull/${PR_NUMBER}/merge/test-bmad-pr.sh"
+
+    if curl -fsSL "$SCRIPT_URL" -o "$SCRIPT_PATH"; then
+        chmod +x "$SCRIPT_PATH"
+        echo -e "${GREEN}✓ Test script downloaded${NC}"
+        echo ""
+        exec "$SCRIPT_PATH"
+    else
+        echo -e "${YELLOW}⚠ Could not download test script${NC}"
+        echo ""
+        echo "Please try manual testing:"
+        echo -e "${GREEN}git clone https://github.com/bmad-code-org/BMAD-METHOD.git${NC}"
+        echo -e "${GREEN}cd BMAD-METHOD${NC}"
+        echo -e "${GREEN}git fetch origin pull/${PR_NUMBER}/head:test-pr-${PR_NUMBER}${NC}"
+        echo -e "${GREEN}git checkout test-pr-${PR_NUMBER}${NC}"
+        echo ""
+        exit 1
+    fi
+fi