specweave 0.17.16 → 0.17.17

package/dist/locales/ru/cli.json

@@ -0,0 +1,269 @@
+{
+  "init": {
+    "welcome": "🚀 Инициализация SpecWeave",
+    "projectName": "Название проекта:",
+    "projectNamePrompt": "Название проекта (для шаблонов):",
+    "projectNameDefault": "my-saas",
+    "detectingTool": "Определение AI-инструмента...",
+    "foundClaude": "✅ Обнаружен Claude Code",
+    "foundCursor": "✅ Обнаружен Cursor",
+    "foundCopilot": "✅ Обнаружен GitHub Copilot",
+    "noToolDetected": "AI-инструмент не обнаружен, используется Generic адаптер",
+    "complete": "✨ Инициализация завершена!",
+    "claudeNativeComplete": "✨ Установка Claude Code завершена!",
+    "claudeNativeBenefits": "✅ Навыки, агенты и хуки работают из коробки",
+    "projectSuccess": "Проект SpecWeave успешно создан!",
+    "readyToBuild": "🚀 Готов к разработке с SpecWeave!",
+    "nestedCdCommand": "cd {{path}}",
+    "nestedIncCommand": "/specweave.inc \"ваша-фича\"",
+    "pluginEnableLater": "Вы можете включить плагины позже командой: specweave plugin enable <имя>",
+    "genericError": "Ошибка:",
+    "errors": {
+      "invalidName": "Название проекта должно содержать только строчные буквы, цифры и дефисы",
+      "alreadyExists": "Директория .specweave уже существует",
+      "cancelled": "❌ Инициализация отменена",
+      "invalidLanguage": "❌ Неверный язык: {{language}}",
+      "supportedLanguages": "Поддерживаемые языки: {{languages}}",
+      "nestedNotSupported": "❌ Вложенные .specweave/ папки НЕ поддерживаются!",
+      "parentFound": "Найдена родительская .specweave/ в:",
+      "projectCreationFailed": "Не удалось создать проект",
+      "commandsCopyFailed": "❌ Ошибка копирования команд: {{error}}",
+      "agentsCopyFailed": "❌ Ошибка копирования агентов: {{error}}",
+      "skillsCopyFailed": "❌ Ошибка копирования навыков: {{error}}",
+      "hooksCopyFailed": "❌ Ошибка копирования хуков: {{error}}",
+      "templatesNotFound": "❌ Ошибка: Директория шаблонов не найдена по пути: {{path}}",
+      "packageRoot": "Корень пакета: {{root}}",
+      "tryingAlternate": "Поиск альтернативных расположений...",
+      "foundTemplatesAt": "✓ Найдены шаблоны в: {{path}}",
+      "sourceNotFound": "❌ Ошибка: Исходная директория {{type}} не найдена",
+      "expectedAt": "Ожидалось в: {{path}}",
+      "dirname": "__dirname: {{path}}",
+      "couldNotFindRoot": "Не удалось найти корень пакета (поиск package.json с name=\"specweave\")",
+      "sourceEmpty": "❌ Ошибка: Исходная директория {{type}} пуста",
+      "directory": "Директория: {{path}}",
+      "installationIssue": "Это указывает на проблему установки пакета.",
+      "errorCopying": "❌ Ошибка копирования {{type}}: {{error}}",
+      "source": "Источник: {{path}}",
+      "target": "Назначение: {{path}}"
+    },
+    "warnings": {
+      "invalidDirName": "⚠️  Имя текущей директории '{{dirName}}' содержит недопустимые символы.",
+      "directoryNotEmpty": "⚠️  Текущая директория содержит {{count}} файл{{plural}}.",
+      "skillsIndexWarning": "⚠️  Предупреждение: Не удалось создать индекс навыков: {{error}}",
+      "skillsIndexNote": "Навыки всё равно будут работать, но может потребоваться ручная индексация.",
+      "marketplaceCopyFailed": "⚠️  Предупреждение: Не удалось скопировать маркетплейс плагинов",
+      "marketplaceNotFound": "⚠️  Предупреждение: Маркетплейс плагинов не найден",
+      "pluginAutoSetupFailed": "⚠️  Предупреждение: Не удалось настроить автоматическую регистрацию плагинов"
+    },
+    "prompts": {
+      "confirmInitInCurrent": "Инициализировать SpecWeave в текущей директории?",
+      "overwriteSpecweave": "Директория .specweave уже существует. Перезаписать?",
+      "overwriteDirectory": "Директория {{projectName}} уже существует. Перезаписать?",
+      "enablePlugins": "Включить предложенные плагины сейчас?"
+    },
+    "info": {
+      "nestedEnforcement": "SpecWeave требует единого источника истины:",
+      "nestedBullet1": "• Используйте родительскую папку для всех инкрементов",
+      "nestedBullet2": "• Инкременты могут охватывать несколько поддиректорий",
+      "nestedBullet3": "• См. раздел CLAUDE.md \"Root-Level .specweave/ Folder\"",
+      "nestedToFix": "Чтобы исправить:",
+      "suggestedPlugins": "💡 Предлагаемые плагины:",
+      "copiedFiles": "✓ Скопировано {{count}} файлов команд",
+      "copiedAgents": "✓ Скопировано {{count}} директорий агентов",
+      "copiedSkills": "✓ Скопировано {{count}} директорий навыков",
+      "copiedHooks": "✓ Скопировано {{count}} файлов хуков",
+      "pluginAutoSetupDetails": "Claude Code автоматически загрузит маркетплейс SpecWeave когда вы доверитесь этой папке"
+    },
+    "success": {
+      "pluginAutoSetup": "Маркетплейс плагинов настроен для автоматической загрузки"
+    },
+    "progress": {
+      "creatingProject": "Создание проекта SpecWeave...",
+      "detected": "Обнаружен {{tool}}...",
+      "usingTool": "Используется {{tool}}...",
+      "directoryCreated": "Структура директорий создана...",
+      "templatesCopied": "Базовые шаблоны скопированы...",
+      "installingComponents": "Установка компонентов Claude Code...",
+      "commandsInstalled": "Команды установлены...",
+      "agentsInstalled": "Агенты установлены...",
+      "skillsInstalled": "Навыки установлены...",
+      "hooksInstalled": "Хуки установлены...",
+      "generatingIndex": "Создание индекса навыков...",
+      "indexGenerated": "Индекс навыков создан...",
+      "installingAdapter": "Установка адаптера {{tool}}...",
+      "projectSuccess": "Проект SpecWeave успешно создан!",
+      "detectingPlugins": "Определение плагинов...",
+      "detectedPlugins": "Обнаружено {{count}} предлагаемых плагинов",
+      "enablingPlugins": "Включение плагинов...",
+      "enabledPlugin": "Включён {{plugin}}",
+      "pluginsEnabled": "Плагины включены"
+    },
+    "nextSteps": {
+      "header": "🎯 Следующие шаги:",
+      "cd": "cd {{projectName}}",
+      "footer": "🚀 Готов к разработке с SpecWeave!",
+      "docsLink": "Документация: https://spec-weave.com",
+      "githubLink": "GitHub: https://github.com/anton-abyzov/specweave",
+      "claude": {
+        "step1": "Откройте Claude Code в этой директории",
+        "step2": "Установите основной плагин SpecWeave (ОБЯЗАТЕЛЬНО):",
+        "installCore": "Выполните: /plugin install specweave",
+        "step3": "Опционально: Установите дополнительные плагины по необходимости:",
+        "installGitHub": "/plugin install specweave-github",
+        "installFrontend": "/plugin install specweave-frontend",
+        "step4": "Начните разработку:",
+        "example": "\"/specweave:inc 'аутентификация пользователя'\"",
+        "autoActivate": "Навыки и агенты активируются автоматически по контексту"
+      },
+      "cursor": {
+        "step1": "Откройте проект в Cursor",
+        "step2": "Скажите: \"Создать инкремент для [вашей функции]\"",
+        "guide": "Cursor прочитает .cursorrules и поможет вам",
+        "step3": "Используйте @ ярлыки:",
+        "shortcuts": "@increments, @docs, @strategy, @tests"
+      },
+      "copilot": {
+        "step1": "Откройте проект в VS Code с Copilot",
+        "step2": "Copilot автоматически прочитает инструкции workspace",
+        "action": "Начните создавать папки и файлы инкрементов",
+        "step3": "Используйте Copilot Chat для помощи:",
+        "example": "\"Как создать spec.md?\""
+      },
+      "generic": {
+        "step1": "Прочитайте SPECWEAVE-MANUAL.md",
+        "step2": "Следуйте пошаговым инструкциям",
+        "compatibility": "Работает с ЛЮБЫМ AI инструментом (ChatGPT, Claude web, Gemini)"
+      }
+    }
+  },
+  "plugin": {
+    "list": {
+      "header": "📦 Плагины SpecWeave",
+      "enabledHeader": "✅ Включенные плагины:",
+      "enabledNone": "(нет)",
+      "errorLoading": "(ошибка загрузки)",
+      "availableHeader": "📚 Доступные плагины:",
+      "availableNone": "(все включены)",
+      "suggestedHeader": "💡 Рекомендуемые плагины (автообнаружены):",
+      "enableHint": "Запустите `specweave plugin enable <имя>` для включения плагина",
+      "statsFormat": "Навыки: {{skills}}, Агенты: {{agents}}, Команды: {{commands}}",
+      "errorListing": "❌ Ошибка получения списка плагинов:"
+    },
+    "enable": {
+      "enablingPlugin": "🔌 Включение плагина: {{name}}",
+      "alreadyEnabled": "⚠️  Плагин {{name}} уже включён",
+      "useForce": "Используйте --force для переустановки",
+      "success": "✅ Плагин {{name}} успешно включён!",
+      "installed": "Установлено:",
+      "skills": "Навыки: {{names}}",
+      "agents": "Агенты: {{names}}",
+      "commands": "Команды: {{names}}",
+      "installedTo": "Плагин установлен в: {{location}}",
+      "restartClaude": "⚠️  Перезапустите Claude Code для активации нового плагина",
+      "errorEnabling": "❌ Ошибка включения плагина:"
+    },
+    "disable": {
+      "disablingPlugin": "🔌 Отключение плагина: {{name}}",
+      "notEnabled": "⚠️  Плагин {{name}} не включён",
+      "success": "✅ Плагин {{name}} успешно отключён!",
+      "restartClaude": "⚠️  Перезапустите Claude Code для деактивации плагина",
+      "errorDisabling": "❌ Ошибка отключения плагина:"
+    },
+    "info": {
+      "header": "📋 Информация о плагине: {{name}}",
+      "notFound": "❌ Плагин {{name}} не найден",
+      "listHint": "Запустите `specweave plugin list --available` для просмотра доступных плагинов",
+      "name": "Название:",
+      "version": "Версия:",
+      "description": "Описание:",
+      "author": "Автор:",
+      "license": "Лицензия:",
+      "coreVersion": "Версия SpecWeave Core:",
+      "status": "Статус:",
+      "statusEnabled": "✅ Включён",
+      "statusDisabled": "⚪ Отключён",
+      "provides": "Предоставляет:",
+      "skillsFormat": "Навыки: {{skills}}",
+      "agentsFormat": "Агенты: {{agents}}",
+      "commandsFormat": "Команды: {{commands}}",
+      "noneValue": "(нет)",
+      "dependencies": "Зависимости:",
+      "autoDetect": "Триггеры автообнаружения:",
+      "autoDetectFiles": "Файлы: {{files}}",
+      "autoDetectPackages": "Пакеты: {{packages}}",
+      "autoDetectEnv": "Переменные окружения: {{env}}",
+      "autoDetectGit": "Шаблон Git Remote: {{pattern}}",
+      "credits": "Благодарности:",
+      "basedOn": "Основано на: {{source}}",
+      "originalAuthor": "Оригинальный автор: {{author}}",
+      "contributors": "Контрибьюторы: {{contributors}}",
+      "errorGettingInfo": "❌ Ошибка получения информации о плагине:"
+    },
+    "errors": {
+      "nameRequired": "❌ Требуется имя плагина для команды {{command}}",
+      "usageEnable": "Использование: specweave plugin enable <имя-плагина>",
+      "usageDisable": "Использование: specweave plugin disable <имя-плагина>",
+      "usageInfo": "Использование: specweave plugin info <имя-плагина>",
+      "unknownAction": "❌ Неизвестное действие плагина: {{action}}",
+      "validActions": "Допустимые действия: list, enable, disable, info"
+    }
+  },
+  "list": {
+    "header": "📋 Компоненты SpecWeave",
+    "agentsHeader": "🤖 Агенты:",
+    "skillsHeader": "✨ Навыки:",
+    "availableFormat": "Доступно в SpecWeave: {{count}} {{type}}",
+    "agents": "агентов",
+    "skills": "навыков",
+    "noDescription": "Нет описания",
+    "noAgents": "⚠️  Агенты не найдены в src/agents/",
+    "noSkills": "⚠️  Навыки не найдены в src/skills/",
+    "hintInstalled": "Запустите `specweave list --installed` для просмотра установленных компонентов",
+    "hintInstall": "Запустите `specweave install <имя>` для установки конкретного компонента",
+    "localInstallation": "📁 Локальная установка (.claude/):",
+    "globalInstallation": "🌍 Глобальная установка (~/.claude/):",
+    "noComponentsInstalled": "⚠️  Компоненты не установлены",
+    "installPrompt": "Запустите `specweave install` для установки компонентов"
+  },
+  "install": {
+    "header": "📦 Установка компонентов SpecWeave",
+    "notFound": "❌ Компонент \"{{name}}\" не найден",
+    "listHint": "Запустите `specweave list` для просмотра доступных компонентов",
+    "complete": "✅ Установка завершена!",
+    "installedTo": "Установлено в: {{location}}",
+    "installingFormat": "Установка {{type}}: {{name}}...",
+    "installedFormat": "Установлен {{type}}: {{name}}",
+    "failedFormat": "Не удалось установить {{type}}: {{name}}",
+    "noAgentsWarning": "⚠️  Агенты не найдены в src/agents/",
+    "noSkillsWarning": "⚠️  Навыки не найдены в src/skills/",
+    "installingCount": "📦 Установка {{count}} {{type}}...",
+    "agent": "агент",
+    "agents": "агентов",
+    "skill": "навык",
+    "skills": "навыков"
+  },
+  "increment": {
+    "creating": "📝 Создание increment: {name}",
+    "created": "✅ Increment {id} успешно создан!",
+    "nextStepDo": "Далее: Запустите /specweave.do для начала реализации",
+    "errors": {
+      "incompleteFound": "Невозможно создать новый increment! Предыдущие increment не завершены"
+    }
+  },
+  "progress": {
+    "currentIncrement": "Текущий Increment: {id}",
+    "status": "Статус: {status}",
+    "completion": "Завершено: {percent}%"
+  },
+  "translate": {
+    "translating": "🌐 Перевод контента на {language}...",
+    "complete": "✅ Перевод завершён!"
+  },
+  "version": {
+    "current": "Версия SpecWeave: {version}"
+  },
+  "errors": {
+    "fileNotFound": "❌ Файл не найден: {path}",
+    "invalidConfig": "❌ Неверная конфигурация: {error}"
+  }
+}

package/dist/locales/zh/cli.json

@@ -0,0 +1,108 @@
+{
+  "init": {
+    "welcome": "🚀 SpecWeave Initialization",
+    "projectName": "Project name:",
+    "projectNamePrompt": "Project name (for templates):",
+    "projectNameDefault": "my-saas",
+    "detectingTool": "Detecting AI tool...",
+    "foundClaude": "✅ Found Claude Code",
+    "foundCursor": "✅ Found Cursor",
+    "foundCopilot": "✅ Found GitHub Copilot",
+    "noToolDetected": "No AI tool detected, using Generic adapter",
+    "complete": "✨ Initialization complete!",
+    "claudeNativeComplete": "✨ Claude Code native installation complete!",
+    "claudeNativeBenefits": "✅ Native skills, agents, hooks work out of the box",
+    "projectSuccess": "SpecWeave project created successfully!",
+    "readyToBuild": "🚀 Ready to build with SpecWeave!",
+    "errors": {
+      "invalidName": "Project name must contain only lowercase letters, numbers, and hyphens",
+      "alreadyExists": ".specweave directory already exists",
+      "cancelled": "❌ Initialization cancelled",
+      "invalidLanguage": "❌ Invalid language: {{language}}",
+      "supportedLanguages": "Supported languages: {{languages}}",
+      "nestedNotSupported": "❌ Nested .specweave/ folders are NOT supported!",
+      "parentFound": "Found parent .specweave/ at:",
+      "projectCreationFailed": "Failed to create project",
+      "commandsCopyFailed": "❌ Commands copy failed: {{error}}",
+      "agentsCopyFailed": "❌ Agents copy failed: {{error}}",
+      "skillsCopyFailed": "❌ Skills copy failed: {{error}}",
+      "hooksCopyFailed": "❌ Hooks copy failed: {{error}}"
+    },
+    "warnings": {
+      "invalidDirName": "⚠️  Current directory name '{{dirName}}' contains invalid characters.",
+      "directoryNotEmpty": "⚠️  Current directory contains {{count}} file{{plural}}.",
+      "skillsIndexWarning": "⚠️  Warning: Could not generate skills index: {{error}}",
+      "skillsIndexNote": "Skills will still work, but manual indexing may be needed."
+    },
+    "prompts": {
+      "confirmInitInCurrent": "Initialize SpecWeave in current directory?",
+      "overwriteSpecweave": ".specweave directory already exists. Overwrite?",
+      "overwriteDirectory": "Directory {{projectName}} already exists. Overwrite?",
+      "enablePlugins": "Enable suggested plugins now?"
+    },
+    "info": {
+      "nestedEnforcement": "SpecWeave enforces a single source of truth:",
+      "nestedBullet1": "• Use the parent folder for all increments",
+      "nestedBullet2": "• Increments can span multiple subdirectories",
+      "nestedBullet3": "• See CLAUDE.md section \"Root-Level .specweave/ Folder\"",
+      "nestedToFix": "To fix:",
+      "suggestedPlugins": "💡 Suggested Plugins:",
+      "copiedFiles": "✓ Copied {{count}} command files",
+      "copiedAgents": "✓ Copied {{count}} agent directories",
+      "copiedSkills": "✓ Copied {{count}} skill directories",
+      "copiedHooks": "✓ Copied {{count}} hook files"
+    },
+    "progress": {
+      "creatingProject": "Creating SpecWeave project...",
+      "detected": "Detected {{tool}}...",
+      "usingTool": "Using {{tool}}...",
+      "directoryCreated": "Directory structure created...",
+      "templatesCopied": "Base templates copied...",
+      "installingComponents": "Installing Claude Code components...",
+      "commandsInstalled": "Slash commands installed...",
+      "agentsInstalled": "Agents installed...",
+      "skillsInstalled": "Skills installed...",
+      "hooksInstalled": "Hooks installed...",
+      "generatingIndex": "Generating skills index...",
+      "indexGenerated": "Skills index generated...",
+      "installingAdapter": "Installing {{tool}} adapter...",
+      "projectSuccess": "SpecWeave project created successfully!",
+      "detectingPlugins": "Detecting plugins...",
+      "detectedPlugins": "Detected {{count}} suggested plugins",
+      "enablingPlugins": "Enabling plugins...",
+      "enabledPlugin": "Enabled {{plugin}}",
+      "pluginsEnabled": "Plugins enabled"
+    },
+    "nextSteps": {
+      "header": "🎯 Next steps:",
+      "cd": "cd {{projectName}}",
+      "footer": "🚀 Ready to build with SpecWeave!",
+      "docsLink": "Documentation: https://spec-weave.com",
+      "githubLink": "GitHub: https://github.com/anton-abyzov/specweave"
+    }
+  },
+  "increment": {
+    "creating": "📝 Creating increment: {name}",
+    "created": "✅ Increment {id} created successfully!",
+    "nextStepDo": "Next: Run /specweave.do to start implementation",
+    "errors": {
+      "incompleteFound": "Cannot create new increment! Previous increments incomplete"
+    }
+  },
+  "progress": {
+    "currentIncrement": "Current Increment: {id}",
+    "status": "Status: {status}",
+    "completion": "Completion: {percent}%"
+  },
+  "translate": {
+    "translating": "🌐 Translating content to {language}...",
+    "complete": "✅ Translation complete!"
+  },
+  "version": {
+    "current": "SpecWeave version: {version}"
+  },
+  "errors": {
+    "fileNotFound": "❌ File not found: {path}",
+    "invalidConfig": "❌ Invalid configuration: {error}"
+  }
+}

package/dist/plugins/specweave/lib/hooks/sync-living-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-living-docs.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/sync-living-docs.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAwBH;;GAEG;AACH,iBAAe,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DhE;AAiND,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"sync-living-docs.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/sync-living-docs.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAwBH;;GAEG;AACH,iBAAe,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DhE;AAoZD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/plugins/specweave/lib/hooks/sync-living-docs.js

@@ -59,10 +59,11 @@ async function syncLivingDocs(incrementId) {
             changedDocs = result.changedFiles;
         }
         else {
-            // Simple mode: Copy spec to living docs (legacy)
-            console.log('📋 Using simple sync mode (legacy)');
-            specCopied = await copyIncrementSpecToLivingDocs(incrementId);
-            changedDocs = detectChangedDocs();
+            // Hierarchical distribution mode: Epic + User Stories (v2.1)
+            console.log('📊 Using hierarchical distribution mode (v2.1 - Epic + User Stories)');
+            const result = await hierarchicalDistribution(incrementId);
+            specCopied = result.success;
+            changedDocs = result.changedFiles;
         }
         if (changedDocs.length === 0 && !specCopied) {
             console.log('ℹ️  No living docs changed');
@@ -80,50 +81,66 @@ async function syncLivingDocs(incrementId) {
 }
 /**
  * Intelligent sync using the new architecture (v0.18.0+)
+ *
+ * NOTE: syncIncrement not yet implemented, fallback to hierarchical distribution
  */
 async function intelligentSyncLivingDocs(incrementId, config) {
+    console.log('   ⚠️  Intelligent sync not yet fully implemented');
+    console.log('   Falling back to hierarchical distribution mode...');
+    // Fallback to hierarchical distribution
+    return await hierarchicalDistribution(incrementId);
+}
+/**
+ * Hierarchical distribution using new architecture (v2.1 - Epic + User Stories)
+ *
+ * Distributes increment spec into hierarchical structure:
+ * - Epic file (SPEC-###.md) - High-level summary (50-80 lines)
+ * - User story files (us-###.md) - Detailed requirements (80-120 lines each)
+ * - Links to tasks.md for implementation details
+ */
+async function hierarchicalDistribution(incrementId) {
     try {
         // Dynamic import to avoid circular dependencies
-        const { syncIncrement } = await import('../../../../src/core/living-docs/index.js');
-        console.log('   📖 Parsing and classifying spec sections...');
-        const result = await syncIncrement(incrementId, {
-            verbose: false, // We'll log our own summary
-            dryRun: false,
-            parser: {
-                preserveCodeBlocks: true,
-                preserveLinks: true,
-                preserveImages: true,
-            },
-            distributor: {
-                generateFrontmatter: true,
-                preserveOriginal: config.livingDocs?.intelligent?.preserveOriginal ?? true,
-            },
-            linker: {
-                generateBacklinks: config.livingDocs?.intelligent?.generateCrossLinks ?? true,
-                updateExisting: true,
-            },
+        const { SpecDistributor } = await import('../../../../src/core/living-docs/index.js');
+        console.log('   📊 Parsing and distributing spec into hierarchical structure...');
+        const projectRoot = process.cwd();
+        const distributor = new SpecDistributor(projectRoot, {
+            overwriteExisting: false,
+            createBackups: true,
         });
+        const result = await distributor.distribute(incrementId);
+        if (!result.success) {
+            console.error(`   ❌ Distribution failed with errors:`);
+            for (const error of result.errors) {
+                console.error(`      - ${error}`);
+            }
+            return { success: false, changedFiles: [] };
+        }
         // Log summary
-        console.log(`   ✅ Intelligent sync complete:`);
-        console.log(`      Project: ${result.project.name} (${(result.project.confidence * 100).toFixed(0)}% confidence)`);
-        console.log(`      Files created: ${result.distribution.summary.filesCreated}`);
-        console.log(`      Files updated: ${result.distribution.summary.filesUpdated}`);
-        console.log(`      Cross-links: ${result.links.length}`);
-        console.log(`      Duration: ${result.duration}ms`);
+        console.log(`   ✅ Hierarchical distribution complete:`);
+        console.log(`      Epic ID: ${result.specId}`);
+        console.log(`      User Stories: ${result.totalStories}`);
+        console.log(`      Files created: ${result.totalFiles}`);
+        console.log(`      Epic: ${path.basename(result.epicPath)}`);
+        console.log(`      User story files: ${result.userStoryPaths.length}`);
+        if (result.warnings.length > 0) {
+            console.log(`   ⚠️  Warnings:`);
+            for (const warning of result.warnings) {
+                console.log(`      - ${warning}`);
+            }
+        }
         // Collect changed file paths
-        const changedFiles = [
-            ...result.distribution.created.map((f) => f.path),
-            ...result.distribution.updated.map((f) => f.path),
-        ];
+        const changedFiles = [result.epicPath, ...result.userStoryPaths];
         return {
-            success: result.success,
+            success: true,
             changedFiles,
         };
     }
     catch (error) {
-        console.error(`   ❌ Intelligent sync failed: ${error}`);
-        console.error('   Falling back to simple sync mode...');
+        console.error(`   ❌ Hierarchical distribution failed: ${error}`);
+        console.error(error.stack);
         // Fallback to simple mode
+        console.error('   Falling back to simple sync mode...');
         const copied = await copyIncrementSpecToLivingDocs(incrementId);
         return {
             success: copied,
@@ -132,10 +149,145 @@ async function intelligentSyncLivingDocs(incrementId, config) {
     }
 }
 /**
- * Copy increment spec to living docs (legacy/simple mode)
+ * Extract and merge living docs (v2.0 - NO DUPLICATION!)
+ *
+ * NEW ARCHITECTURE:
+ * - Living docs = Permanent EPIC (GitHub Project, Jira Epic, ADO Feature)
+ * - Increment spec = Temporary ITERATION (GitHub Issue, Jira Story, ADO User Story)
+ *
+ * What this does:
+ * 1. Parse increment spec (extract user stories ONLY)
+ * 2. Check if living docs spec exists
+ * 3. If exists: Merge new user stories (avoid duplicates)
+ * 4. If not: Create new living docs spec
+ * 5. Generate links to architecture/ADRs (NO duplication!)
+ * 6. Update implementation history
+ *
+ * What this DOESN'T do:
+ * - ❌ Copy architecture details (those live in architecture/)
+ * - ❌ Copy ADR content (those live in architecture/adr/)
+ * - ❌ Copy success metrics (those live in increment reports)
+ * - ❌ Copy future enhancements (those live in roadmap)
+ *
+ * Returns true if living docs updated, false if skipped
+ */
+async function extractAndMergeLivingDocs(incrementId) {
+    try {
+        // Import parser utilities
+        const { parseIncrementSpec, parseLivingDocsSpec, extractSpecId, mergeUserStories, generateRelatedDocsLinks, writeLivingDocsSpec, } = await import('../../../../src/utils/spec-parser.js');
+        const projectRoot = process.cwd();
+        const incrementSpecPath = path.join(projectRoot, '.specweave', 'increments', incrementId, 'spec.md');
+        // Check if increment spec exists
+        if (!fs.existsSync(incrementSpecPath)) {
+            console.log(`⚠️  Increment spec not found: ${incrementSpecPath}`);
+            return false;
+        }
+        console.log(`   📖 Parsing increment spec: ${incrementId}`);
+        // 1. Parse increment spec (extract user stories)
+        const incrementSpec = await parseIncrementSpec(incrementSpecPath);
+        if (incrementSpec.userStories.length === 0) {
+            console.log(`ℹ️  No user stories found in increment spec, skipping sync`);
+            return false;
+        }
+        console.log(`   ✅ Found ${incrementSpec.userStories.length} user stories in increment`);
+        // 2. Determine living docs spec ID
+        const specId = incrementSpec.implementsSpec || extractSpecId(incrementId);
+        const livingDocsDir = path.join(projectRoot, '.specweave', 'docs', 'internal', 'specs', 'default');
+        const livingDocsPath = path.join(livingDocsDir, `${specId}-${incrementId.replace(/^\d+-/, '')}.md`);
+        // 3. Check if living docs spec exists
+        const livingDocsExists = fs.existsSync(livingDocsPath);
+        if (livingDocsExists) {
+            console.log(`   📚 Living docs spec exists, merging user stories...`);
+            // MERGE MODE: Add new user stories to existing spec
+            const livingSpec = await parseLivingDocsSpec(livingDocsPath);
+            // Merge user stories (adds new, updates existing)
+            const mergedStories = mergeUserStories(livingSpec.userStories, incrementSpec.userStories, incrementId);
+            const newStoriesCount = mergedStories.length - livingSpec.userStories.length;
+            // Update implementation history
+            const existingEntry = livingSpec.implementationHistory.find(e => e.increment === incrementId);
+            if (!existingEntry) {
+                livingSpec.implementationHistory.push({
+                    increment: incrementId,
+                    stories: incrementSpec.userStories.map(s => s.id),
+                    status: 'complete',
+                    date: new Date().toISOString().split('T')[0],
+                });
+            }
+            else {
+                // Update existing entry
+                existingEntry.status = 'complete';
+                existingEntry.date = new Date().toISOString().split('T')[0];
+            }
+            // Update user stories
+            livingSpec.userStories = mergedStories;
+            // Update last_updated
+            livingSpec.lastUpdated = new Date().toISOString().split('T')[0];
+            // Write updated spec
+            await writeLivingDocsSpec(livingDocsPath, livingSpec);
+            console.log(`   ✅ Merged ${newStoriesCount} new user stories into living docs`);
+            console.log(`   ✅ Updated implementation history for ${incrementId}`);
+        }
+        else {
+            console.log(`   📝 Creating new living docs spec: ${specId}`);
+            // CREATE MODE: First increment for this spec
+            const relatedDocs = generateRelatedDocsLinks(incrementSpec, projectRoot);
+            const livingSpec = {
+                id: specId,
+                title: incrementSpec.title,
+                featureArea: extractFeatureArea(incrementSpec.title),
+                overview: incrementSpec.overview,
+                userStories: incrementSpec.userStories.map(story => ({
+                    ...story,
+                    implementedIn: incrementId,
+                    status: 'complete',
+                })),
+                implementationHistory: [
+                    {
+                        increment: incrementId,
+                        stories: incrementSpec.userStories.map(s => s.id),
+                        status: 'complete',
+                        date: new Date().toISOString().split('T')[0],
+                    },
+                ],
+                relatedDocs,
+                externalLinks: {},
+                priority: incrementSpec.priority,
+                status: 'active',
+                created: new Date().toISOString().split('T')[0],
+                lastUpdated: new Date().toISOString().split('T')[0],
+            };
+            // Ensure directory exists
+            await fs.ensureDir(livingDocsDir);
+            // Write new spec
+            await writeLivingDocsSpec(livingDocsPath, livingSpec);
+            console.log(`   ✅ Created new living docs spec: ${specId}`);
+            console.log(`   ✅ Added ${incrementSpec.userStories.length} user stories`);
+            console.log(`   ✅ Generated links to ${relatedDocs.architecture.length} architecture docs`);
+            console.log(`   ✅ Generated links to ${relatedDocs.adrs.length} ADRs`);
+        }
+        return true;
+    }
+    catch (error) {
+        console.error(`❌ Error extracting/merging living docs: ${error}`);
+        console.error(error.stack);
+        return false;
+    }
+}
+/**
+ * Extract feature area from title
+ */
+function extractFeatureArea(title) {
+    // Simple heuristic: Use title as feature area
+    // Can be customized later based on keywords
+    return title.replace(/^(Increment \d+:\s*)?/, '').trim();
+}
+/**
+ * Copy increment spec to living docs (DEPRECATED - use extractAndMergeLivingDocs instead)
  * Returns true if spec was copied, false if skipped
  */
 async function copyIncrementSpecToLivingDocs(incrementId) {
+    console.warn('⚠️  Using deprecated copyIncrementSpecToLivingDocs (simple mode)');
+    console.warn('   Consider enabling intelligent mode to avoid duplication');
     try {
         const incrementSpecPath = path.join(process.cwd(), '.specweave', 'increments', incrementId, 'spec.md');
         const livingDocsPath = path.join(process.cwd(), '.specweave', 'docs', 'internal', 'specs', `spec-${incrementId}.md`);