voicci 1.0.10 → 1.1.1

package/README.md

@@ -25,11 +25,27 @@ Transform books and PDFs into audiobooks using natural language with Claude Code
 
 ### Installation
 
+**Prerequisites** (one-time):
+
+- Node.js 22+
+- Python 3.10+
+- `pip3 install TTS torch torchaudio` — Voicci uses XTTS v2 locally (PyTorch + Coqui TTS; ~2 GB of model weights download on first run)
+
+**Install the CLI:**
+
 ```bash
 npm install -g voicci
 ```
 
-That's it! The package installs both the CLI tool and Claude Code skill automatically.
+**Verify everything is wired up:**
+
+```bash
+voicci doctor
+```
+
+`voicci doctor` prints a PASS/FAIL table for Node, Python, TTS, PyTorch, acceleration (MPS/CUDA/CPU), and the AI-editor skill directory. If anything fails, it tells you the exact command to fix it.
+
+The npm package installs the CLI plus the Claude Code / OpenCode / Cursor / Windsurf skill files. **Restart your AI editor** after install so it picks up `/voicci`.
 
 ### Usage with AI Code Editors
 

package/cli/index.js

@@ -21,6 +21,30 @@ const pkg = require('../package.json');
 const execAsync = promisify(exec);
 const execFileAsync = promisify(execFile);
 
+// Cross-platform open command
+function getOpenCommand() {
+  const platform = process.platform;
+  if (platform === 'darwin') return 'open';
+  if (platform === 'win32') return 'start';
+  return 'xdg-open'; // Linux
+}
+
+// Check if Python TTS dependencies are available
+async function checkTTSDependencies() {
+  try {
+    await execFileAsync('python3', ['-c', 'from TTS.api import TTS; print("ok")']);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Check if input looks like a file path (has a supported extension)
+function looksLikeFilePath(input) {
+  const ext = path.extname(input).toLowerCase();
+  return ['.pdf', '.txt'].includes(ext);
+}
+
 const program = new Command();
 
 program
@@ -78,20 +102,24 @@ program
 
       // Process file or search query
       if (input) {
-        // Check if input is a file path
-        if (fs.existsSync(input)) {
-          // Validate file path for security
-          try {
-            const validatedPath = pathValidator.validateFilePath(input, {
-              mustExist: true,
-              allowedExtensions: ['.pdf', '.txt']
-            });
-            await processFile(validatedPath, options);
-          } catch (error) {
-            console.error('Error: Invalid file path');
-            console.error(error.message);
+        if (looksLikeFilePath(input)) {
+          // Input has a recognized file extension — must exist
+          if (!fs.existsSync(input)) {
+            console.error(`Error: File not found: ${input}`);
             process.exit(1);
           }
+          const validatedPath = pathValidator.validateFilePath(input, {
+            mustExist: true,
+            allowedExtensions: ['.pdf', '.txt']
+          });
+          await processFile(validatedPath, options);
+        } else if (fs.existsSync(input)) {
+          // Existing file without recognized extension
+          const validatedPath = pathValidator.validateFilePath(input, {
+            mustExist: true,
+            allowedExtensions: ['.pdf', '.txt']
+          });
+          await processFile(validatedPath, options);
         } else {
           // Treat as search query
           console.log(`Searching for: "${input}"\n`);
@@ -154,6 +182,17 @@ async function processFile(filePath, options = {}) {
     if (summaryOnly) return; // Don't create audiobook job
   }
 
+  // Check Python TTS dependencies before creating job
+  const hasTTS = await checkTTSDependencies();
+  if (!hasTTS) {
+    console.error('\n❌ Python TTS dependencies not found.');
+    console.error('\nTo generate audiobooks, install the required Python packages:');
+    console.error('  pip3 install TTS torch torchaudio\n');
+    console.error('This is a one-time setup (~2GB download).');
+    console.error('After installing, run your command again.\n');
+    throw new Error('Python TTS dependencies not installed');
+  }
+
   // Create job
   console.log('📋 Creating job...');
   const queue = new Queue();
@@ -212,7 +251,7 @@ async function generateSummary(filePath, text, summaryOnly = false) {
     console.log('─'.repeat(60));
     console.log(result.summary.substring(0, 500) + '...\n');
     console.log('─'.repeat(60));
-    console.log(`\nOpen full summary: open "${summaryPath}"\n`);
+    console.log(`\nOpen full summary: ${getOpenCommand()} "${summaryPath}"\n`);
   }
 }
 
@@ -388,7 +427,7 @@ async function openAudiobook(jobId) {
   if (jobId === true || !jobId) {
     // Open audiobooks directory
     const audiobooksDir = config.paths.audiobooks;
-    await execFileAsync('open', [audiobooksDir]);
+    await execFileAsync(getOpenCommand(), [audiobooksDir]);
     console.log(`Opened: ${audiobooksDir}\n`);
   } else {
     // Open specific job
@@ -406,7 +445,7 @@ async function openAudiobook(jobId) {
       return;
     }
 
-    await execFileAsync('open', [job.output_dir]);
+    await execFileAsync(getOpenCommand(), [job.output_dir]);
     console.log(`Opened: ${job.output_dir}\n`);
   }
 
@@ -721,4 +760,133 @@ program
     console.log();
   });
 
+program
+  .command('doctor')
+  .description('Verify Node, Python, TTS, PyTorch, and AI-editor skill installation')
+  .option('--json', 'Output machine-readable JSON')
+  .action(async (options) => {
+    const results = await runDoctor();
+    if (options.json) {
+      console.log(JSON.stringify(results, null, 2));
+    } else {
+      printDoctorReport(results);
+    }
+    const failed = results.checks.some(c => c.status === 'fail');
+    process.exit(failed ? 1 : 0);
+  });
+
+async function runDoctor() {
+  const os = await import('os');
+  const checks = [];
+
+  const nodeMajor = parseInt(process.versions.node.split('.')[0], 10);
+  checks.push({
+    name: 'Node.js ≥ 22',
+    status: nodeMajor >= 22 ? 'pass' : 'fail',
+    detail: `v${process.versions.node}`,
+    fix: nodeMajor >= 22 ? null : 'Install Node 22+: https://nodejs.org/en/download',
+  });
+
+  let pythonCmd = null;
+  let pythonVersion = null;
+  for (const cand of ['python3', 'python']) {
+    try {
+      const { stdout } = await execFileAsync(cand, ['--version']);
+      const m = stdout.match(/Python (\d+)\.(\d+)/);
+      if (m) {
+        pythonCmd = cand;
+        pythonVersion = `${m[1]}.${m[2]}`;
+        if (parseInt(m[1], 10) === 3 && parseInt(m[2], 10) >= 10) break;
+      }
+    } catch {}
+  }
+  const pyOk = pythonVersion && parseInt(pythonVersion.split('.')[0], 10) === 3 && parseInt(pythonVersion.split('.')[1], 10) >= 10;
+  checks.push({
+    name: 'Python ≥ 3.10',
+    status: pyOk ? 'pass' : 'fail',
+    detail: pythonVersion ? `${pythonCmd} ${pythonVersion}` : 'not found',
+    fix: pyOk ? null : 'Install Python 3.10+: https://www.python.org/downloads/',
+  });
+
+  let torchOk = false, torchDetail = 'not importable';
+  if (pythonCmd) {
+    try {
+      const { stdout } = await execFileAsync(pythonCmd, ['-c', 'import torch; print(torch.__version__)']);
+      torchOk = true;
+      torchDetail = `torch ${stdout.trim()}`;
+    } catch {}
+  }
+  checks.push({
+    name: 'PyTorch',
+    status: torchOk ? 'pass' : 'fail',
+    detail: torchDetail,
+    fix: torchOk ? null : `${pythonCmd || 'pip3'} -m pip install torch torchaudio`,
+  });
+
+  let ttsOk = false, ttsDetail = 'not importable';
+  if (pythonCmd) {
+    try {
+      const { stdout } = await execFileAsync(pythonCmd, ['-c', 'import TTS; print(TTS.__version__)']);
+      ttsOk = true;
+      ttsDetail = `TTS ${stdout.trim()}`;
+    } catch {}
+  }
+  checks.push({
+    name: 'TTS (XTTS v2)',
+    status: ttsOk ? 'pass' : 'fail',
+    detail: ttsDetail,
+    fix: ttsOk ? null : `${pythonCmd || 'pip3'} -m pip install TTS`,
+  });
+
+  let accel = 'cpu';
+  if (pythonCmd && torchOk) {
+    try {
+      const { stdout } = await execFileAsync(pythonCmd, ['-c',
+        'import torch; print("mps" if torch.backends.mps.is_available() else ("cuda" if torch.cuda.is_available() else "cpu"))']);
+      accel = stdout.trim();
+    } catch {}
+  }
+  checks.push({
+    name: 'Acceleration',
+    status: accel === 'cpu' ? 'warn' : 'pass',
+    detail: accel.toUpperCase(),
+    fix: accel === 'cpu' ? 'CPU works but is slow. M-series/NVIDIA recommended.' : null,
+  });
+
+  const home = os.homedir();
+  const skillPath = path.join(home, '.claude', 'skills', 'voicci', 'SKILL.md');
+  const skillExists = fs.existsSync(skillPath);
+  checks.push({
+    name: 'Claude Code skill',
+    status: skillExists ? 'pass' : 'warn',
+    detail: skillExists ? skillPath : 'not installed (harmless if you do not use Claude Code)',
+    fix: skillExists ? null : 'Re-run: npm install -g voicci',
+  });
+
+  return {
+    voicciVersion: pkg.version,
+    platform: process.platform,
+    arch: process.arch,
+    checks,
+  };
+}
+
+function printDoctorReport(results) {
+  console.log('\n🩺 Voicci Doctor\n');
+  console.log(`   voicci@${results.voicciVersion}  ·  ${results.platform}/${results.arch}\n`);
+  const pad = (s, n) => (s + ' '.repeat(n)).slice(0, n);
+  for (const c of results.checks) {
+    const icon = c.status === 'pass' ? '✅' : c.status === 'warn' ? '⚠️ ' : '❌';
+    console.log(`   ${icon}  ${pad(c.name, 22)} ${c.detail}`);
+    if (c.fix) console.log(`       ↳ ${c.fix}`);
+  }
+  const failed = results.checks.filter(c => c.status === 'fail');
+  console.log('');
+  if (failed.length === 0) {
+    console.log('   🎉 All required prerequisites look good. You are ready to generate audiobooks.\n');
+  } else {
+    console.log(`   ${failed.length} check(s) failed. Fix them and re-run \`voicci doctor\`.\n`);
+  }
+}
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voicci",
-  "version": "1.0.10",
+  "version": "1.1.1",
   "description": "AI-Powered Audiobook Generator for Claude Code, OpenCode & AI Code Editors. Convert books and PDFs to audiobooks using natural language.",
   "type": "module",
   "main": "cli/index.js",
@@ -10,7 +10,7 @@
   "scripts": {
     "start": "node cli/index.js",
     "worker": "node backend/worker.js",
-    "test": "node tests/test-cleaner.js",
+    "test": "node tests/test-cleaner.js && node tests/test-security.js",
     "postinstall": "node scripts/postinstall.js"
   },
   "keywords": [
@@ -22,7 +22,7 @@
     "text-to-speech",
     "cli",
     "pdf",
-    "epub",
+    "book",
     "summarization",
     "claude-code",
     "claude-skill",
@@ -39,10 +39,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/OlmiVanguard/voicci-cli.git"
+    "url": "https://github.com/daniel-mf-92/voicci-cli.git"
   },
   "bugs": {
-    "url": "https://github.com/OlmiVanguard/voicci-cli/issues"
+    "url": "https://github.com/daniel-mf-92/voicci-cli/issues"
   },
   "homepage": "https://voicci.com/voicci-cli",
   "dependencies": {