specweave 0.13.6 → 0.15.0

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

@@ -1,79 +1,130 @@
-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;
+/**
+ * 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)`);
     }
-    const config = await fs.readJson(configPath);
-    if (!config.language || config.language === "en") {
-      console.log("[translate-living-docs] Project language is English, skipping translation");
-      return;
+    catch (error) {
+        console.error(`[translate-living-docs] Error: ${error.message}`);
+        // Don't throw - translation errors shouldn't break the workflow
     }
-    if (!config.translation?.autoTranslateLivingDocs) {
-      console.log("[translate-living-docs] Auto-translation disabled in config");
-      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;
-    }
-    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}`);
-      }
-    }
-    console.log(`[translate-living-docs] \u2705 Translation complete (${changedFiles.length} files)`);
-  } catch (error) {
-    console.error(`[translate-living-docs] Error: ${error.message}`);
-  }
 }
+/**
+ * Detect changed documentation files using git diff
+ */
 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 [];
-  }
+    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;
+    }
+    catch (error) {
+        // git diff might fail if not a git repo or no changes
+        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}`);
+/**
+ * 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;
+    }
+    // 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}`);
 }
+/**
+ * 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)
@@ -88,32 +139,37 @@ ${content}
 Translated version:
 `.trim();
 }
+/**
+ * Get human-readable language name
+ */
 function getLanguageName(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;
+    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;
 }
+/**
+ * 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);
+    });
 }
-export {
-  translateLivingDocs
-};
+//# sourceMappingURL=translate-living-docs.js.map

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

@@ -1,58 +1,73 @@
-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
+/**
+ * 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
 };
+//# sourceMappingURL=reflection-types.js.map