specweave 0.22.13 → 0.23.0

package/plugins/specweave/lib/vendor/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/plugins/specweave/lib/vendor/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/plugins/specweave-ado/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave-ado",
-  "version": "0.1.0",
+  "version": "0.22.14",
   "description": "Azure DevOps integration for SpecWeave - sync increments with ADO work items, track progress, and manage project workflows",
   "author": {
     "name": "SpecWeave Team",

package/plugins/specweave-ado/lib/ado-multi-project-sync.js

@@ -373,7 +373,6 @@ ${userStory.technicalContext}
         return mapping.task || "Task";
       case "Subtask":
         return mapping.task || "Task";
-      // ADO doesn't have subtasks, use Task
       default:
         return "User Story";
     }

package/plugins/specweave-ado/lib/conflict-resolver.ts

@@ -402,7 +402,7 @@ export async function loadSpecMetadata(specPath: string): Promise<SpecMetadata>
 }
 
 /**
- * Perform bidirectional sync with conflict resolution
+ * Perform three-permission sync with conflict resolution
  */
 export async function performBidirectionalSync(
   specPath: string,

package/plugins/specweave-alternatives/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-alternatives",
   "description": "Compare SpecWeave with BMAD, spec-kit, openspec, and other spec-driven frameworks. Get gap analysis, feature comparison, and strategic recommendations to choose the best framework for your needs.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-backend/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-backend",
   "description": "Backend API development for Node.js, Python, and .NET stacks. Includes Express, NestJS, FastAPI, Django, Flask, ASP.NET Core, and Entity Framework Core. Focus on REST APIs, authentication, database operations, and background services.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-confluent/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-confluent",
   "description": "Confluent Cloud integration for SpecWeave - Schema Registry, ksqlDB, Kafka Connect, Flink, stream processing, and enterprise Kafka features",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-cost-optimizer/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-cost-optimizer",
   "description": "Cloud cost optimization and platform comparison. Analyzes infrastructure requirements and recommends cheapest cloud platform (Hetzner, Vercel, AWS, Railway, Fly.io, DigitalOcean). Shows cost breakdown and savings calculations.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-diagrams/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-diagrams",
   "description": "Architecture diagram generation with Mermaid following C4 Model conventions. Creates C4 Context/Container/Component diagrams, sequence diagrams, ER diagrams, and deployment diagrams. SpecWeave-aware for HLD/LLD documentation.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-docs/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-docs",
   "description": "Documentation generation and spec-driven workflows. Includes Docusaurus site generation from SpecWeave structure, spec-driven brainstorming for feature ideation, and spec-driven debugging. Focus on living documentation and knowledge management.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-docs-preview/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-docs-preview",
   "description": "Interactive documentation preview with Docusaurus. Launch local dev server to view living documentation in beautiful UI with hot reload, auto-generated sidebar, and Mermaid diagrams. Build static sites for deployment.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-figma/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-figma",
   "description": "Design-to-code workflow patterns for Figma (MCP-first). Requires Figma MCP server. Extracts design tokens, generates components (React/Angular/Vue/Svelte), scaffolds tests. Uses Atomic Design and TypeScript.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-frontend/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-frontend",
   "description": "Frontend development for React, Vue, and Angular projects. Includes Next.js 14+ App Router support, design system architecture (Atomic Design), and UI component best practices. Focus on modern frontend patterns and performance.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-github/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave-github",
   "description": "GitHub Issues integration for SpecWeave increments. Bidirectional sync between SpecWeave increments and GitHub Issues. Automatically creates issues from increments, tracks progress, and closes issues on completion. Uses GitHub CLI (gh) for seamless integration.",
-  "version": "1.0.0",
+  "version": "0.22.14",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave-github/commands/specweave-github-update-user-story.md

@@ -53,7 +53,7 @@ description: Update GitHub issue for user story with proper ACs and tasks
 **What Gets Updated**:
 
 ```markdown
-**Feature**: [FS-031](../../_features/FS-031/FEATURE.md)
+**Feature**: [FS-031](../../_features/_archive/FS-031/FEATURE.md)
 **Status**: complete
 **Priority**: P1
 **Project**: default

package/plugins/specweave-github/hooks/post-task-completion.sh

@@ -201,35 +201,50 @@ else
 fi
 
 # ============================================================================
-# EPIC GITHUB ISSUE SYNC (Update Epic issue with fresh task progress)
+# EPIC GITHUB ISSUE SYNC (DEPRECATED v0.24.0+)
+# ============================================================================
+#
+# ⚠️  DEPRECATED: SpecWeave now syncs ONLY at User Story level.
+#
+# Feature/Epic-level issues are no longer updated.
+# Use /specweave-github:sync instead to sync User Story issues.
+#
+# To re-enable (NOT recommended):
+#   export SPECWEAVE_ENABLE_EPIC_SYNC=true
+#
+# @see .specweave/increments/0047-us-task-linkage/reports/GITHUB-TITLE-FORMAT-FIX-PLAN.md
 # ============================================================================
 
-echo "[$(date)] [GitHub] 🔄 Checking for Epic GitHub issue update..." >> "$DEBUG_LOG" 2>/dev/null || true
+if [ "$SPECWEAVE_ENABLE_EPIC_SYNC" = "true" ]; then
+  echo "[$(date)] [GitHub] 🔄 Checking for Epic GitHub issue update (DEPRECATED)..." >> "$DEBUG_LOG" 2>/dev/null || true
 
-# Find active increment ID
-ACTIVE_INCREMENT=$(ls -t .specweave/increments/ | grep -v '^\.' | while read inc; do
-  if [ -f ".specweave/increments/$inc/metadata.json" ]; then
-    STATUS=$(grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' ".specweave/increments/$inc/metadata.json" 2>/dev/null | sed 's/.*"\([^"]*\)".*/\1/' || true)
-    if [ "$STATUS" = "active" ]; then
-      echo "$inc"
-      break
+  # Find active increment ID
+  ACTIVE_INCREMENT=$(ls -t .specweave/increments/ | grep -v '^\.' | while read inc; do
+    if [ -f ".specweave/increments/$inc/metadata.json" ]; then
+      STATUS=$(grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' ".specweave/increments/$inc/metadata.json" 2>/dev/null | sed 's/.*"\([^"]*\)".*/\1/' || true)
+      if [ "$STATUS" = "active" ]; then
+        echo "$inc"
+        break
+      fi
+    fi
+  done | head -1)
+
+  if [ -n "$ACTIVE_INCREMENT" ]; then
+    echo "[$(date)] [GitHub] 🎯 Active increment: $ACTIVE_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
+
+    # Run Epic sync script (silently, errors logged to debug log)
+    if [ -f "$PROJECT_ROOT/scripts/update-epic-github-issue.sh" ]; then
+      echo "[$(date)] [GitHub] 🚀 Updating Epic GitHub issue (DEPRECATED)..." >> "$DEBUG_LOG" 2>/dev/null || true
+      "$PROJECT_ROOT/scripts/update-epic-github-issue.sh" "$ACTIVE_INCREMENT" >> "$DEBUG_LOG" 2>&1 || true
+      echo "[$(date)] [GitHub] ⚠️  Epic sync is deprecated. Use /specweave-github:sync instead." >> "$DEBUG_LOG" 2>/dev/null || true
+    else
+      echo "[$(date)] [GitHub] ⚠️  Epic sync script not found, skipping" >> "$DEBUG_LOG" 2>/dev/null || true
     fi
-  fi
-done | head -1)
-
-if [ -n "$ACTIVE_INCREMENT" ]; then
-  echo "[$(date)] [GitHub] 🎯 Active increment: $ACTIVE_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
-
-  # Run Epic sync script (silently, errors logged to debug log)
-  if [ -f "$PROJECT_ROOT/scripts/update-epic-github-issue.sh" ]; then
-    echo "[$(date)] [GitHub] 🚀 Updating Epic GitHub issue..." >> "$DEBUG_LOG" 2>/dev/null || true
-    "$PROJECT_ROOT/scripts/update-epic-github-issue.sh" "$ACTIVE_INCREMENT" >> "$DEBUG_LOG" 2>&1 || true
-    echo "[$(date)] [GitHub] ✅ Epic sync complete (see logs for details)" >> "$DEBUG_LOG" 2>/dev/null || true
   else
-    echo "[$(date)] [GitHub] ⚠️  Epic sync script not found, skipping" >> "$DEBUG_LOG" 2>/dev/null || true
+    echo "[$(date)] [GitHub] ℹ️  No active increment found, skipping Epic sync" >> "$DEBUG_LOG" 2>/dev/null || true
   fi
 else
-  echo "[$(date)] [GitHub] ℹ️  No active increment found, skipping Epic sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  echo "[$(date)] [GitHub] ℹ️  Epic sync disabled (sync at User Story level only)" >> "$DEBUG_LOG" 2>/dev/null || true
 fi
 
 # ============================================================================

package/plugins/specweave-github/lib/ThreeLayerSyncManager.ts

@@ -1,5 +1,5 @@
 /**
- * Three-Layer Bidirectional Sync Manager
+ * Three-Layer Full Sync Manager (All Permissions Enabled)
  *
  * Handles synchronization across three layers:
  * - Layer 1: GitHub Issue (stakeholder UI)