specweave 0.23.0 → 0.23.2

package/plugins/specweave/lib/hooks/translate-living-docs.d.ts.bak

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ */
+/**
+ * Main function: Translate changed living docs
+ */
+export declare function translateLivingDocs(incrementId: string): Promise<void>;
+//# sourceMappingURL=translate-living-docs.d.ts.map

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

@@ -0,0 +1,119 @@
+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;
+    }
+    const config = await fs.readJson(configPath);
+    if (!config.language || config.language === "en") {
+      console.log("[translate-living-docs] Project language is English, skipping translation");
+      return;
+    }
+    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}`);
+  }
+}
+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}`);
+}
+function generateTranslationPrompt(content, targetLanguage, translationConfig) {
+  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" : ""}
+- Preserve ALL markdown formatting (headers, lists, code blocks, links)
+- Do NOT translate code blocks
+- Do NOT translate YAML frontmatter keys (only values if applicable)
+- Preserve all emojis
+- Preserve all file paths and URLs
+
+Content to translate:
+---
+${content}
+---
+
+Translated version:
+`.trim();
+}
+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;
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const incrementId = args[0] || "current";
+  await translateLivingDocs(incrementId);
+}
+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);
+  });
+}
+export {
+  translateLivingDocs
+};

package/plugins/specweave/lib/hooks/translate-living-docs.ts.bak

@@ -0,0 +1,224 @@
+/**
+ * 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';
+import path from 'path';
+
+interface Config {
+  language?: string;
+  translation?: {
+    autoTranslateLivingDocs?: boolean;
+    keepFrameworkTerms?: boolean;
+    keepTechnicalTerms?: boolean;
+  };
+}
+
+/**
+ * Main function: Translate changed living docs
+ */
+export async function translateLivingDocs(incrementId: string): Promise<void> {
+  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: 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: any) {
+        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)`);
+  } catch (error: any) {
+    console.error(`[translate-living-docs] Error: ${error.message}`);
+    // Don't throw - translation errors shouldn't break the workflow
+  }
+}
+
+/**
+ * Detect changed documentation files using git diff
+ */
+async function detectChangedDocs(): Promise<string[]> {
+  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 [];
+  }
+}
+
+/**
+ * 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: string,
+  targetLanguage: string,  // Should always be 'en' for living docs
+  translationConfig?: Config['translation']
+): Promise<void> {
+  // 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: string,
+  targetLanguage: string,
+  translationConfig?: Config['translation']
+): string {
+  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' : ''}
+- Preserve ALL markdown formatting (headers, lists, code blocks, links)
+- Do NOT translate code blocks
+- Do NOT translate YAML frontmatter keys (only values if applicable)
+- Preserve all emojis
+- Preserve all file paths and URLs
+
+Content to translate:
+---
+${content}
+---
+
+Translated version:
+`.trim();
+}
+
+/**
+ * Get human-readable language name
+ */
+function getLanguageName(code: string): string {
+  const names: Record<string, string> = {
+    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(): Promise<void> {
+  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);
+  });
+}

package/plugins/specweave/lib/hooks/update-ac-status.js.bak

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { ACStatusManager } from "../../../../dist/src/core/increment/ac-status-manager.js";
+async function updateACStatus(incrementId) {
+  try {
+    const projectRoot = process.cwd();
+    if (process.env.SKIP_AC_SYNC === "true") {
+      console.log("\u2139\uFE0F  AC sync skipped (SKIP_AC_SYNC=true)");
+      return;
+    }
+    console.log(`\u{1F504} Syncing AC status for increment ${incrementId}...`);
+    const manager = new ACStatusManager(projectRoot);
+    const result = await manager.syncACStatus(incrementId);
+    if (result.warnings && result.warnings.length > 0) {
+      console.log("\n\u26A0\uFE0F  Warnings:");
+      result.warnings.forEach((warning) => console.log(`   ${warning}`));
+    }
+    if (result.conflicts && result.conflicts.length > 0) {
+      console.log("\n\u26A0\uFE0F  Conflicts detected:");
+      result.conflicts.forEach((conflict) => console.log(`   ${conflict}`));
+    }
+    if (result.updated && result.updated.length > 0) {
+      console.log("\n\u2705 Updated AC checkboxes:");
+      result.updated.forEach((acId) => console.log(`   ${acId} \u2192 [x]`));
+      if (result.changes && result.changes.length > 0) {
+        console.log("\n\u{1F4DD} Changes:");
+        result.changes.forEach((change) => console.log(`   ${change}`));
+      }
+    } else if (result.synced) {
+      console.log("\u2705 All ACs already in sync (no changes needed)");
+    } else {
+      console.log("\u2139\uFE0F  No AC updates needed");
+    }
+  } catch (error) {
+    console.error("\u274C Error updating AC status:", error);
+  }
+}
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+if (isMainModule) {
+  const incrementId = process.argv[2];
+  if (!incrementId) {
+    console.error("Usage: node update-ac-status.js <increment-id>");
+    console.error("Example: node update-ac-status.js 0039-ultra-smart-next-command");
+    process.exit(1);
+  }
+  updateACStatus(incrementId).then(() => {
+    process.exit(0);
+  }).catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+  });
+}

package/plugins/specweave/lib/hooks/update-ac-status.ts.bak

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+/**
+ * AC Status Update Hook (ACStatusManager Integration)
+ *
+ * Uses ACStatusManager for sophisticated AC status synchronization:
+ * - Tracks completion percentage per AC (only updates at 100%)
+ * - Detects conflicts (AC checked but tasks incomplete)
+ * - Warns about orphaned ACs (no implementing tasks)
+ * - Provides detailed sync result with diff
+ * - Atomic file writes to prevent corruption
+ *
+ * Flow:
+ * 1. Parse tasks.md → Map AC-IDs to completion status
+ * 2. Parse spec.md → Extract current AC definitions
+ * 3. Compare task completion vs spec checkboxes
+ * 4. Update spec.md only for 100% complete ACs
+ * 5. Log conflicts, warnings, and changes
+ *
+ * Called by: plugins/specweave/hooks/post-task-completion.sh
+ *
+ * Example:
+ * - Tasks: T-001 [x], T-002 [x] (both have AC-US1-01) → AC-US1-01 100% complete
+ * - spec.md: - [ ] AC-US1-01 → - [x] AC-US1-01 ✅
+ * - Tasks: T-003 [x], T-004 [ ] (both have AC-US1-02) → AC-US1-02 50% complete
+ * - spec.md: - [ ] AC-US1-02 → NO CHANGE (partial completion)
+ */
+
+import { ACStatusManager } from '../../../../dist/src/core/increment/ac-status-manager.js';
+
+/**
+ * Main entry point - uses ACStatusManager for sophisticated sync
+ */
+async function updateACStatus(incrementId: string): Promise<void> {
+  try {
+    const projectRoot = process.cwd();
+
+    // Check if --skip-ac-sync flag is set (allows disabling hook temporarily)
+    if (process.env.SKIP_AC_SYNC === 'true') {
+      console.log('ℹ️  AC sync skipped (SKIP_AC_SYNC=true)');
+      return;
+    }
+
+    console.log(`🔄 Syncing AC status for increment ${incrementId}...`);
+
+    // Initialize ACStatusManager with project root
+    const manager = new ACStatusManager(projectRoot);
+
+    // Perform sophisticated sync
+    const result = await manager.syncACStatus(incrementId);
+
+    // Display results
+    if (result.warnings && result.warnings.length > 0) {
+      console.log('\n⚠️  Warnings:');
+      result.warnings.forEach((warning: string) => console.log(`   ${warning}`));
+    }
+
+    if (result.conflicts && result.conflicts.length > 0) {
+      console.log('\n⚠️  Conflicts detected:');
+      result.conflicts.forEach((conflict: string) => console.log(`   ${conflict}`));
+    }
+
+    if (result.updated && result.updated.length > 0) {
+      console.log('\n✅ Updated AC checkboxes:');
+      result.updated.forEach((acId: string) => console.log(`   ${acId} → [x]`));
+
+      if (result.changes && result.changes.length > 0) {
+        console.log('\n📝 Changes:');
+        result.changes.forEach((change: string) => console.log(`   ${change}`));
+      }
+    } else if (result.synced) {
+      console.log('✅ All ACs already in sync (no changes needed)');
+    } else {
+      console.log('ℹ️  No AC updates needed');
+    }
+
+  } catch (error) {
+    console.error('❌ Error updating AC status:', error);
+    // Non-blocking: Don't throw, just log
+  }
+}
+
+// CLI Entry Point (ES Module)
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+
+if (isMainModule) {
+  const incrementId = process.argv[2];
+
+  if (!incrementId) {
+    console.error('Usage: node update-ac-status.js <increment-id>');
+    console.error('Example: node update-ac-status.js 0039-ultra-smart-next-command');
+    process.exit(1);
+  }
+
+  updateACStatus(incrementId)
+    .then(() => {
+      process.exit(0);
+    })
+    .catch((error) => {
+      console.error('Fatal error:', error);
+      process.exit(1);
+    });
+}

package/plugins/specweave/lib/hooks/update-tasks-md.d.js.bak

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/plugins/specweave/lib/hooks/update-tasks-md.d.ts.bak

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * SpecWeave Tasks.md Auto-Updater
+ *
+ * Automatically updates tasks.md completion status after TodoWrite completes tasks.
+ *
+ * Usage:
+ *   node dist/hooks/lib/update-tasks-md.js <incrementId>
+ *
+ * Example:
+ *   node dist/hooks/lib/update-tasks-md.js 0006-llm-native-i18n
+ *
+ * What it does:
+ * 1. Reads tasks.md for the given increment
+ * 2. Finds recently completed tasks from TodoWrite
+ * 3. Updates "[ ]" to "[x]" for completed tasks
+ * 4. Updates "Status: ⏳ Pending" to "Status: [x] Completed"
+ * 5. Recalculates progress percentage
+ * 6. Writes back to tasks.md
+ *
+ * @author SpecWeave Team
+ * @version 1.0.0
+ */
+/**
+ * Main function - update tasks.md for given increment
+ */
+declare function updateTasksMd(incrementId: string): Promise<void>;
+export { updateTasksMd };
+//# sourceMappingURL=update-tasks-md.d.ts.map