specweave 1.0.593 → 2.0.0

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

@@ -1,225 +0,0 @@
-/**
- * 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 { existsSync } from 'fs';
-import { promises as fs } from 'fs';
-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 (!existsSync(configPath)) {
-      console.log('[translate-living-docs] No config found, skipping translation');
-      return;
-    }
-
-    const config: Config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
-
-    // 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/types/reflection-types.d.ts

@@ -1,164 +0,0 @@
-/**
- * Type definitions for AI Self-Reflection System
- * @module reflection-types
- */
-/**
- * Severity levels for identified issues
- */
-export declare enum IssueSeverity {
-    CRITICAL = "CRITICAL",
-    HIGH = "HIGH",
-    MEDIUM = "MEDIUM",
-    LOW = "LOW"
-}
-/**
- * Issue categories
- */
-export declare enum IssueCategory {
-    SECURITY = "SECURITY",
-    QUALITY = "QUALITY",
-    TESTING = "TESTING",
-    PERFORMANCE = "PERFORMANCE",
-    TECHNICAL_DEBT = "TECHNICAL_DEBT"
-}
-/**
- * Reflection depth modes
- */
-export declare enum ReflectionDepth {
-    QUICK = "quick",// <15s, critical issues only
-    STANDARD = "standard",// <30s, full analysis (default)
-    DEEP = "deep"
-}
-/**
- * AI model selection for reflection
- */
-export declare enum ReflectionModel {
-    HAIKU = "haiku",// Fast, cheap (~$0.01/task)
-    SONNET = "sonnet",// Balanced (~$0.05/task)
-    OPUS = "opus"
-}
-/**
- * Reflection execution mode
- */
-export declare enum ReflectionMode {
-    AUTO = "auto",// Automatic after task completion
-    MANUAL = "manual",// User-triggered only
-    DISABLED = "disabled"
-}
-/**
- * Issue identified during reflection
- */
-export interface ReflectionIssue {
-    severity: IssueSeverity;
-    category: IssueCategory;
-    description: string;
-    impact: string;
-    recommendation: string;
-    location?: {
-        file: string;
-        line?: number;
-        snippet?: string;
-    };
-}
-/**
- * Lesson learned from task execution
- */
-export interface LessonLearned {
-    whatWentWell: string[];
-    whatCouldImprove: string[];
-    forNextTime: string[];
-}
-/**
- * Quality metrics from reflection
- */
-export interface ReflectionMetrics {
-    codeQuality: number;
-    security: number;
-    testCoverage?: number;
-    technicalDebt: 'LOW' | 'MEDIUM' | 'HIGH';
-    performance: 'GOOD' | 'ACCEPTABLE' | 'NEEDS_WORK';
-}
-/**
- * Complete reflection result
- */
-export interface ReflectionResult {
-    taskName: string;
-    completed: string;
-    duration?: string;
-    filesModified: {
-        count: number;
-        linesAdded: number;
-        linesRemoved: number;
-    };
-    accomplishments: string[];
-    strengths: string[];
-    issues: ReflectionIssue[];
-    recommendedActions: {
-        priority1: string[];
-        priority2: string[];
-        priority3: string[];
-    };
-    lessonsLearned: LessonLearned;
-    metrics: ReflectionMetrics;
-    relatedTasks?: string[];
-    metadata: {
-        model: ReflectionModel;
-        reflectionTime: number;
-        estimatedCost: number;
-    };
-}
-/**
- * Configuration for reflection system
- */
-export interface ReflectionConfig {
-    enabled: boolean;
-    mode: ReflectionMode;
-    depth: ReflectionDepth;
-    model: ReflectionModel;
-    categories: {
-        security: boolean;
-        quality: boolean;
-        testing: boolean;
-        performance: boolean;
-        technicalDebt: boolean;
-    };
-    criticalThreshold: IssueSeverity;
-    storeReflections: boolean;
-    autoCreateFollowUpTasks: boolean;
-    soundNotifications?: boolean;
-}
-/**
- * Git diff information for modified files
- */
-export interface GitDiffInfo {
-    file: string;
-    linesAdded: number;
-    linesRemoved: number;
-    content: string;
-}
-/**
- * Context for reflection execution
- */
-export interface ReflectionContext {
-    incrementId: string;
-    taskId: string;
-    modifiedFiles: GitDiffInfo[];
-    config: ReflectionConfig;
-}
-/**
- * Reflection execution result (success or failure)
- */
-export interface ReflectionExecutionResult {
-    success: boolean;
-    result?: ReflectionResult;
-    error?: {
-        message: string;
-        code: string;
-        details?: any;
-    };
-}
-/**
- * Default reflection configuration
- */
-export declare const DEFAULT_REFLECTION_CONFIG: ReflectionConfig;
-//# sourceMappingURL=reflection-types.d.ts.map

package/plugins/specweave/lib/hooks/types/reflection-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reflection-types.d.ts","sourceRoot":"","sources":["reflection-types.ts"],"names":[],"mappings":"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"}

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

@@ -1,58 +0,0 @@
-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
-};

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

@@ -1 +0,0 @@
-{"version":3,"file":"reflection-types.js","sourceRoot":"","sources":["reflection-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,4BAAW,CAAA;AACb,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,4CAA2B,CAAA;IAC3B,kDAAiC,CAAA;AACnC,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,wCAAqB,CAAA;IACrB,gCAAa,CAAA,CAAU,iCAAiC;AAC1D,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,oCAAiB,CAAA;IACjB,gCAAa,CAAA,CAAQ,8BAA8B;AACrD,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,mCAAiB,CAAA;IACjB,uCAAqB,CAAA,CAAC,sBAAsB;AAC9C,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AA0HD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,cAAc,CAAC,IAAI;IACzB,KAAK,EAAE,eAAe,CAAC,QAAQ;IAC/B,KAAK,EAAE,eAAe,CAAC,KAAK;IAC5B,UAAU,EAAE;QACV,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;KACpB;IACD,iBAAiB,EAAE,aAAa,CAAC,MAAM;IACvC,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,KAAK;IAC9B,kBAAkB,EAAE,KAAK;CAC1B,CAAC"}

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

@@ -1,193 +0,0 @@
-/**
- * Type definitions for AI Self-Reflection System
- * @module reflection-types
- */
-
-/**
- * Severity levels for identified issues
- */
-export enum IssueSeverity {
-  CRITICAL = 'CRITICAL',
-  HIGH = 'HIGH',
-  MEDIUM = 'MEDIUM',
-  LOW = 'LOW'
-}
-
-/**
- * Issue categories
- */
-export enum IssueCategory {
-  SECURITY = 'SECURITY',
-  QUALITY = 'QUALITY',
-  TESTING = 'TESTING',
-  PERFORMANCE = 'PERFORMANCE',
-  TECHNICAL_DEBT = 'TECHNICAL_DEBT'
-}
-
-/**
- * Reflection depth modes
- */
-export enum ReflectionDepth {
-  QUICK = 'quick',       // <15s, critical issues only
-  STANDARD = 'standard', // <30s, full analysis (default)
-  DEEP = 'deep'          // <60s, detailed + architectural
-}
-
-/**
- * AI model selection for reflection
- */
-export enum ReflectionModel {
-  HAIKU = 'haiku',     // Fast, cheap (~$0.01/task)
-  SONNET = 'sonnet',   // Balanced (~$0.05/task)
-  OPUS = 'opus'        // Deep analysis (~$0.15/task)
-}
-
-/**
- * Reflection execution mode
- */
-export enum ReflectionMode {
-  AUTO = 'auto',       // Automatic after task completion
-  MANUAL = 'manual',   // User-triggered only
-  DISABLED = 'disabled' // Reflection disabled
-}
-
-/**
- * Issue identified during reflection
- */
-export interface ReflectionIssue {
-  severity: IssueSeverity;
-  category: IssueCategory;
-  description: string;
-  impact: string;
-  recommendation: string;
-  location?: {
-    file: string;
-    line?: number;
-    snippet?: string;
-  };
-}
-
-/**
- * Lesson learned from task execution
- */
-export interface LessonLearned {
-  whatWentWell: string[];
-  whatCouldImprove: string[];
-  forNextTime: string[];
-}
-
-/**
- * Quality metrics from reflection
- */
-export interface ReflectionMetrics {
-  codeQuality: number;      // 1-10 rating
-  security: number;         // 1-10 rating
-  testCoverage?: number;    // Percentage or null
-  technicalDebt: 'LOW' | 'MEDIUM' | 'HIGH';
-  performance: 'GOOD' | 'ACCEPTABLE' | 'NEEDS_WORK';
-}
-
-/**
- * Complete reflection result
- */
-export interface ReflectionResult {
-  taskName: string;
-  completed: string;        // ISO timestamp
-  duration?: string;
-  filesModified: {
-    count: number;
-    linesAdded: number;
-    linesRemoved: number;
-  };
-  accomplishments: string[];
-  strengths: string[];
-  issues: ReflectionIssue[];
-  recommendedActions: {
-    priority1: string[];  // MUST FIX
-    priority2: string[];  // SHOULD FIX
-    priority3: string[];  // NICE TO HAVE
-  };
-  lessonsLearned: LessonLearned;
-  metrics: ReflectionMetrics;
-  relatedTasks?: string[];
-  metadata: {
-    model: ReflectionModel;
-    reflectionTime: number; // seconds
-    estimatedCost: number;  // USD
-  };
-}
-
-/**
- * Configuration for reflection system
- */
-export interface ReflectionConfig {
-  enabled: boolean;
-  mode: ReflectionMode;
-  depth: ReflectionDepth;
-  model: ReflectionModel;
-  categories: {
-    security: boolean;
-    quality: boolean;
-    testing: boolean;
-    performance: boolean;
-    technicalDebt: boolean;
-  };
-  criticalThreshold: IssueSeverity;
-  storeReflections: boolean;
-  autoCreateFollowUpTasks: boolean;
-  soundNotifications?: boolean;
-}
-
-/**
- * Git diff information for modified files
- */
-export interface GitDiffInfo {
-  file: string;
-  linesAdded: number;
-  linesRemoved: number;
-  content: string;
-}
-
-/**
- * Context for reflection execution
- */
-export interface ReflectionContext {
-  incrementId: string;
-  taskId: string;
-  modifiedFiles: GitDiffInfo[];
-  config: ReflectionConfig;
-}
-
-/**
- * Reflection execution result (success or failure)
- */
-export interface ReflectionExecutionResult {
-  success: boolean;
-  result?: ReflectionResult;
-  error?: {
-    message: string;
-    code: string;
-    details?: any;
-  };
-}
-
-/**
- * Default reflection configuration
- */
-export const DEFAULT_REFLECTION_CONFIG: ReflectionConfig = {
-  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
-};