specweave 0.17.1 → 0.17.3

package/plugins/specweave/lib/hooks/translate-living-docs.js

@@ -1,130 +1,79 @@
-/**
- * Living Docs Auto-Translation
- *
- * Automatically translates changed documentation files when language != 'en'
- * and auto-translation is enabled in config.
- *
- * This runs as part of the post-task-completion hook.
- */
-import { execSync } from 'child_process';
-import fs from 'fs-extra';
-/**
- * Main function: Translate changed living docs
- */
-export async function translateLivingDocs(incrementId) {
-    try {
-        // 1. Load config
-        const configPath = '.specweave/config.json';
-        if (!fs.existsSync(configPath)) {
-            console.log('[translate-living-docs] No config found, skipping translation');
-            return;
-        }
-        const config = await fs.readJson(configPath);
-        // 2. Check if translation is enabled
-        if (!config.language || config.language === 'en') {
-            // Already English or no language set - skip translation
-            console.log('[translate-living-docs] Project language is English, skipping translation');
-            return;
-        }
-        if (!config.translation?.autoTranslateLivingDocs) {
-            // Auto-translation disabled
-            console.log('[translate-living-docs] Auto-translation disabled in config');
-            return;
-        }
-        // Always translate TO English for maintainability (not to user's language!)
-        console.log(`[translate-living-docs] Auto-translating docs from ${config.language} to English...`);
-        // 3. Detect changed documentation files
-        const changedFiles = await detectChangedDocs();
-        if (changedFiles.length === 0) {
-            console.log('[translate-living-docs] No documentation changes detected');
-            return;
-        }
-        console.log(`[translate-living-docs] Found ${changedFiles.length} changed file(s)`);
-        // 4. Translate each file TO English (always 'en', not config.language!)
-        for (const file of changedFiles) {
-            try {
-                // Always translate TO English for maintainability
-                await translateFile(file, 'en', config.translation);
-                console.log(`[translate-living-docs] ✓ Translated: ${file} (${config.language} → en)`);
-            }
-            catch (error) {
-                console.warn(`[translate-living-docs] ⚠️  Failed to translate ${file}: ${error.message}`);
-                // Continue with other files
-            }
-        }
-        console.log(`[translate-living-docs] ✅ Translation complete (${changedFiles.length} files)`);
+import { execSync } from "child_process";
+import fs from "fs-extra";
+async function translateLivingDocs(incrementId) {
+  try {
+    const configPath = ".specweave/config.json";
+    if (!fs.existsSync(configPath)) {
+      console.log("[translate-living-docs] No config found, skipping translation");
+      return;
     }
-    catch (error) {
-        console.error(`[translate-living-docs] Error: ${error.message}`);
-        // Don't throw - translation errors shouldn't break the workflow
+    const config = await fs.readJson(configPath);
+    if (!config.language || config.language === "en") {
+      console.log("[translate-living-docs] Project language is English, skipping translation");
+      return;
     }
-}
-/**
- * Detect changed documentation files using git diff
- */
-async function detectChangedDocs() {
-    try {
-        // Get list of changed files in .specweave/docs/
-        const output = execSync('git diff --name-only .specweave/docs/', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] });
-        // Filter for markdown files only
-        const files = output
-            .split('\n')
-            .filter(f => f.trim() && f.endsWith('.md'))
-            .map(f => f.trim());
-        return files;
+    if (!config.translation?.autoTranslateLivingDocs) {
+      console.log("[translate-living-docs] Auto-translation disabled in config");
+      return;
     }
-    catch (error) {
-        // git diff might fail if not a git repo or no changes
-        return [];
+    console.log(`[translate-living-docs] Auto-translating docs from ${config.language} to English...`);
+    const changedFiles = await detectChangedDocs();
+    if (changedFiles.length === 0) {
+      console.log("[translate-living-docs] No documentation changes detected");
+      return;
     }
-}
-/**
- * Translate a single file FROM user's language TO English
- *
- * NOTE: This is a simplified implementation that creates a translation prompt.
- * In a real implementation with Claude Code, the translator skill would auto-activate
- * and handle the translation. For now, we'll add a marker comment to indicate
- * the file needs translation.
- *
- * @param filePath - File to translate
- * @param targetLanguage - Target language (should always be 'en' for living docs)
- * @param translationConfig - Translation settings
- */
-async function translateFile(filePath, targetLanguage, // Should always be 'en' for living docs
-translationConfig) {
-    // Read original content
-    const originalContent = await fs.readFile(filePath, 'utf-8');
-    // Check if file already has translation marker (avoid re-translating)
-    if (originalContent.includes(`<!-- Translated to ${targetLanguage} -->`)) {
-        console.log(`[translate-living-docs] File already translated, skipping: ${filePath}`);
-        return;
+    console.log(`[translate-living-docs] Found ${changedFiles.length} changed file(s)`);
+    for (const file of changedFiles) {
+      try {
+        await translateFile(file, "en", config.translation);
+        console.log(`[translate-living-docs] \u2713 Translated: ${file} (${config.language} \u2192 en)`);
+      } catch (error) {
+        console.warn(`[translate-living-docs] \u26A0\uFE0F  Failed to translate ${file}: ${error.message}`);
+      }
     }
-    // For now, we'll create a translation request that the LLM can act on
-    // In a production system with Claude Code integration, this would invoke
-    // the translator skill directly
-    const translationPrompt = generateTranslationPrompt(originalContent, targetLanguage, translationConfig);
-    // TODO: In full implementation, this would:
-    // 1. Invoke translator skill via Claude Code API
-    // 2. Get translated content back
-    // 3. Write to file
-    // For MVP, we'll add a comment indicating translation is needed
-    const markedContent = `<!-- Translation needed to ${targetLanguage} -->\n<!-- Original content below -->\n\n${originalContent}`;
-    // Write back (commented out to avoid breaking existing docs)
-    // await fs.writeFile(filePath, markedContent, 'utf-8');
-    console.log(`[translate-living-docs] Translation prompt generated for: ${filePath}`);
+    console.log(`[translate-living-docs] \u2705 Translation complete (${changedFiles.length} files)`);
+  } catch (error) {
+    console.error(`[translate-living-docs] Error: ${error.message}`);
+  }
+}
+async function detectChangedDocs() {
+  try {
+    const output = execSync(
+      "git diff --name-only .specweave/docs/",
+      { encoding: "utf-8", stdio: ["pipe", "pipe", "ignore"] }
+    );
+    const files = output.split("\n").filter((f) => f.trim() && f.endsWith(".md")).map((f) => f.trim());
+    return files;
+  } catch (error) {
+    return [];
+  }
+}
+async function translateFile(filePath, targetLanguage, translationConfig) {
+  const originalContent = await fs.readFile(filePath, "utf-8");
+  if (originalContent.includes(`<!-- Translated to ${targetLanguage} -->`)) {
+    console.log(`[translate-living-docs] File already translated, skipping: ${filePath}`);
+    return;
+  }
+  const translationPrompt = generateTranslationPrompt(
+    originalContent,
+    targetLanguage,
+    translationConfig
+  );
+  const markedContent = `<!-- Translation needed to ${targetLanguage} -->
+<!-- Original content below -->
+
+${originalContent}`;
+  console.log(`[translate-living-docs] Translation prompt generated for: ${filePath}`);
 }
-/**
- * Generate translation prompt for LLM
- */
 function generateTranslationPrompt(content, targetLanguage, translationConfig) {
-    const keepFrameworkTerms = translationConfig?.keepFrameworkTerms !== false;
-    const keepTechnicalTerms = translationConfig?.keepTechnicalTerms !== false;
-    return `
+  const keepFrameworkTerms = translationConfig?.keepFrameworkTerms !== false;
+  const keepTechnicalTerms = translationConfig?.keepTechnicalTerms !== false;
+  return `
 Translate the following markdown documentation to ${getLanguageName(targetLanguage)}.
 
 CRITICAL RULES:
-${keepFrameworkTerms ? '- Keep framework terms in English: increment, spec.md, plan.md, tasks.md, COMPLETION-SUMMARY.md, living docs, PM gate, RFC, ADR, PRD, HLD, LLD' : ''}
-${keepTechnicalTerms ? '- Keep technical terms in English: TypeScript, npm, git, Docker, Kubernetes, API, CLI, REST, JSON, HTTP' : ''}
+${keepFrameworkTerms ? "- Keep framework terms in English: increment, spec.md, plan.md, tasks.md, COMPLETION-SUMMARY.md, living docs, PM gate, RFC, ADR, PRD, HLD, LLD" : ""}
+${keepTechnicalTerms ? "- Keep technical terms in English: TypeScript, npm, git, Docker, Kubernetes, API, CLI, REST, JSON, HTTP" : ""}
 - Preserve ALL markdown formatting (headers, lists, code blocks, links)
 - Do NOT translate code blocks
 - Do NOT translate YAML frontmatter keys (only values if applicable)
@@ -139,37 +88,32 @@ ${content}
 Translated version:
 `.trim();
 }
-/**
- * Get human-readable language name
- */
 function getLanguageName(code) {
-    const names = {
-        en: 'English',
-        ru: 'Russian (Русский)',
-        es: 'Spanish (Español)',
-        zh: 'Chinese (中文)',
-        de: 'German (Deutsch)',
-        fr: 'French (Français)',
-        ja: 'Japanese (日本語)',
-        ko: 'Korean (한국어)',
-        pt: 'Portuguese (Português)',
-    };
-    return names[code] || code;
+  const names = {
+    en: "English",
+    ru: "Russian (\u0420\u0443\u0441\u0441\u043A\u0438\u0439)",
+    es: "Spanish (Espa\xF1ol)",
+    zh: "Chinese (\u4E2D\u6587)",
+    de: "German (Deutsch)",
+    fr: "French (Fran\xE7ais)",
+    ja: "Japanese (\u65E5\u672C\u8A9E)",
+    ko: "Korean (\uD55C\uAD6D\uC5B4)",
+    pt: "Portuguese (Portugu\xEAs)"
+  };
+  return names[code] || code;
 }
-/**
- * CLI entry point (for standalone execution)
- */
 async function main() {
-    const args = process.argv.slice(2);
-    const incrementId = args[0] || 'current';
-    await translateLivingDocs(incrementId);
+  const args = process.argv.slice(2);
+  const incrementId = args[0] || "current";
+  await translateLivingDocs(incrementId);
 }
-// Check if running as main module
 const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
-    main().catch(error => {
-        console.error('[translate-living-docs] Fatal error:', error);
-        process.exit(1);
-    });
+  main().catch((error) => {
+    console.error("[translate-living-docs] Fatal error:", error);
+    process.exit(1);
+  });
 }
-//# sourceMappingURL=translate-living-docs.js.map
+export {
+  translateLivingDocs
+};

package/plugins/specweave/lib/hooks/types/reflection-types.js

@@ -1,73 +1,58 @@
-/**
- * Type definitions for AI Self-Reflection System
- * @module reflection-types
- */
-/**
- * Severity levels for identified issues
- */
-export var IssueSeverity;
-(function (IssueSeverity) {
-    IssueSeverity["CRITICAL"] = "CRITICAL";
-    IssueSeverity["HIGH"] = "HIGH";
-    IssueSeverity["MEDIUM"] = "MEDIUM";
-    IssueSeverity["LOW"] = "LOW";
-})(IssueSeverity || (IssueSeverity = {}));
-/**
- * Issue categories
- */
-export var IssueCategory;
-(function (IssueCategory) {
-    IssueCategory["SECURITY"] = "SECURITY";
-    IssueCategory["QUALITY"] = "QUALITY";
-    IssueCategory["TESTING"] = "TESTING";
-    IssueCategory["PERFORMANCE"] = "PERFORMANCE";
-    IssueCategory["TECHNICAL_DEBT"] = "TECHNICAL_DEBT";
-})(IssueCategory || (IssueCategory = {}));
-/**
- * Reflection depth modes
- */
-export var ReflectionDepth;
-(function (ReflectionDepth) {
-    ReflectionDepth["QUICK"] = "quick";
-    ReflectionDepth["STANDARD"] = "standard";
-    ReflectionDepth["DEEP"] = "deep"; // <60s, detailed + architectural
-})(ReflectionDepth || (ReflectionDepth = {}));
-/**
- * AI model selection for reflection
- */
-export var ReflectionModel;
-(function (ReflectionModel) {
-    ReflectionModel["HAIKU"] = "haiku";
-    ReflectionModel["SONNET"] = "sonnet";
-    ReflectionModel["OPUS"] = "opus"; // Deep analysis (~$0.15/task)
-})(ReflectionModel || (ReflectionModel = {}));
-/**
- * Reflection execution mode
- */
-export var ReflectionMode;
-(function (ReflectionMode) {
-    ReflectionMode["AUTO"] = "auto";
-    ReflectionMode["MANUAL"] = "manual";
-    ReflectionMode["DISABLED"] = "disabled"; // Reflection disabled
-})(ReflectionMode || (ReflectionMode = {}));
-/**
- * Default reflection configuration
- */
-export const DEFAULT_REFLECTION_CONFIG = {
-    enabled: true,
-    mode: ReflectionMode.AUTO,
-    depth: ReflectionDepth.STANDARD,
-    model: ReflectionModel.HAIKU,
-    categories: {
-        security: true,
-        quality: true,
-        testing: true,
-        performance: true,
-        technicalDebt: true
-    },
-    criticalThreshold: IssueSeverity.MEDIUM,
-    storeReflections: true,
-    autoCreateFollowUpTasks: false,
-    soundNotifications: false
+var IssueSeverity = /* @__PURE__ */ ((IssueSeverity2) => {
+  IssueSeverity2["CRITICAL"] = "CRITICAL";
+  IssueSeverity2["HIGH"] = "HIGH";
+  IssueSeverity2["MEDIUM"] = "MEDIUM";
+  IssueSeverity2["LOW"] = "LOW";
+  return IssueSeverity2;
+})(IssueSeverity || {});
+var IssueCategory = /* @__PURE__ */ ((IssueCategory2) => {
+  IssueCategory2["SECURITY"] = "SECURITY";
+  IssueCategory2["QUALITY"] = "QUALITY";
+  IssueCategory2["TESTING"] = "TESTING";
+  IssueCategory2["PERFORMANCE"] = "PERFORMANCE";
+  IssueCategory2["TECHNICAL_DEBT"] = "TECHNICAL_DEBT";
+  return IssueCategory2;
+})(IssueCategory || {});
+var ReflectionDepth = /* @__PURE__ */ ((ReflectionDepth2) => {
+  ReflectionDepth2["QUICK"] = "quick";
+  ReflectionDepth2["STANDARD"] = "standard";
+  ReflectionDepth2["DEEP"] = "deep";
+  return ReflectionDepth2;
+})(ReflectionDepth || {});
+var ReflectionModel = /* @__PURE__ */ ((ReflectionModel2) => {
+  ReflectionModel2["HAIKU"] = "haiku";
+  ReflectionModel2["SONNET"] = "sonnet";
+  ReflectionModel2["OPUS"] = "opus";
+  return ReflectionModel2;
+})(ReflectionModel || {});
+var ReflectionMode = /* @__PURE__ */ ((ReflectionMode2) => {
+  ReflectionMode2["AUTO"] = "auto";
+  ReflectionMode2["MANUAL"] = "manual";
+  ReflectionMode2["DISABLED"] = "disabled";
+  return ReflectionMode2;
+})(ReflectionMode || {});
+const DEFAULT_REFLECTION_CONFIG = {
+  enabled: true,
+  mode: "auto" /* AUTO */,
+  depth: "standard" /* STANDARD */,
+  model: "haiku" /* HAIKU */,
+  categories: {
+    security: true,
+    quality: true,
+    testing: true,
+    performance: true,
+    technicalDebt: true
+  },
+  criticalThreshold: "MEDIUM" /* MEDIUM */,
+  storeReflections: true,
+  autoCreateFollowUpTasks: false,
+  soundNotifications: false
+};
+export {
+  DEFAULT_REFLECTION_CONFIG,
+  IssueCategory,
+  IssueSeverity,
+  ReflectionDepth,
+  ReflectionMode,
+  ReflectionModel
 };
-//# sourceMappingURL=reflection-types.js.map