specweave 0.26.2 → 0.26.3

package/plugins/specweave/lib/hooks/translate-file.js.bak

@@ -1,289 +0,0 @@
-import fs from "fs-extra";
-import {
-  detectLanguage,
-  prepareTranslation,
-  postProcessTranslation,
-  validateTranslation,
-  getLanguageName,
-  formatCost
-} from "../../../../dist/src/utils/translation.js";
-async function translateFile(options) {
-  const { filePath, targetLang, preview, verbose } = options;
-  if (!await fs.pathExists(filePath)) {
-    throw new Error(`File not found: ${filePath}`);
-  }
-  if (verbose) {
-    console.log(`\u{1F4C4} Reading file: ${filePath}`);
-  }
-  const originalContent = await fs.readFile(filePath, "utf-8");
-  const detectionResult = detectLanguage(originalContent);
-  const sourceLanguage = detectionResult.language;
-  if (verbose) {
-    console.log(`\u{1F50D} Detected language: ${getLanguageName(sourceLanguage)} (confidence: ${(detectionResult.confidence * 100).toFixed(0)}%)`);
-  }
-  if (sourceLanguage === targetLang) {
-    if (verbose) {
-      console.log(`\u2705 File already in ${getLanguageName(targetLang)}, skipping translation`);
-    }
-    return {
-      success: true,
-      filePath,
-      sourceLanguage,
-      targetLanguage: targetLang,
-      warnings: [`Already in ${getLanguageName(targetLang)}`],
-      cost: 0,
-      tokensUsed: 0
-    };
-  }
-  if (sourceLanguage === "unknown") {
-    if (verbose) {
-      console.warn(`\u26A0\uFE0F  Could not detect language, assuming English`);
-    }
-    return {
-      success: false,
-      filePath,
-      sourceLanguage: "unknown",
-      targetLanguage: targetLang,
-      warnings: ["Language detection failed - file may already be in English or mixed language"],
-      cost: 0,
-      tokensUsed: 0
-    };
-  }
-  if (verbose) {
-    console.log(`\u{1F310} Translating from ${getLanguageName(sourceLanguage)} to ${getLanguageName(targetLang)}...`);
-    console.log(`\u{1F4B0} Estimated cost: ${formatCost(3e-3)} (using Haiku)`);
-  }
-  const prepared = prepareTranslation(originalContent, sourceLanguage, targetLang);
-  const translatedContent = await invokeLLMTranslation(prepared.prompt, verbose);
-  const finalContent = postProcessTranslation(translatedContent, prepared.preserved);
-  const warnings = validateTranslation(originalContent, finalContent);
-  if (warnings.length > 0 && verbose) {
-    console.warn(`\u26A0\uFE0F  Translation warnings:`);
-    warnings.forEach((w) => console.warn(`   - ${w}`));
-  }
-  if (preview) {
-    if (verbose) {
-      console.log(`
-\u{1F4CB} PREVIEW (first 500 chars):
-`);
-      console.log(finalContent.substring(0, 500));
-      console.log(`
-... (${finalContent.length} total characters)
-`);
-    }
-    return {
-      success: true,
-      filePath,
-      sourceLanguage,
-      targetLanguage: targetLang,
-      warnings,
-      cost: prepared.estimatedCost,
-      tokensUsed: prepared.estimatedTokens,
-      preview: finalContent
-    };
-  } else {
-    await fs.writeFile(filePath, finalContent, "utf-8");
-    if (verbose) {
-      console.log(`\u2705 Translation complete: ${filePath}`);
-      console.log(`   Tokens used: ${prepared.estimatedTokens.toLocaleString()}`);
-      console.log(`   Cost: ${formatCost(prepared.estimatedCost)}`);
-    }
-    return {
-      success: true,
-      filePath,
-      sourceLanguage,
-      targetLanguage: targetLang,
-      warnings,
-      cost: prepared.estimatedCost,
-      tokensUsed: prepared.estimatedTokens
-    };
-  }
-}
-async function invokeLLMTranslation(prompt, verbose) {
-  const contentMatch = prompt.match(/SOURCE DOCUMENT[^\n]*:\n---\n([\s\S]*?)\n---/);
-  const contentToTranslate = contentMatch ? contentMatch[1] : "";
-  const apiKey = process.env.ANTHROPIC_API_KEY;
-  if (apiKey) {
-    if (verbose) {
-      console.log(`
-\u{1F916} Translating via Anthropic API (Haiku model)...`);
-    }
-    try {
-      const Anthropic = await import("@anthropic-ai/sdk").then((m) => m.default);
-      const anthropic = new Anthropic({
-        apiKey
-      });
-      const message = await anthropic.messages.create({
-        model: "claude-3-haiku-20240307",
-        max_tokens: 8e3,
-        messages: [
-          {
-            role: "user",
-            content: prompt
-          }
-        ]
-      });
-      const translatedContent = message.content[0].type === "text" ? message.content[0].text : contentToTranslate;
-      if (verbose) {
-        console.log(`\u2705 Translation complete via API`);
-        console.log(`   Model: claude-3-haiku-20240307`);
-        console.log(`   Input tokens: ${message.usage.input_tokens}`);
-        console.log(`   Output tokens: ${message.usage.output_tokens}`);
-        console.log(`   Cost: ~$${((message.usage.input_tokens * 0.25 + message.usage.output_tokens * 1.25) / 1e6).toFixed(4)}`);
-      }
-      return translatedContent;
-    } catch (error) {
-      console.error(`
-\u274C API translation failed: ${error.message}`);
-      console.error(`   Falling back to manual translation instructions
-`);
-    }
-  }
-  const isInteractive = process.stdout.isTTY && process.env.CLAUDE_CODE_SESSION;
-  if (isInteractive) {
-    if (verbose) {
-      console.log(`
-\u{1F916} Invoking Claude Code translator skill...`);
-      console.log(`   (Tip: Set ANTHROPIC_API_KEY for fully automatic translation)
-`);
-    }
-    console.log("\n" + "=".repeat(80));
-    console.log("TRANSLATION REQUEST (translator skill will auto-activate):");
-    console.log("=".repeat(80));
-    console.log(prompt);
-    console.log("=".repeat(80) + "\n");
-    return `<!-- \u26A0\uFE0F TRANSLATION IN PROGRESS - Manual translation required via translator skill -->
-
-${contentToTranslate}`;
-  } else {
-    if (verbose) {
-      console.log(`
-\u{1F916} Generating translation (automated mode)...`);
-    }
-    console.error("\n\u26A0\uFE0F  AUTO-TRANSLATION REQUIRES MANUAL STEP:");
-    console.error("   Option A (Recommended): Set ANTHROPIC_API_KEY environment variable");
-    console.error("   Option B: Run /specweave:translate <file-path>");
-    console.error("   Option C: Manually translate the content\n");
-    return `<!-- \u26A0\uFE0F AUTO-TRANSLATION PENDING -->
-<!-- Set ANTHROPIC_API_KEY for automatic translation -->
-<!-- Or run: /specweave:translate to complete -->
-<!-- Original content below -->
-
-${contentToTranslate}`;
-  }
-}
-async function batchTranslateFiles(filePaths, targetLang = "en", preview = false, verbose = false) {
-  const results = [];
-  if (verbose) {
-    console.log(`
-\u{1F504} Batch translating ${filePaths.length} file(s) to ${getLanguageName(targetLang)}...
-`);
-  }
-  for (const filePath of filePaths) {
-    try {
-      const result = await translateFile({
-        filePath,
-        targetLang,
-        preview,
-        verbose
-      });
-      results.push(result);
-    } catch (error) {
-      if (verbose) {
-        console.error(`\u274C Error translating ${filePath}: ${error.message}`);
-      }
-      results.push({
-        success: false,
-        filePath,
-        sourceLanguage: "unknown",
-        targetLanguage: targetLang,
-        warnings: [error.message],
-        cost: 0,
-        tokensUsed: 0
-      });
-    }
-  }
-  if (verbose) {
-    const successful = results.filter((r) => r.success).length;
-    const totalCost = results.reduce((sum, r) => sum + r.cost, 0);
-    const totalTokens = results.reduce((sum, r) => sum + r.tokensUsed, 0);
-    console.log(`
-\u{1F4CA} Batch Translation Summary:`);
-    console.log(`   Successful: ${successful}/${filePaths.length}`);
-    console.log(`   Total tokens: ${totalTokens.toLocaleString()}`);
-    console.log(`   Total cost: ${formatCost(totalCost)}`);
-  }
-  return results;
-}
-function parseArgs() {
-  const args = process.argv.slice(2);
-  if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
-    console.log(`
-Translation CLI Utility
-
-Usage:
-  node translate-file.js <file-path> [options]
-
-Options:
-  --target-lang <code>  Target language (default: en)
-  --preview             Preview translation without writing to file
-  --verbose, -v         Show detailed output
-  --help, -h            Show this help message
-
-Supported Languages:
-  en (English), ru (Russian), es (Spanish), zh (Chinese),
-  de (German), fr (French), ja (Japanese), ko (Korean),
-  pt (Portuguese), ar (Arabic), he (Hebrew)
-
-Examples:
-  # Translate Russian file to English
-  node translate-file.js .specweave/increments/0001/spec.md
-
-  # Preview translation
-  node translate-file.js spec.md --preview --verbose
-
-  # Translate to Spanish
-  node translate-file.js plan.md --target-lang es
-    `.trim());
-    process.exit(0);
-  }
-  const filePath = args[0];
-  let targetLang = "en";
-  let preview = false;
-  let verbose = false;
-  for (let i = 1; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--target-lang" && args[i + 1]) {
-      targetLang = args[i + 1];
-      i++;
-    } else if (arg === "--preview") {
-      preview = true;
-    } else if (arg === "--verbose" || arg === "-v") {
-      verbose = true;
-    }
-  }
-  return {
-    filePath,
-    targetLang,
-    preview,
-    verbose
-  };
-}
-async function main() {
-  try {
-    const options = parseArgs();
-    const result = await translateFile(options);
-    process.exit(result.success ? 0 : 1);
-  } catch (error) {
-    console.error(`\u274C Translation failed: ${error.message}`);
-    process.exit(1);
-  }
-}
-const isMainModule = import.meta.url === `file://${process.argv[1]}`;
-if (isMainModule) {
-  main();
-}
-export {
-  batchTranslateFiles,
-  translateFile
-};

package/plugins/specweave/lib/hooks/translate-file.ts.bak

@@ -1,428 +0,0 @@
-/**
- * File Translation CLI Utility
- *
- * Translates a single file from detected source language to target language
- * using the translation utilities and LLM invocation.
- *
- * This script is called from:
- * - Post-increment-planning hook (auto-translate spec.md, plan.md, tasks.md)
- * - Post-task-completion hook (auto-translate living docs)
- * - Manual /specweave:translate command
- *
- * Usage:
- *   node translate-file.js <file-path> [--target-lang en] [--preview]
- *
- * @see src/utils/translation.ts
- * @see .specweave/increments/0006-llm-native-i18n/reports/DESIGN-POST-GENERATION-TRANSLATION.md
- */
-
-import fs from 'fs-extra';
-import path from 'path';
-import {
-  detectLanguage,
-  prepareTranslation,
-  postProcessTranslation,
-  validateTranslation,
-  getLanguageName,
-  formatCost,
-  type SupportedLanguage,
-} from '../../../../dist/src/utils/translation.js';
-
-/**
- * CLI options
- */
-interface CLIOptions {
-  filePath: string;
-  targetLang: SupportedLanguage;
-  preview: boolean;
-  verbose: boolean;
-}
-
-/**
- * Translation result
- */
-interface FileTranslationResult {
-  success: boolean;
-  filePath: string;
-  sourceLanguage: SupportedLanguage;
-  targetLanguage: SupportedLanguage;
-  warnings: string[];
-  cost: number;
-  tokensUsed: number;
-  preview?: string;
-}
-
-/**
- * Main translation function
- *
- * @param options - CLI options
- * @returns Translation result
- */
-export async function translateFile(options: CLIOptions): Promise<FileTranslationResult> {
-  const { filePath, targetLang, preview, verbose } = options;
-
-  // 1. Validate file exists
-  if (!await fs.pathExists(filePath)) {
-    throw new Error(`File not found: ${filePath}`);
-  }
-
-  if (verbose) {
-    console.log(`📄 Reading file: ${filePath}`);
-  }
-
-  // 2. Read original content
-  const originalContent = await fs.readFile(filePath, 'utf-8');
-
-  // 3. Detect source language
-  const detectionResult = detectLanguage(originalContent);
-  const sourceLanguage = detectionResult.language;
-
-  if (verbose) {
-    console.log(`🔍 Detected language: ${getLanguageName(sourceLanguage)} (confidence: ${(detectionResult.confidence * 100).toFixed(0)}%)`);
-  }
-
-  // 4. Check if already in target language
-  if (sourceLanguage === targetLang) {
-    if (verbose) {
-      console.log(`✅ File already in ${getLanguageName(targetLang)}, skipping translation`);
-    }
-    return {
-      success: true,
-      filePath,
-      sourceLanguage,
-      targetLanguage: targetLang,
-      warnings: [`Already in ${getLanguageName(targetLang)}`],
-      cost: 0,
-      tokensUsed: 0,
-    };
-  }
-
-  // 5. Check if source language is unknown
-  if (sourceLanguage === 'unknown') {
-    if (verbose) {
-      console.warn(`⚠️  Could not detect language, assuming English`);
-    }
-    // Assume English if detection fails
-    return {
-      success: false,
-      filePath,
-      sourceLanguage: 'unknown',
-      targetLanguage: targetLang,
-      warnings: ['Language detection failed - file may already be in English or mixed language'],
-      cost: 0,
-      tokensUsed: 0,
-    };
-  }
-
-  // 6. Prepare translation
-  if (verbose) {
-    console.log(`🌐 Translating from ${getLanguageName(sourceLanguage)} to ${getLanguageName(targetLang)}...`);
-    console.log(`💰 Estimated cost: ${formatCost(0.003)} (using Haiku)`);
-  }
-
-  const prepared = prepareTranslation(originalContent, sourceLanguage, targetLang);
-
-  // 7. Invoke LLM for translation
-  // NOTE: This is where we call the actual LLM
-  // For now, we'll create a simple prompt that can be used with Claude Code's Task tool
-  const translatedContent = await invokeLLMTranslation(prepared.prompt, verbose);
-
-  // 8. Post-process translation
-  const finalContent = postProcessTranslation(translatedContent, prepared.preserved);
-
-  // 9. Validate translation
-  const warnings = validateTranslation(originalContent, finalContent);
-
-  if (warnings.length > 0 && verbose) {
-    console.warn(`⚠️  Translation warnings:`);
-    warnings.forEach(w => console.warn(`   - ${w}`));
-  }
-
-  // 10. Preview or write
-  if (preview) {
-    if (verbose) {
-      console.log(`\n📋 PREVIEW (first 500 chars):\n`);
-      console.log(finalContent.substring(0, 500));
-      console.log(`\n... (${finalContent.length} total characters)\n`);
-    }
-    return {
-      success: true,
-      filePath,
-      sourceLanguage,
-      targetLanguage: targetLang,
-      warnings,
-      cost: prepared.estimatedCost,
-      tokensUsed: prepared.estimatedTokens,
-      preview: finalContent,
-    };
-  } else {
-    // Write translated content back to file
-    await fs.writeFile(filePath, finalContent, 'utf-8');
-
-    if (verbose) {
-      console.log(`✅ Translation complete: ${filePath}`);
-      console.log(`   Tokens used: ${prepared.estimatedTokens.toLocaleString()}`);
-      console.log(`   Cost: ${formatCost(prepared.estimatedCost)}`);
-    }
-
-    return {
-      success: true,
-      filePath,
-      sourceLanguage,
-      targetLanguage: targetLang,
-      warnings,
-      cost: prepared.estimatedCost,
-      tokensUsed: prepared.estimatedTokens,
-    };
-  }
-}
-
-/**
- * Invokes LLM for translation using Anthropic API
- *
- * PRODUCTION IMPLEMENTATION:
- * 1. Checks for ANTHROPIC_API_KEY in environment
- * 2. If available: Uses Anthropic API directly (fully automatic)
- * 3. If not available: Provides clear instructions for manual translation
- *
- * @param prompt - Translation prompt
- * @param verbose - Show detailed output
- * @returns Translated content
- */
-async function invokeLLMTranslation(prompt: string, verbose: boolean): Promise<string> {
-  // Extract the content to translate (between --- markers)
-  const contentMatch = prompt.match(/SOURCE DOCUMENT[^\n]*:\n---\n([\s\S]*?)\n---/);
-  const contentToTranslate = contentMatch ? contentMatch[1] : '';
-
-  // Check if ANTHROPIC_API_KEY is available
-  const apiKey = process.env.ANTHROPIC_API_KEY;
-
-  if (apiKey) {
-    // Fully automatic translation using Anthropic API
-    if (verbose) {
-      console.log(`\n🤖 Translating via Anthropic API (Haiku model)...`);
-    }
-
-    try {
-      // Dynamic import of Anthropic SDK (allows graceful fallback if not installed)
-      const Anthropic = await import('@anthropic-ai/sdk').then(m => m.default);
-
-      const anthropic = new Anthropic({
-        apiKey,
-      });
-
-      const message = await anthropic.messages.create({
-        model: 'claude-3-haiku-20240307',
-        max_tokens: 8000,
-        messages: [
-          {
-            role: 'user',
-            content: prompt,
-          },
-        ],
-      });
-
-      // Extract translated content from response
-      const translatedContent = message.content[0].type === 'text'
-        ? message.content[0].text
-        : contentToTranslate;
-
-      if (verbose) {
-        console.log(`✅ Translation complete via API`);
-        console.log(`   Model: claude-3-haiku-20240307`);
-        console.log(`   Input tokens: ${message.usage.input_tokens}`);
-        console.log(`   Output tokens: ${message.usage.output_tokens}`);
-        console.log(`   Cost: ~$${((message.usage.input_tokens * 0.25 + message.usage.output_tokens * 1.25) / 1000000).toFixed(4)}`);
-      }
-
-      return translatedContent;
-    } catch (error: any) {
-      console.error(`\n❌ API translation failed: ${error.message}`);
-      console.error(`   Falling back to manual translation instructions\n`);
-      // Fall through to manual instructions
-    }
-  }
-
-  // Fallback: Manual translation instructions
-  const isInteractive = process.stdout.isTTY && process.env.CLAUDE_CODE_SESSION;
-
-  if (isInteractive) {
-    // Interactive mode: Output prompt for Claude to process
-    if (verbose) {
-      console.log(`\n🤖 Invoking Claude Code translator skill...`);
-      console.log(`   (Tip: Set ANTHROPIC_API_KEY for fully automatic translation)\n`);
-    }
-
-    // Output the translation prompt
-    // The translator skill should auto-activate on this prompt
-    console.log('\n' + '='.repeat(80));
-    console.log('TRANSLATION REQUEST (translator skill will auto-activate):');
-    console.log('='.repeat(80));
-    console.log(prompt);
-    console.log('='.repeat(80) + '\n');
-
-    // In interactive mode, we expect the user/Claude to provide translation
-    // For now, return a marker indicating manual intervention needed
-    return `<!-- ⚠️ TRANSLATION IN PROGRESS - Manual translation required via translator skill -->\n\n${contentToTranslate}`;
-  } else {
-    // Non-interactive/automated mode: Provide clear instructions
-    if (verbose) {
-      console.log(`\n🤖 Generating translation (automated mode)...`);
-    }
-
-    console.error('\n⚠️  AUTO-TRANSLATION REQUIRES MANUAL STEP:');
-    console.error('   Option A (Recommended): Set ANTHROPIC_API_KEY environment variable');
-    console.error('   Option B: Run /specweave:translate <file-path>');
-    console.error('   Option C: Manually translate the content\n');
-
-    // Return original content with clear marker
-    return `<!-- ⚠️ AUTO-TRANSLATION PENDING -->\n<!-- Set ANTHROPIC_API_KEY for automatic translation -->\n<!-- Or run: /specweave:translate to complete -->\n<!-- Original content below -->\n\n${contentToTranslate}`;
-  }
-}
-
-/**
- * Batch translate multiple files
- *
- * @param filePaths - Array of file paths to translate
- * @param targetLang - Target language
- * @param preview - Preview mode
- * @param verbose - Verbose output
- * @returns Array of translation results
- */
-export async function batchTranslateFiles(
-  filePaths: string[],
-  targetLang: SupportedLanguage = 'en',
-  preview: boolean = false,
-  verbose: boolean = false
-): Promise<FileTranslationResult[]> {
-  const results: FileTranslationResult[] = [];
-
-  if (verbose) {
-    console.log(`\n🔄 Batch translating ${filePaths.length} file(s) to ${getLanguageName(targetLang)}...\n`);
-  }
-
-  for (const filePath of filePaths) {
-    try {
-      const result = await translateFile({
-        filePath,
-        targetLang,
-        preview,
-        verbose,
-      });
-      results.push(result);
-    } catch (error: any) {
-      if (verbose) {
-        console.error(`❌ Error translating ${filePath}: ${error.message}`);
-      }
-      results.push({
-        success: false,
-        filePath,
-        sourceLanguage: 'unknown',
-        targetLanguage: targetLang,
-        warnings: [error.message],
-        cost: 0,
-        tokensUsed: 0,
-      });
-    }
-  }
-
-  // Summary
-  if (verbose) {
-    const successful = results.filter(r => r.success).length;
-    const totalCost = results.reduce((sum, r) => sum + r.cost, 0);
-    const totalTokens = results.reduce((sum, r) => sum + r.tokensUsed, 0);
-
-    console.log(`\n📊 Batch Translation Summary:`);
-    console.log(`   Successful: ${successful}/${filePaths.length}`);
-    console.log(`   Total tokens: ${totalTokens.toLocaleString()}`);
-    console.log(`   Total cost: ${formatCost(totalCost)}`);
-  }
-
-  return results;
-}
-
-/**
- * Parse CLI arguments
- */
-function parseArgs(): CLIOptions {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
-    console.log(`
-Translation CLI Utility
-
-Usage:
-  node translate-file.js <file-path> [options]
-
-Options:
-  --target-lang <code>  Target language (default: en)
-  --preview             Preview translation without writing to file
-  --verbose, -v         Show detailed output
-  --help, -h            Show this help message
-
-Supported Languages:
-  en (English), ru (Russian), es (Spanish), zh (Chinese),
-  de (German), fr (French), ja (Japanese), ko (Korean),
-  pt (Portuguese), ar (Arabic), he (Hebrew)
-
-Examples:
-  # Translate Russian file to English
-  node translate-file.js .specweave/increments/0001/spec.md
-
-  # Preview translation
-  node translate-file.js spec.md --preview --verbose
-
-  # Translate to Spanish
-  node translate-file.js plan.md --target-lang es
-    `.trim());
-    process.exit(0);
-  }
-
-  const filePath = args[0];
-  let targetLang: SupportedLanguage = 'en';
-  let preview = false;
-  let verbose = false;
-
-  // Parse options
-  for (let i = 1; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg === '--target-lang' && args[i + 1]) {
-      targetLang = args[i + 1] as SupportedLanguage;
-      i++;
-    } else if (arg === '--preview') {
-      preview = true;
-    } else if (arg === '--verbose' || arg === '-v') {
-      verbose = true;
-    }
-  }
-
-  return {
-    filePath,
-    targetLang,
-    preview,
-    verbose,
-  };
-}
-
-/**
- * CLI entry point
- */
-async function main(): Promise<void> {
-  try {
-    const options = parseArgs();
-    const result = await translateFile(options);
-
-    // Exit with appropriate code
-    process.exit(result.success ? 0 : 1);
-  } catch (error: any) {
-    console.error(`❌ Translation failed: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-// Check if running as main module (ESM)
-const isMainModule = import.meta.url === `file://${process.argv[1]}`;
-if (isMainModule) {
-  main();
-}