voicci 1.0.9 → 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.9",
+  "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": {

package/scripts/postinstall.js

@@ -9,12 +9,13 @@ import { execFileSync } from 'child_process';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-// Two skill files: simple and detailed
-const SKILL_NAME_SIMPLE = 'voicci.md';
-const SKILL_NAME_DETAILED = 'voicci-audiobook.md';
-
-const SKILL_CONTENT_SIMPLE = `---
-description: "Voicci - AI audiobook generator"
+// Skills use directory-based format: skills/<name>/SKILL.md
+const SKILLS = [
+  {
+    dirName: 'voicci',
+    content: `---
+name: voicci
+description: "Voicci - AI audiobook generator. Use when the user wants to convert books, PDFs, or documents to audiobooks."
 argument-hint: "COMMAND_OR_FILE"
 ---
 
@@ -33,10 +34,13 @@ Convert books, PDFs, and documents to audiobooks using AI text-to-speech.
 #!/bin/bash
 voicci $ARGUMENTS
 \`\`\`
-`;
-
-const SKILL_CONTENT_DETAILED = `---
-description: "Voicci - AI audiobook generator CLI"
+`
+  },
+  {
+    dirName: 'voicci-audiobook',
+    content: `---
+name: voicci-audiobook
+description: "Voicci - AI audiobook generator with full documentation. Use when the user needs detailed help with audiobook generation."
 argument-hint: "COMMAND_OR_FILE"
 ---
 
@@ -101,7 +105,6 @@ voicci memory
 
 \`\`\`!
 #!/bin/bash
-# Execute voicci with user-provided arguments
 voicci $ARGUMENTS
 \`\`\`
 
@@ -112,14 +115,9 @@ voicci $ARGUMENTS
   - macOS: \`~/Library/Application Support/voicci/audiobooks/\`
   - Linux: \`~/.local/share/voicci/audiobooks/\`
 - Copyright warning will appear before first book search
-
-## Usage Examples
-- \`/voicci-audiobook "Lord of the Rings"\` - Search and convert book
-- \`/voicci-audiobook ~/Documents/book.pdf\` - Convert local file
-- \`/voicci-audiobook -s\` - Check all job statuses
-- \`/voicci-audiobook summary book.pdf\` - Generate summary only
-- \`/voicci-audiobook --help\` - Show all options
-`;
+`
+  }
+];
 
 // Editor detection configurations
 const EDITORS = {
@@ -127,7 +125,6 @@ const EDITORS = {
     name: 'Claude Code',
     detect: () => {
       const homeDir = os.homedir();
-      // Check for claude command or .claude directory
       if (fs.existsSync(path.join(homeDir, '.claude'))) return true;
       try {
         execFileSync('which', ['claude'], { stdio: 'ignore' });
@@ -136,11 +133,7 @@ const EDITORS = {
         return false;
       }
     },
-    // Install to both skills/ and commands/ so slash commands appear in autocomplete
-    skillsDirs: () => [
-      path.join(os.homedir(), '.claude', 'commands'),
-      path.join(os.homedir(), '.claude', 'skills')
-    ]
+    skillsDir: () => path.join(os.homedir(), '.claude', 'skills')
   },
   'OpenCode': {
     name: 'OpenCode',
@@ -154,7 +147,7 @@ const EDITORS = {
         return false;
       }
     },
-    skillsDirs: () => [path.join(os.homedir(), '.opencode', 'skills')]
+    skillsDir: () => path.join(os.homedir(), '.opencode', 'skills')
   },
   'Cursor': {
     name: 'Cursor',
@@ -169,17 +162,16 @@ const EDITORS = {
         return false;
       }
     },
-    skillsDirs: () => {
+    skillsDir: () => {
       const homeDir = os.homedir();
       const locations = [
         path.join(homeDir, '.cursor', 'skills'),
         path.join(homeDir, 'Library', 'Application Support', 'Cursor', 'skills')
       ];
       for (const loc of locations) {
-        const parent = path.dirname(loc);
-        if (fs.existsSync(parent)) return [loc];
+        if (fs.existsSync(path.dirname(loc))) return loc;
       }
-      return [locations[0]];
+      return locations[0];
     }
   },
   'Windsurf': {
@@ -194,64 +186,65 @@ const EDITORS = {
         return false;
       }
     },
-    skillsDirs: () => [path.join(os.homedir(), '.windsurf', 'skills')]
+    skillsDir: () => path.join(os.homedir(), '.windsurf', 'skills')
   }
 };
 
-function installSkillFile(skillsDir, skillName, content) {
-  const skillFile = path.join(skillsDir, skillName);
-  
+function installSkill(skillsDir, skill) {
+  const skillDir = path.join(skillsDir, skill.dirName);
+  const skillFile = path.join(skillDir, 'SKILL.md');
+
   // Check if already installed
   if (fs.existsSync(skillFile)) {
     const existingContent = fs.readFileSync(skillFile, 'utf8');
-    if (existingContent.includes('voicci $ARGUMENTS')) {
+    if (existingContent.includes('voicci')) {
       return 'exists';
     }
   }
-  
-  // Write the skill file
-  fs.writeFileSync(skillFile, content, 'utf8');
+
+  // Create skill directory and write SKILL.md
+  fs.mkdirSync(skillDir, { recursive: true });
+  fs.writeFileSync(skillFile, skill.content, 'utf8');
+
+  // Clean up legacy flat file if it exists
+  const legacyFile = path.join(skillsDir, `${skill.dirName}.md`);
+  if (fs.existsSync(legacyFile)) {
+    fs.unlinkSync(legacyFile);
+  }
+
   return 'new';
 }
 
 function detectAndInstall() {
-  const homeDir = os.homedir();
   const installedEditors = [];
   const failedEditors = [];
 
-  console.log('🔍 Detecting AI code editors...\n');
+  console.log('Detecting AI code editors...\n');
 
-  // Detect and install for each editor
   for (const [key, editor] of Object.entries(EDITORS)) {
     try {
       if (editor.detect()) {
-        console.log(`✓ Found ${editor.name}`);
+        console.log(`  Found ${editor.name}`);
 
-        const dirs = editor.skillsDirs();
-
-        let anyNew = false;
-        let allExist = true;
+        const skillsDir = editor.skillsDir();
 
-        for (const skillsDir of dirs) {
-          // Create directory if it doesn't exist
-          if (!fs.existsSync(skillsDir)) {
-            fs.mkdirSync(skillsDir, { recursive: true });
-          }
+        // Create skills directory if needed
+        if (!fs.existsSync(skillsDir)) {
+          fs.mkdirSync(skillsDir, { recursive: true });
+        }
 
-          // Install both skills
-          const simpleStatus = installSkillFile(skillsDir, SKILL_NAME_SIMPLE, SKILL_CONTENT_SIMPLE);
-          const detailedStatus = installSkillFile(skillsDir, SKILL_NAME_DETAILED, SKILL_CONTENT_DETAILED);
+        let anyNew = false;
 
-          if (simpleStatus === 'new' || detailedStatus === 'new') {
+        for (const skill of SKILLS) {
+          const status = installSkill(skillsDir, skill);
+          if (status === 'new') {
             anyNew = true;
-            allExist = false;
-            if (simpleStatus === 'new') console.log(`  ↳ Installed: ${path.join(skillsDir, SKILL_NAME_SIMPLE)}`);
-            if (detailedStatus === 'new') console.log(`  ↳ Installed: ${path.join(skillsDir, SKILL_NAME_DETAILED)}`);
+            console.log(`    Installed: ${path.join(skillsDir, skill.dirName, 'SKILL.md')}`);
           }
         }
 
         if (!anyNew) {
-          console.log(`  ↳ Skills already installed`);
+          console.log(`    Skills already installed`);
           installedEditors.push({ name: editor.name, status: 'exists' });
         } else {
           installedEditors.push({ name: editor.name, status: 'new' });
@@ -263,37 +256,36 @@ function detectAndInstall() {
   }
 
   // Summary
-  console.log('\n' + '═'.repeat(60));
+  console.log('\n' + '='.repeat(60));
 
   if (installedEditors.length > 0) {
-    console.log('\n✅ Voicci CLI installed successfully!');
-    console.log('\n📦 Command-line tool: voicci');
-    console.log('🔧 Skill commands: /voicci  OR  /voicci-audiobook');
-    console.log('\n📍 Installed in:');
+    console.log('\nVoicci CLI installed successfully!');
+    console.log('\n  Command-line tool: voicci');
+    console.log('  Skill commands: /voicci  OR  /voicci-audiobook');
+    console.log('\n  Installed in:');
     installedEditors.forEach(editor => {
       const status = editor.status === 'new' ? '(new)' : '(already installed)';
-      console.log(`  • ${editor.name} ${status}`);
+      console.log(`    ${editor.name} ${status}`);
     });
 
-    console.log('\n💡 Usage:');
-    console.log('  1. Restart your AI code editor');
-    console.log('  2. Use: /voicci "search query" (simple)');
-    console.log('  3. Or: /voicci-audiobook "search query" (detailed docs)');
-    console.log('  4. Or CLI: voicci "your search query"');
+    console.log('\n  Usage:');
+    console.log('    1. Restart your AI code editor');
+    console.log('    2. Type: /voicci "search query"');
+    console.log('    3. Or CLI: voicci "your search query"');
   } else {
-    console.log('\n⚠️  No supported AI code editors detected');
-    console.log('\nSupported editors: Claude Code, OpenCode, Cursor, Windsurf');
-    console.log('\n✓ You can still use the CLI: voicci <command>');
+    console.log('\n  No supported AI code editors detected');
+    console.log('\n  Supported editors: Claude Code, OpenCode, Cursor, Windsurf');
+    console.log('\n  You can still use the CLI: voicci <command>');
   }
 
   if (failedEditors.length > 0) {
-    console.log('\n⚠️  Failed to install for:');
+    console.log('\n  Failed to install for:');
     failedEditors.forEach(({ name, error }) => {
-      console.log(`  • ${name}: ${error}`);
+      console.log(`    ${name}: ${error}`);
     });
   }
 
-  console.log('\n' + '═'.repeat(60));
+  console.log('\n' + '='.repeat(60));
   console.log();
 }