specweave 0.16.7 → 0.16.12

package/dist/src/utils/translation.js

@@ -0,0 +1,414 @@
+/**
+ * Translation Utilities
+ *
+ * LLM-native translation system for SpecWeave multilingual support.
+ * Provides zero-cost language detection and cost-efficient translation
+ * using Claude Haiku via current LLM session.
+ *
+ * Strategy:
+ * - Language Detection: Simple heuristic (no API calls, <1ms)
+ * - Translation: Claude Haiku via current session (~$0.0025 per file)
+ * - Preservation: Markdown, code blocks, technical terms stay intact
+ *
+ * @see .specweave/increments/0006-llm-native-i18n/reports/DESIGN-POST-GENERATION-TRANSLATION.md
+ */
+/**
+ * Language detection patterns (Unicode ranges for major scripts)
+ */
+const LANGUAGE_PATTERNS = {
+    ru: /[а-яА-ЯёЁ]/, // Cyrillic (Russian)
+    zh: /[\u4e00-\u9fff]/, // Chinese characters (CJK Unified Ideographs)
+    ja: /[\u3040-\u309f\u30a0-\u30ff]/, // Hiragana + Katakana (Japanese)
+    ko: /[\uac00-\ud7af]/, // Hangul (Korean)
+    ar: /[\u0600-\u06ff]/, // Arabic
+    he: /[\u0590-\u05ff]/, // Hebrew
+    // Latin-based languages need context (Spanish, German, French, Portuguese)
+    // We'll use heuristics for these
+};
+/**
+ * Spanish-specific words/patterns
+ */
+const SPANISH_INDICATORS = [
+    'ción', 'sión', 'qué', 'cuál', 'español', 'también', 'año', 'señor'
+];
+/**
+ * German-specific words/patterns
+ */
+const GERMAN_INDICATORS = [
+    'ß', 'ä', 'ö', 'ü', 'dass', 'ich', 'und', 'der', 'die', 'das'
+];
+/**
+ * French-specific words/patterns
+ */
+const FRENCH_INDICATORS = [
+    'ç', 'où', 'être', 'français', 'avec', 'dans', 'pour', 'qui', 'que'
+];
+/**
+ * Portuguese-specific words/patterns
+ */
+const PORTUGUESE_INDICATORS = [
+    'ção', 'português', 'também', 'não', 'com', 'para', 'seu', 'sua', 'documentação'
+];
+/**
+ * Detects the language of the given content using simple heuristics
+ *
+ * @param content - The text content to analyze
+ * @returns Language detection result with confidence score
+ *
+ * @example
+ * ```typescript
+ * const result = detectLanguage('Это тестовый документ');
+ * console.log(result.language); // 'ru'
+ * console.log(result.confidence); // 0.95
+ * ```
+ */
+export function detectLanguage(content) {
+    // Calculate non-ASCII ratio
+    const nonAsciiChars = content.match(/[^\x00-\x7F]/g) || [];
+    const totalChars = content.length;
+    const nonAsciiRatio = totalChars > 0 ? nonAsciiChars.length / totalChars : 0;
+    // If <5% non-ASCII, likely English
+    if (nonAsciiRatio < 0.05) {
+        return {
+            language: 'en',
+            confidence: 0.95,
+            nonAsciiRatio,
+            detectionMethod: 'heuristic'
+        };
+    }
+    // Try to detect specific language
+    const detected = detectSpecificLanguage(content);
+    if (detected !== 'unknown') {
+        return {
+            language: detected,
+            confidence: 0.90,
+            nonAsciiRatio,
+            detectionMethod: 'heuristic'
+        };
+    }
+    // Fallback: unknown language
+    return {
+        language: 'unknown',
+        confidence: 0.5,
+        nonAsciiRatio,
+        detectionMethod: 'heuristic'
+    };
+}
+/**
+ * Detects specific language from content
+ *
+ * @param content - The text content to analyze
+ * @returns Detected language code or 'unknown'
+ *
+ * @example
+ * ```typescript
+ * detectSpecificLanguage('Это текст'); // 'ru'
+ * detectSpecificLanguage('这是文本'); // 'zh'
+ * ```
+ */
+export function detectSpecificLanguage(content) {
+    // Test against Unicode ranges first (most reliable)
+    for (const [lang, pattern] of Object.entries(LANGUAGE_PATTERNS)) {
+        if (pattern.test(content)) {
+            return lang;
+        }
+    }
+    // For Latin-based languages, use indicator words
+    const lowerContent = content.toLowerCase();
+    // Spanish
+    if (SPANISH_INDICATORS.some(indicator => lowerContent.includes(indicator))) {
+        return 'es';
+    }
+    // Portuguese (check before French due to overlap in 'ção' and 'em')
+    if (PORTUGUESE_INDICATORS.some(indicator => lowerContent.includes(indicator))) {
+        return 'pt';
+    }
+    // German
+    if (GERMAN_INDICATORS.some(indicator => lowerContent.includes(indicator))) {
+        return 'de';
+    }
+    // French
+    if (FRENCH_INDICATORS.some(indicator => lowerContent.includes(indicator))) {
+        return 'fr';
+    }
+    return 'unknown';
+}
+/**
+ * Preserves code blocks, inline code, and links before translation
+ *
+ * @param content - Markdown content to preserve
+ * @returns Preserved content with placeholders
+ *
+ * @example
+ * ```typescript
+ * const content = 'Text\n```js\ncode\n```\nMore text';
+ * const preserved = preserveCodeBlocks(content);
+ * // preserved.blocks = ['```js\ncode\n```']
+ * // preserved.preserved = 'Text\n__CODE_BLOCK_0__\nMore text'
+ * ```
+ */
+export function preserveCodeBlocks(content) {
+    const blocks = [];
+    const inlineCode = [];
+    const links = [];
+    // 1. Preserve fenced code blocks (```...```)
+    let preserved = content.replace(/```[\s\S]*?```/g, (match) => {
+        blocks.push(match);
+        return `__CODE_BLOCK_${blocks.length - 1}__`;
+    });
+    // 2. Preserve inline code (`...`)
+    preserved = preserved.replace(/`[^`]+`/g, (match) => {
+        inlineCode.push(match);
+        return `__INLINE_CODE_${inlineCode.length - 1}__`;
+    });
+    // 3. Preserve markdown links ([text](url))
+    preserved = preserved.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (match, text, url) => {
+        links.push(match);
+        return `__LINK_${links.length - 1}__`;
+    });
+    return {
+        preserved,
+        blocks,
+        inlineCode,
+        links
+    };
+}
+/**
+ * Restores preserved code blocks, inline code, and links after translation
+ *
+ * @param translated - Translated text with placeholders
+ * @param preserved - Preserved content structure
+ * @returns Restored text with original code blocks and links
+ *
+ * @example
+ * ```typescript
+ * const translated = 'Текст\n__CODE_BLOCK_0__\nБольше текста';
+ * const preserved = { blocks: ['```js\ncode\n```'], inlineCode: [], links: [] };
+ * const restored = restoreCodeBlocks(translated, preserved);
+ * // Result: 'Текст\n```js\ncode\n```\nБольше текста'
+ * ```
+ */
+export function restoreCodeBlocks(translated, preserved) {
+    let restored = translated;
+    // Restore in reverse order of preservation (links → inline code → blocks)
+    // 1. Restore links
+    preserved.links.forEach((link, i) => {
+        restored = restored.replace(`__LINK_${i}__`, link);
+    });
+    // 2. Restore inline code
+    preserved.inlineCode.forEach((code, i) => {
+        restored = restored.replace(`__INLINE_CODE_${i}__`, code);
+    });
+    // 3. Restore code blocks
+    preserved.blocks.forEach((block, i) => {
+        restored = restored.replace(`__CODE_BLOCK_${i}__`, block);
+    });
+    return restored;
+}
+/**
+ * Estimates the number of tokens in a text
+ * Rule of thumb: ~4 characters per token for English, ~2-3 for other languages
+ *
+ * @param text - Text to estimate
+ * @param language - Language code for estimation
+ * @returns Estimated token count
+ */
+export function estimateTokens(text, language = 'en') {
+    const charsPerToken = language === 'en' ? 4 : 3;
+    return Math.ceil(text.length / charsPerToken);
+}
+/**
+ * Estimates translation cost using Claude Haiku pricing
+ * Haiku pricing (as of 2025): $0.25 per 1M input tokens, $1.25 per 1M output tokens
+ *
+ * @param inputTokens - Input token count
+ * @param outputTokens - Output token count (defaults to input for balanced estimate)
+ * @returns Estimated cost in USD
+ */
+export function estimateTranslationCost(inputTokens, outputTokens) {
+    const HAIKU_INPUT_COST_PER_1M = 0.25;
+    const HAIKU_OUTPUT_COST_PER_1M = 1.25;
+    const actualOutputTokens = outputTokens || inputTokens; // Assume similar length
+    const inputCost = (inputTokens / 1000000) * HAIKU_INPUT_COST_PER_1M;
+    const outputCost = (actualOutputTokens / 1000000) * HAIKU_OUTPUT_COST_PER_1M;
+    return inputCost + outputCost;
+}
+/**
+ * Generates translation prompt for LLM
+ *
+ * @param content - Content to translate
+ * @param sourceLanguage - Source language code
+ * @param targetLanguage - Target language code (default: 'en')
+ * @returns Translation prompt for LLM
+ */
+export function generateTranslationPrompt(content, sourceLanguage, targetLanguage = 'en') {
+    const languageNames = {
+        en: 'English',
+        ru: 'Russian',
+        es: 'Spanish',
+        zh: 'Chinese',
+        de: 'German',
+        fr: 'French',
+        ja: 'Japanese',
+        ko: 'Korean',
+        pt: 'Portuguese',
+        ar: 'Arabic',
+        he: 'Hebrew',
+        unknown: 'Unknown'
+    };
+    const sourceName = languageNames[sourceLanguage] || sourceLanguage;
+    const targetName = languageNames[targetLanguage] || targetLanguage;
+    return `You are a technical translator specializing in software documentation.
+
+Translate the following ${sourceName} document to ${targetName}.
+
+PRESERVATION RULES (CRITICAL):
+1. **Markdown Formatting**: Preserve ALL markdown syntax exactly (headers, lists, links, code blocks, tables)
+2. **YAML Frontmatter**: Keep structure intact, translate values only
+3. **Code Blocks**: NEVER translate code (keep as-is, including comments if in English)
+4. **Inline Code**: NEVER translate \`code spans\` (keep as-is)
+5. **Technical Terms**: Keep in English (Git, Docker, Kubernetes, TypeScript, React, etc.)
+6. **Framework Terms**: Keep in English (Increment, Living Docs, SpecWeave, ADR, RFC, HLD, PRD)
+7. **Document Structure**: Maintain exact heading hierarchy and nesting
+8. **Links**: Preserve link structure, translate link text only if needed
+9. **Formatting**: Preserve bold (**text**), italic (*text*), code spans (\`code\`)
+10. **Placeholders**: Do NOT translate placeholders like __CODE_BLOCK_0__, __INLINE_CODE_1__, __LINK_2__
+11. **IDs and References**: Keep task IDs (T-001), test IDs (TC-001), user story IDs (US-001) unchanged
+
+TRANSLATION STYLE:
+- Professional technical ${targetName}
+- Clear, concise, unambiguous language
+- Industry-standard terminology
+- Consistent term usage throughout
+- Natural phrasing (not word-for-word literal)
+
+SOURCE DOCUMENT (${sourceName}):
+---
+${content}
+---
+
+TRANSLATED ${targetName.toUpperCase()} VERSION (preserve all formatting):`;
+}
+/**
+ * Translates content to English using LLM (Claude Haiku)
+ * This function generates the prompt but delegates actual LLM invocation
+ * to the caller (via Task tool, skill, or direct API)
+ *
+ * @param content - Content to translate
+ * @param sourceLanguage - Source language code
+ * @returns Translation prompt and metadata (caller must invoke LLM)
+ *
+ * @example
+ * ```typescript
+ * const content = 'Это тестовый документ';
+ * const result = prepareTranslation(content, 'ru');
+ * // Caller then invokes LLM with result.prompt
+ * ```
+ */
+export function prepareTranslation(content, sourceLanguage, targetLanguage = 'en') {
+    // 1. Preserve code blocks and links
+    const preserved = preserveCodeBlocks(content);
+    // 2. Generate translation prompt
+    const prompt = generateTranslationPrompt(preserved.preserved, sourceLanguage, targetLanguage);
+    // 3. Estimate cost
+    const inputTokens = estimateTokens(prompt, sourceLanguage);
+    const outputTokens = estimateTokens(preserved.preserved, targetLanguage);
+    const estimatedCost = estimateTranslationCost(inputTokens, outputTokens);
+    return {
+        prompt,
+        preserved,
+        estimatedTokens: inputTokens + outputTokens,
+        estimatedCost
+    };
+}
+/**
+ * Post-processes translated content
+ * Restores code blocks, validates markdown, cleans up extra whitespace
+ *
+ * @param translated - Translated text from LLM
+ * @param preserved - Preserved content structure
+ * @returns Cleaned and restored translated content
+ */
+export function postProcessTranslation(translated, preserved) {
+    // 1. Restore preserved blocks
+    let restored = restoreCodeBlocks(translated, preserved);
+    // 2. Clean up extra whitespace (LLM sometimes adds extra newlines)
+    restored = restored
+        .replace(/\n{4,}/g, '\n\n\n') // Max 3 consecutive newlines
+        .replace(/[ \t]+$/gm, ''); // Remove trailing spaces
+    // 3. Ensure file ends with single newline
+    restored = restored.trim() + '\n';
+    return restored;
+}
+/**
+ * Validates that translated content preserves markdown structure
+ * Returns warnings if structure doesn't match
+ *
+ * @param original - Original content
+ * @param translated - Translated content
+ * @returns Array of validation warnings (empty if valid)
+ */
+export function validateTranslation(original, translated) {
+    const warnings = [];
+    // 1. Check heading count matches
+    const originalHeadings = (original.match(/^#{1,6}\s/gm) || []).length;
+    const translatedHeadings = (translated.match(/^#{1,6}\s/gm) || []).length;
+    if (originalHeadings !== translatedHeadings) {
+        warnings.push(`Heading count mismatch: original has ${originalHeadings}, translated has ${translatedHeadings}`);
+    }
+    // 2. Check code block count matches
+    const originalCodeBlocks = (original.match(/```/g) || []).length;
+    const translatedCodeBlocks = (translated.match(/```/g) || []).length;
+    if (originalCodeBlocks !== translatedCodeBlocks) {
+        warnings.push(`Code block count mismatch: original has ${originalCodeBlocks}, translated has ${translatedCodeBlocks}`);
+    }
+    // 3. Check link count matches
+    const originalLinks = (original.match(/\[([^\]]+)\]\(([^)]+)\)/g) || []).length;
+    const translatedLinks = (translated.match(/\[([^\]]+)\]\(([^)]+)\)/g) || []).length;
+    if (originalLinks !== translatedLinks) {
+        warnings.push(`Link count mismatch: original has ${originalLinks}, translated has ${translatedLinks}`);
+    }
+    // 4. Check YAML frontmatter present in both (if exists in original)
+    const hasOriginalYAML = /^---\n[\s\S]*?\n---/m.test(original);
+    const hasTranslatedYAML = /^---\n[\s\S]*?\n---/m.test(translated);
+    if (hasOriginalYAML && !hasTranslatedYAML) {
+        warnings.push('YAML frontmatter missing in translation');
+    }
+    return warnings;
+}
+/**
+ * Gets human-readable language name
+ *
+ * @param code - Language code
+ * @returns Human-readable name
+ */
+export function getLanguageName(code) {
+    const names = {
+        en: 'English',
+        ru: 'Russian',
+        es: 'Spanish',
+        zh: 'Chinese',
+        de: 'German',
+        fr: 'French',
+        ja: 'Japanese',
+        ko: 'Korean',
+        pt: 'Portuguese',
+        ar: 'Arabic',
+        he: 'Hebrew',
+        unknown: 'Unknown'
+    };
+    return names[code] || code;
+}
+/**
+ * Formats cost for display
+ *
+ * @param cost - Cost in USD
+ * @returns Formatted string (e.g., "$0.0025" or "<$0.001")
+ */
+export function formatCost(cost) {
+    if (cost < 0.001) {
+        return '<$0.001';
+    }
+    return `$${cost.toFixed(4)}`;
+}
+//# sourceMappingURL=translation.js.map

package/dist/src/utils/translation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.js","sourceRoot":"","sources":["../../../src/utils/translation.ts"],"names":[],"mappings":"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"}

package/dist/utils/git-utils.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Git Utilities for SpecWeave
+ *
+ * Provides utilities for:
+ * - Getting recent commits
+ * - Generating commit URLs for different providers
+ * - Finding PRs containing commits
+ * - Detecting repository information
+ */
+export interface GitCommit {
+    sha: string;
+    shortSha: string;
+    message: string;
+    author: string;
+    date: Date;
+    url?: string;
+}
+export interface GitRepository {
+    provider: 'github' | 'gitlab' | 'bitbucket' | 'azure' | 'unknown';
+    owner: string;
+    repo: string;
+    url: string;
+}
+export interface PullRequest {
+    number: number;
+    title: string;
+    url: string;
+    state: 'open' | 'closed' | 'merged';
+}
+/**
+ * Get recent commits since a specific date/SHA
+ */
+export declare function getRecentCommits(since?: string, sinceCommit?: string, cwd?: string): Promise<GitCommit[]>;
+/**
+ * Get commits between two refs (e.g., last sync to HEAD)
+ */
+export declare function getCommitsBetween(fromRef: string, toRef?: string, cwd?: string): Promise<GitCommit[]>;
+/**
+ * Detect repository information from git remote
+ */
+export declare function detectRepository(remoteName?: string, cwd?: string): Promise<GitRepository | null>;
+/**
+ * Parse git remote URL to extract provider, owner, repo
+ */
+export declare function parseGitRemoteUrl(url: string): GitRepository | null;
+/**
+ * Generate commit URL for different providers
+ */
+export declare function getCommitUrl(commit: GitCommit, repo: GitRepository): string;
+/**
+ * Find PR containing a commit (GitHub only for now)
+ */
+export declare function findPRForCommit(commitSha: string, owner: string, repo: string): Promise<PullRequest | null>;
+/**
+ * Get last sync commit SHA from metadata
+ */
+export declare function getLastSyncCommit(metadataPath: string): Promise<string | null>;
+/**
+ * Update last sync commit in metadata
+ */
+export declare function updateLastSyncCommit(metadataPath: string, commitSha: string): Promise<void>;
+/**
+ * Get current HEAD commit SHA
+ */
+export declare function getCurrentCommitSha(cwd?: string): Promise<string>;
+/**
+ * Check if working directory is clean
+ */
+export declare function isWorkingDirectoryClean(cwd?: string): Promise<boolean>;
+/**
+ * Get current branch name
+ */
+export declare function getCurrentBranch(cwd?: string): Promise<string>;
+//# sourceMappingURL=git-utils.d.ts.map

package/dist/utils/git-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../src/utils/git-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACrC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,EAAE,CAAC,CAoCtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAe,EACtB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,EAAE,CAAC,CA0BtB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,GAAE,MAAiB,EAC7B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgB/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAkEnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,aAAa,GAClB,MAAM,CAaR;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyC7B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQvE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQpE"}