specweave 0.12.7 → 0.13.0

package/dist/src/cli/commands/init.js

@@ -0,0 +1,1444 @@
+import fs from 'fs-extra';
+import * as path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { execFileNoThrowSync } from '../../utils/execFileNoThrow.js';
+import { detectClaudeCli, getClaudeCliDiagnostic, getClaudeCliSuggestions } from '../../utils/claude-cli-detector.js';
+import { AdapterLoader } from '../../adapters/adapter-loader.js';
+import { ClaudeMdGenerator } from '../../adapters/claude-md-generator.js';
+import { AgentsMdGenerator } from '../../adapters/agents-md-generator.js';
+import { getDirname } from '../../utils/esm-helpers.js';
+import { LanguageManager, isLanguageSupported, getSupportedLanguages, getSystemPromptForLanguage } from '../../core/i18n/language-manager.js';
+import { getLocaleManager } from '../../core/i18n/locale-manager.js';
+const __dirname = getDirname(import.meta.url);
+/**
+ * Detect if we're in the SpecWeave framework repository itself
+ * (development mode vs. user project mode)
+ *
+ * @param targetDir - Directory to check
+ * @returns true if this is the SpecWeave framework repo
+ */
+async function isSpecWeaveFrameworkRepo(targetDir) {
+    try {
+        const packageJsonPath = path.join(targetDir, 'package.json');
+        if (!fs.existsSync(packageJsonPath)) {
+            return false;
+        }
+        const packageJson = await fs.readJson(packageJsonPath);
+        // Check if this is the specweave package itself
+        return packageJson.name === 'specweave';
+    }
+    catch (error) {
+        return false;
+    }
+}
+export async function initCommand(projectName, options = {}) {
+    // Validate and normalize language option
+    const language = options.language?.toLowerCase() || 'en';
+    // Validate language if provided
+    if (options.language && !isLanguageSupported(language)) {
+        const locale = getLocaleManager('en'); // Use English for error messages about invalid language
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.invalidLanguage', { language: options.language })}`));
+        console.error(chalk.yellow(`${locale.t('cli', 'init.errors.supportedLanguages', { languages: getSupportedLanguages().join(', ') })}\n`));
+        process.exit(1);
+    }
+    // Initialize LanguageManager and LocaleManager
+    const i18n = new LanguageManager({ defaultLanguage: language });
+    const locale = getLocaleManager(language);
+    // Display welcome message in user's language
+    console.log(chalk.blue.bold(`\n${locale.t('cli', 'init.welcome')}\n`));
+    let targetDir;
+    let finalProjectName;
+    let usedDotNotation = false;
+    let continueExisting = false; // Track if user chose to continue with existing project
+    // Handle "." for current directory initialization
+    if (projectName === '.') {
+        usedDotNotation = true;
+        targetDir = process.cwd();
+        const dirName = path.basename(targetDir);
+        // Validate directory name is suitable for project name
+        if (!/^[a-z0-9-]+$/.test(dirName)) {
+            console.log(chalk.yellow(`\n${locale.t('cli', 'init.warnings.invalidDirName', { dirName })}`));
+            const suggestedName = dirName.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+            const { name } = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'name',
+                    message: 'Project name (for templates):',
+                    default: suggestedName,
+                    validate: (input) => {
+                        if (/^[a-z0-9-]+$/.test(input))
+                            return true;
+                        return 'Project name must be lowercase letters, numbers, and hyphens only';
+                    },
+                },
+            ]);
+            finalProjectName = name;
+        }
+        else {
+            finalProjectName = dirName;
+        }
+        // Safety: Warn if directory is not empty
+        const allFiles = fs.readdirSync(targetDir);
+        const existingFiles = allFiles.filter(f => !f.startsWith('.')); // Ignore hidden files
+        if (existingFiles.length > 0) {
+            console.log(chalk.yellow(`\n${locale.t('cli', 'init.warnings.directoryNotEmpty', { count: existingFiles.length, plural: existingFiles.length === 1 ? '' : 's' })}`));
+            const { confirm } = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'confirm',
+                    message: 'Initialize SpecWeave in current directory?',
+                    default: false,
+                },
+            ]);
+            if (!confirm) {
+                console.log(chalk.yellow(locale.t('cli', 'init.errors.cancelled')));
+                process.exit(0);
+            }
+        }
+        // Check if .specweave already exists - SMART RE-INITIALIZATION
+        if (fs.existsSync(path.join(targetDir, '.specweave'))) {
+            console.log(chalk.blue('\n📦 Existing SpecWeave project detected!'));
+            console.log(chalk.gray('   Found .specweave/ folder with your increments, docs, and configuration.\n'));
+            const { action } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'action',
+                    message: 'What would you like to do?',
+                    choices: [
+                        {
+                            name: '✨ Continue working (keep all existing increments, docs, and history)',
+                            value: 'continue',
+                            short: 'Continue'
+                        },
+                        {
+                            name: '🔄 Fresh start (delete .specweave/ and start from scratch)',
+                            value: 'fresh',
+                            short: 'Fresh start'
+                        },
+                        {
+                            name: '❌ Cancel (exit without changes)',
+                            value: 'cancel',
+                            short: 'Cancel'
+                        }
+                    ],
+                    default: 'continue'
+                },
+            ]);
+            if (action === 'cancel') {
+                console.log(chalk.yellow('\n⏸️  Initialization cancelled. No changes made.'));
+                process.exit(0);
+            }
+            if (action === 'fresh') {
+                console.log(chalk.yellow('\n⚠️  WARNING: This will DELETE all increments, docs, and configuration!'));
+                const { confirmFresh } = await inquirer.prompt([
+                    {
+                        type: 'confirm',
+                        name: 'confirmFresh',
+                        message: 'Are you sure you want to start fresh? (all .specweave/ content will be lost)',
+                        default: false,
+                    },
+                ]);
+                if (!confirmFresh) {
+                    console.log(chalk.yellow('\n⏸️  Fresh start cancelled. No changes made.'));
+                    process.exit(0);
+                }
+                // Delete .specweave/ and .claude/ for fresh start
+                fs.removeSync(path.join(targetDir, '.specweave'));
+                console.log(chalk.blue('   ♻️  Removed .specweave/ (fresh start)'));
+                if (fs.existsSync(path.join(targetDir, '.claude'))) {
+                    fs.removeSync(path.join(targetDir, '.claude'));
+                    console.log(chalk.blue('   ♻️  Removed .claude/ (will recreate with marketplace settings)'));
+                }
+                console.log(chalk.green('   ✅ Starting fresh - will create new .specweave/ structure\n'));
+            }
+            else {
+                // Continue working - keep everything, just refresh config if needed
+                continueExisting = true;
+                console.log(chalk.green('\n✅ Continuing with existing project'));
+                console.log(chalk.gray('   → Keeping all increments, docs, and history'));
+                console.log(chalk.gray('   → Will refresh .claude/settings.json (marketplace registration)'));
+                console.log(chalk.gray('   → Config will be updated if needed\n'));
+                // Refresh .claude/settings.json (marketplace registration)
+                // This ensures marketplace is always up-to-date even when continuing
+                if (!fs.existsSync(path.join(targetDir, '.claude'))) {
+                    fs.mkdirSync(path.join(targetDir, '.claude'), { recursive: true });
+                }
+            }
+        }
+    }
+    else {
+        // Original behavior: create subdirectory
+        // 1. Get project name if not provided
+        if (!projectName) {
+            const answers = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'projectName',
+                    message: 'Project name:',
+                    default: 'my-saas',
+                    validate: (input) => {
+                        if (/^[a-z0-9-]+$/.test(input))
+                            return true;
+                        return 'Project name must be lowercase letters, numbers, and hyphens only';
+                    },
+                },
+            ]);
+            projectName = answers.projectName;
+        }
+        targetDir = path.resolve(process.cwd(), projectName);
+        finalProjectName = projectName;
+        // 2. Check if directory exists
+        if (fs.existsSync(targetDir)) {
+            // Brownfield-safe: Check what's in the directory
+            const allFiles = fs.readdirSync(targetDir);
+            const existingFiles = allFiles.filter(f => !f.startsWith('.')); // Ignore hidden files
+            const hasSpecweave = fs.existsSync(path.join(targetDir, '.specweave'));
+            if (existingFiles.length > 0 || hasSpecweave) {
+                console.log(chalk.yellow(`\nDirectory ${projectName} exists with ${existingFiles.length} file(s).`));
+                if (hasSpecweave) {
+                    // SMART RE-INITIALIZATION (same as current directory case)
+                    console.log(chalk.blue('\n📦 Existing SpecWeave project detected!'));
+                    console.log(chalk.gray('   Found .specweave/ folder with your increments, docs, and configuration.\n'));
+                    const { action } = await inquirer.prompt([
+                        {
+                            type: 'list',
+                            name: 'action',
+                            message: 'What would you like to do?',
+                            choices: [
+                                {
+                                    name: '✨ Continue working (keep all existing increments, docs, and history)',
+                                    value: 'continue',
+                                    short: 'Continue'
+                                },
+                                {
+                                    name: '🔄 Fresh start (delete .specweave/ and start from scratch)',
+                                    value: 'fresh',
+                                    short: 'Fresh start'
+                                },
+                                {
+                                    name: '❌ Cancel (exit without changes)',
+                                    value: 'cancel',
+                                    short: 'Cancel'
+                                }
+                            ],
+                            default: 'continue'
+                        },
+                    ]);
+                    if (action === 'cancel') {
+                        console.log(chalk.yellow('\n⏸️  Initialization cancelled. No changes made.'));
+                        process.exit(0);
+                    }
+                    if (action === 'fresh') {
+                        console.log(chalk.yellow('\n⚠️  WARNING: This will DELETE all increments, docs, and configuration!'));
+                        const { confirmFresh } = await inquirer.prompt([
+                            {
+                                type: 'confirm',
+                                name: 'confirmFresh',
+                                message: 'Are you sure you want to start fresh? (all .specweave/ content will be lost)',
+                                default: false,
+                            },
+                        ]);
+                        if (!confirmFresh) {
+                            console.log(chalk.yellow('\n⏸️  Fresh start cancelled. No changes made.'));
+                            process.exit(0);
+                        }
+                        // Delete .specweave/ and .claude/ for fresh start
+                        fs.removeSync(path.join(targetDir, '.specweave'));
+                        console.log(chalk.blue('   ♻️  Removed .specweave/ (fresh start)'));
+                        if (fs.existsSync(path.join(targetDir, '.claude'))) {
+                            fs.removeSync(path.join(targetDir, '.claude'));
+                            console.log(chalk.blue('   ♻️  Removed .claude/ (will recreate with marketplace settings)'));
+                        }
+                        console.log(chalk.green('   ✅ Starting fresh - will create new .specweave/ structure\n'));
+                    }
+                    else {
+                        // Continue working - keep everything, just refresh config if needed
+                        continueExisting = true;
+                        console.log(chalk.green('\n✅ Continuing with existing project'));
+                        console.log(chalk.gray('   → Keeping all increments, docs, and history'));
+                        console.log(chalk.gray('   → Will refresh .claude/settings.json (marketplace registration)'));
+                        console.log(chalk.gray('   → Config will be updated if needed\n'));
+                        // Refresh .claude/settings.json (marketplace registration)
+                        if (!fs.existsSync(path.join(targetDir, '.claude'))) {
+                            fs.mkdirSync(path.join(targetDir, '.claude'), { recursive: true });
+                        }
+                    }
+                }
+                else {
+                    // No .specweave/ folder, just brownfield directory with files
+                    const { initExisting } = await inquirer.prompt([
+                        {
+                            type: 'confirm',
+                            name: 'initExisting',
+                            message: 'Initialize SpecWeave in existing directory (non-destructive)?',
+                            default: false,
+                        },
+                    ]);
+                    if (!initExisting) {
+                        console.log(chalk.yellow(locale.t('cli', 'init.errors.cancelled')));
+                        process.exit(0);
+                    }
+                    console.log(chalk.green('   ✅ Initializing in existing directory (brownfield-safe)\n'));
+                }
+            }
+        }
+        else {
+            fs.mkdirSync(targetDir, { recursive: true });
+        }
+    }
+    // 3. Check for nested .specweave/ (CRITICAL: prevent nested folders)
+    const parentSpecweaveFolders = detectNestedSpecweave(targetDir);
+    if (parentSpecweaveFolders && parentSpecweaveFolders.length > 0) {
+        console.log('');
+        console.log(chalk.red.bold(locale.t('cli', 'init.errors.nestedNotSupported')));
+        console.log('');
+        // Show all found .specweave/ folders
+        if (parentSpecweaveFolders.length === 1) {
+            console.log(chalk.yellow(`   ${locale.t('cli', 'init.errors.parentFound')}`));
+            console.log(chalk.white(`   ${parentSpecweaveFolders[0].path}`));
+        }
+        else {
+            console.log(chalk.yellow(`   Found ${parentSpecweaveFolders.length} parent .specweave/ folders:`));
+            console.log('');
+            // Sort by depth (closest first)
+            const sortedFolders = [...parentSpecweaveFolders].sort((a, b) => a.depth - b.depth);
+            sortedFolders.forEach((folder, index) => {
+                const marker = index === 0 ? chalk.green('✓ CLOSEST') : chalk.gray(`  ${folder.depth} level${folder.depth > 1 ? 's' : ''} up`);
+                console.log(`   ${marker}: ${chalk.white(folder.path)}`);
+            });
+        }
+        console.log('');
+        console.log(chalk.cyan(`   ${locale.t('cli', 'init.info.nestedEnforcement')}`));
+        console.log(chalk.gray(`   ${locale.t('cli', 'init.info.nestedBullet1')}`));
+        console.log(chalk.gray(`   ${locale.t('cli', 'init.info.nestedBullet2')}`));
+        console.log(chalk.gray(`   ${locale.t('cli', 'init.info.nestedBullet3')}`));
+        console.log('');
+        // Suggest using the CLOSEST folder (most relevant)
+        const closestFolder = parentSpecweaveFolders.reduce((closest, current) => current.depth < closest.depth ? current : closest);
+        console.log(chalk.cyan(`   ${locale.t('cli', 'init.info.nestedToFix')}`));
+        console.log(chalk.green.bold(`   Recommended: Use the CLOSEST .specweave/ folder`));
+        console.log(chalk.white(`   ${locale.t('cli', 'init.nestedCdCommand', { path: closestFolder.path })}`));
+        console.log(chalk.white(`   ${locale.t('cli', 'init.nestedIncCommand')}`));
+        console.log('');
+        // Provide cleanup option if user has multiple unnecessary folders
+        if (parentSpecweaveFolders.length > 1) {
+            console.log(chalk.yellow.bold(`   💡 Tip: Multiple .specweave/ folders detected`));
+            console.log(chalk.gray(`   If some are unnecessary, consider removing them:`));
+            console.log('');
+            parentSpecweaveFolders.forEach(folder => {
+                console.log(chalk.gray(`   rm -rf "${folder.path}/.specweave"  # Remove if not needed`));
+            });
+            console.log('');
+        }
+        process.exit(1);
+    }
+    const spinner = ora('Creating SpecWeave project...').start();
+    try {
+        // 4. Detect or select tool
+        const adapterLoader = new AdapterLoader();
+        let toolName;
+        if (options.adapter) {
+            // User explicitly chose a tool via --adapter flag
+            toolName = options.adapter;
+            spinner.text = `Using ${toolName}...`;
+        }
+        else {
+            // SMART CHECK: If continuing existing project, read existing adapter from config
+            let existingAdapter = null;
+            if (continueExisting) {
+                const existingConfigPath = path.join(targetDir, '.specweave', 'config.json');
+                if (fs.existsSync(existingConfigPath)) {
+                    try {
+                        const existingConfig = fs.readJsonSync(existingConfigPath);
+                        existingAdapter = existingConfig?.adapters?.default || null;
+                    }
+                    catch (error) {
+                        // Invalid config, will proceed with detection
+                    }
+                }
+            }
+            // Detect tool and always ask user (even if matches existing config)
+            const detectedTool = await adapterLoader.detectTool();
+            spinner.stop();
+            console.log('');
+            console.log(chalk.cyan(`🔍 ${locale.t('cli', 'init.toolDetection.header')}`));
+            // Show existing adapter if present
+            if (existingAdapter) {
+                console.log(chalk.blue(`   📋 Current adapter: ${existingAdapter}`));
+                if (existingAdapter === detectedTool) {
+                    console.log(chalk.gray(`   Detected tool matches current config`));
+                }
+                else {
+                    console.log(chalk.yellow(`   ⚠️  Detected tool (${detectedTool}) differs from config`));
+                }
+            }
+            else {
+                // No existing adapter (new project)
+                if (detectedTool === 'claude') {
+                    console.log(chalk.gray(`   Recommended: ${detectedTool} (no other tool detected)`));
+                }
+                else {
+                    console.log(chalk.gray(`   ${locale.t('cli', 'init.toolDetection.detected', { tool: detectedTool })}`));
+                }
+            }
+            console.log('');
+            // Check if running in CI/non-interactive environment
+            const isCI = process.env.CI === 'true' ||
+                process.env.GITHUB_ACTIONS === 'true' ||
+                process.env.GITLAB_CI === 'true' ||
+                process.env.CIRCLECI === 'true' ||
+                !process.stdin.isTTY;
+            let confirmTool = true; // Default to yes
+            if (isCI) {
+                // In CI, automatically use detected tool without prompting
+                console.log(chalk.gray(`   ${locale.t('cli', 'init.toolDetection.ciAutoConfirm', { tool: detectedTool })}`));
+                toolName = detectedTool;
+            }
+            else {
+                // Interactive mode - ask for confirmation
+                const response = await inquirer.prompt([
+                    {
+                        type: 'confirm',
+                        name: 'confirmTool',
+                        message: locale.t('cli', 'init.toolDetection.confirmPrompt', { tool: detectedTool }),
+                        default: true
+                    }
+                ]);
+                confirmTool = response.confirmTool;
+            }
+            if (!confirmTool) {
+                // Let user choose from available tools
+                const { selectedTool } = await inquirer.prompt([
+                    {
+                        type: 'list',
+                        name: 'selectedTool',
+                        message: locale.t('cli', 'init.toolDetection.selectPrompt'),
+                        choices: [
+                            { name: `Claude Code (Recommended - Full automation)`, value: 'claude' },
+                            { name: 'Cursor (Partial - AGENTS.md compilation, team commands, less reliable)', value: 'cursor' },
+                            { name: 'Other (Copilot, ChatGPT, Gemini - Limited: no hooks, manual workflow, high context usage)', value: 'generic' }
+                        ]
+                    }
+                ]);
+                toolName = selectedTool;
+            }
+            else {
+                // User confirmed detected tool
+                toolName = detectedTool;
+            }
+            spinner.start(`Using ${toolName}...`);
+        }
+        // 4. Create directory structure (adapter-specific)
+        // Skip if continuing with existing project (directories already exist)
+        if (!continueExisting) {
+            createDirectoryStructure(targetDir, toolName);
+            spinner.text = 'Directory structure created...';
+        }
+        else {
+            spinner.text = 'Using existing directory structure...';
+        }
+        // 5. Configure GitHub marketplace for Claude Code
+        // ✅ NEW APPROACH: Claude Code fetches plugins from GitHub (no local copying!)
+        if (toolName === 'claude') {
+            try {
+                spinner.text = 'Configuring GitHub marketplace...';
+                // Settings.json will be created by setupClaudePluginAutoRegistration()
+                // No need to copy marketplace or plugins - everything is fetched from GitHub
+                spinner.succeed('GitHub marketplace configured');
+                console.log(chalk.gray(`   ✓ Marketplace: github.com/anton-abyzov/specweave/.claude-plugin`));
+                console.log(chalk.gray(`   ✓ Plugins fetch on-demand (no local copies = faster init)`));
+            }
+            catch (error) {
+                // Log errors in debug mode for troubleshooting
+                if (process.env.DEBUG) {
+                    spinner.stop();
+                    console.error(chalk.red(`\n❌ Marketplace setup error: ${error instanceof Error ? error.message : String(error)}`));
+                    if (error instanceof Error && error.stack) {
+                        console.error(chalk.gray(error.stack));
+                    }
+                    spinner.start();
+                }
+                console.warn(chalk.yellow(`\n${locale.t('cli', 'init.warnings.marketplaceCopyFailed')}`));
+            }
+        }
+        // 6. Copy base templates (config, README, CLAUDE.md - same for all)
+        // Skip if continuing with existing project (files already exist)
+        if (!continueExisting) {
+            const templatesDir = findSourceDir('templates');
+            await copyTemplates(templatesDir, targetDir, finalProjectName, language);
+            spinner.text = 'Base templates copied...';
+        }
+        else {
+            spinner.text = 'Skipping template copying (using existing files)...';
+        }
+        // 6. Install based on tool
+        if (toolName === 'claude') {
+            // DEFAULT: Native Claude Code plugins (installed globally via /plugin install)
+            // No per-project copying needed - plugins work across all projects!
+            spinner.text = 'Configuring for Claude Code...';
+            console.log(`\n${locale.t('cli', 'init.claudeNativeComplete')}`);
+            console.log(`   ${locale.t('cli', 'init.claudeNativeBenefits')}`);
+        }
+        else {
+            // Use adapter for non-Claude tools
+            spinner.text = `Installing ${toolName} adapter...`;
+            const adapter = adapterLoader.getAdapter(toolName);
+            if (!adapter) {
+                throw new Error(`Adapter not found: ${toolName}`);
+            }
+            await adapterLoader.checkRequirements(toolName);
+            await adapter.install({
+                projectPath: targetDir,
+                projectName: finalProjectName,
+                techStack: options.techStack ? { language: options.techStack } : undefined,
+                docsApproach: 'incremental'
+            });
+            // 6. Copy plugins/ folder for non-Claude adapters
+            // CRITICAL: Copilot/Cursor/Generic need local plugins/ folder!
+            // AGENTS.md instructs AI to read plugins/specweave/commands/*.md
+            // Without this folder, those commands don't exist in the project!
+            if (toolName !== 'claude') {
+                spinner.start('Copying plugins folder for command execution...');
+                try {
+                    const specweavePackageRoot = findPackageRoot(__dirname);
+                    if (specweavePackageRoot) {
+                        const sourcePluginsDir = path.join(specweavePackageRoot, 'plugins');
+                        const targetPluginsDir = path.join(targetDir, 'plugins');
+                        if (fs.existsSync(sourcePluginsDir)) {
+                            // Copy entire plugins/ folder from SpecWeave package to user project
+                            fs.copySync(sourcePluginsDir, targetPluginsDir, {
+                                overwrite: true,
+                                filter: (src) => {
+                                    // Exclude .DS_Store and other hidden files
+                                    const basename = path.basename(src);
+                                    return !basename.startsWith('.');
+                                }
+                            });
+                            spinner.succeed('Plugins folder copied successfully');
+                            console.log(chalk.green('   ✔ AI can now execute SpecWeave commands'));
+                            console.log(chalk.gray('   → Copilot/Cursor will read plugins/specweave/commands/*.md'));
+                        }
+                        else {
+                            spinner.warn('Could not find plugins/ in SpecWeave package');
+                            console.log(chalk.yellow('   → Command execution may not work without plugins/ folder'));
+                        }
+                    }
+                    else {
+                        spinner.warn('Could not locate SpecWeave package');
+                        console.log(chalk.yellow('   → Skipping plugins/ folder copy'));
+                    }
+                }
+                catch (error) {
+                    spinner.warn('Could not copy plugins folder');
+                    console.log(chalk.yellow(`   ${error instanceof Error ? error.message : error}`));
+                }
+            }
+            // 7. Install core plugin for non-Claude adapters
+            // CRITICAL: Cursor/Copilot/Generic need plugin files in project!
+            // Claude uses plugin system (global), but others need local files for AGENTS.md/instructions.md
+            try {
+                spinner.start('Installing SpecWeave core plugin...');
+                // Load core plugin from plugins/specweave/
+                const corePluginPath = findSourceDir('plugins/specweave');
+                const { PluginLoader } = await import('../../core/plugin-loader.js');
+                const loader = new PluginLoader();
+                const corePlugin = await loader.loadFromDirectory(corePluginPath);
+                // Compile for adapter (Cursor → AGENTS.md, Copilot → instructions.md, etc.)
+                if (adapter.supportsPlugins()) {
+                    await adapter.compilePlugin(corePlugin);
+                    spinner.succeed('SpecWeave core plugin installed');
+                    console.log(chalk.green('   ✔ Skills, agents, commands added to project'));
+                    console.log(chalk.gray(`   → ${corePlugin.skills.length} skills, ${corePlugin.agents.length} agents, ${corePlugin.commands.length} commands`));
+                }
+                else {
+                    spinner.warn('Adapter does not support plugins');
+                    console.log(chalk.yellow('   → Core functionality may be limited'));
+                }
+            }
+            catch (error) {
+                spinner.warn('Could not install core plugin');
+                console.log(chalk.yellow(`   ${error instanceof Error ? error.message : error}`));
+                console.log(chalk.gray('   → You can manually reference plugin files if needed'));
+            }
+        }
+        // 9. Initialize git (skip if .git already exists)
+        const gitDir = path.join(targetDir, '.git');
+        if (!fs.existsSync(gitDir)) {
+            // Use secure command execution for git commands
+            const gitInitResult = execFileNoThrowSync('git', ['init'], { cwd: targetDir, shell: false });
+            if (gitInitResult.success) {
+                spinner.text = 'Git repository initialized...';
+            }
+            else {
+                spinner.warn('Git initialization skipped (git not found)');
+            }
+            // 10. Create initial commit (if git init succeeded)
+            if (gitInitResult.success) {
+                const gitAddResult = execFileNoThrowSync('git', ['add', '.'], { cwd: targetDir, shell: false });
+                if (gitAddResult.success) {
+                    const gitCommitResult = execFileNoThrowSync('git', [
+                        'commit',
+                        '-m',
+                        'Initial commit with SpecWeave'
+                    ], { cwd: targetDir, shell: false });
+                    if (gitCommitResult.success) {
+                        spinner.text = 'Initial commit created...';
+                    }
+                    // Git commit might fail if no user configured - that's ok, no need to warn
+                }
+            }
+        }
+        else {
+            spinner.text = 'Using existing Git repository...';
+        }
+        spinner.succeed('SpecWeave project created successfully!');
+        // 11. Show tool-specific next steps
+        if (toolName !== 'claude') {
+            const adapter = adapterLoader.getAdapter(toolName);
+            if (adapter) {
+                await adapter.postInstall({
+                    projectPath: targetDir,
+                    projectName: finalProjectName,
+                    techStack: options.techStack ? { language: options.techStack } : undefined,
+                    docsApproach: 'incremental'
+                });
+            }
+        }
+        // 13. Create config.json with language setting
+        createConfigFile(targetDir, finalProjectName, toolName, language, false);
+        // 14. Setup Claude Code plugin auto-registration (if Claude detected)
+        let autoInstallSucceeded = false;
+        if (toolName === 'claude') {
+            try {
+                setupClaudePluginAutoRegistration(targetDir, language);
+            }
+            catch (error) {
+                // Non-critical - show manual instructions in next steps
+                console.warn(chalk.yellow(`\n${locale.t('cli', 'init.warnings.pluginAutoSetupFailed')}`));
+            }
+            // 15. AUTO-INSTALL ALL PLUGINS via Claude CLI (Breaking Change: No selective loading)
+            // Pre-flight check: Is Claude CLI available? (ROBUST CHECK)
+            const claudeStatus = detectClaudeCli();
+            if (!claudeStatus.available) {
+                // Claude CLI NOT working → explain clearly with actionable diagnostics
+                const diagnostic = getClaudeCliDiagnostic(claudeStatus);
+                const suggestions = getClaudeCliSuggestions(claudeStatus);
+                spinner.warn(diagnostic);
+                console.log('');
+                console.log(chalk.yellow.bold('⚠️  Claude Code CLI Issue Detected'));
+                console.log('');
+                // Show detailed diagnostic info with MORE context
+                if (claudeStatus.commandExists) {
+                    console.log(chalk.white('Found command in PATH, but verification failed:'));
+                    console.log('');
+                    if (claudeStatus.commandPath) {
+                        console.log(chalk.gray(`   Path: ${claudeStatus.commandPath}`));
+                    }
+                    if (claudeStatus.exitCode !== undefined) {
+                        console.log(chalk.gray(`   Exit code: ${claudeStatus.exitCode}`));
+                    }
+                    console.log(chalk.gray(`   Issue: ${claudeStatus.error}`));
+                    console.log('');
+                    // Explain what this likely means
+                    if (claudeStatus.error === 'version_check_failed') {
+                        console.log(chalk.yellow('⚠️  This likely means:'));
+                        console.log(chalk.gray('   • You have a DIFFERENT tool named "claude" in PATH'));
+                        console.log(chalk.gray('   • It\'s not the Claude Code CLI from Anthropic'));
+                        console.log(chalk.gray('   • The command exists but doesn\'t respond to --version'));
+                    }
+                }
+                else {
+                    console.log(chalk.white('Claude CLI not found in PATH'));
+                }
+                console.log('');
+                // Show actionable suggestions
+                console.log(chalk.cyan('💡 How to fix:'));
+                console.log('');
+                suggestions.forEach(suggestion => {
+                    console.log(chalk.gray(`   ${suggestion}`));
+                });
+                console.log('');
+                // Only show alternatives if user is NOT using Claude already
+                if (claudeStatus.error === 'command_not_found') {
+                    console.log(chalk.cyan('Alternative Options:'));
+                    console.log('');
+                    console.log(chalk.white('1️⃣  Use Claude Code IDE (no CLI needed):'));
+                    console.log(chalk.gray('   → Open this project in Claude Code'));
+                    console.log(chalk.gray('   → Run: /plugin install specweave'));
+                    console.log(chalk.gray('   → Works immediately, no npm installation!'));
+                    console.log('');
+                    console.log(chalk.white('2️⃣  Use Different AI Tool:'));
+                    console.log(chalk.gray('   → Run: specweave init --adapter cursor'));
+                    console.log(chalk.gray('   → Works without Claude CLI'));
+                    console.log(chalk.gray('   → Less automation but no CLI dependency'));
+                    console.log('');
+                }
+                autoInstallSucceeded = false;
+            }
+            else {
+                // Claude CLI available → install ALL plugins from marketplace
+                try {
+                    // Step 1: FORCE marketplace refresh - remove and re-add from GitHub
+                    spinner.start('Refreshing SpecWeave marketplace...');
+                    const listResult = execFileNoThrowSync('claude', [
+                        'plugin',
+                        'marketplace',
+                        'list'
+                    ]);
+                    const marketplaceExists = listResult.success &&
+                        (listResult.stdout || '').toLowerCase().includes('specweave');
+                    if (marketplaceExists) {
+                        // Always remove existing marketplace to ensure fresh install
+                        execFileNoThrowSync('claude', [
+                            'plugin',
+                            'marketplace',
+                            'remove',
+                            'specweave'
+                        ]);
+                        console.log(chalk.blue('   🔄 Removed existing marketplace'));
+                    }
+                    // Add marketplace from GitHub (always fresh)
+                    const addResult = execFileNoThrowSync('claude', [
+                        'plugin',
+                        'marketplace',
+                        'add',
+                        'anton-abyzov/specweave'
+                    ]);
+                    if (!addResult.success) {
+                        throw new Error('Failed to add marketplace from GitHub');
+                    }
+                    console.log(chalk.green('   ✔ Marketplace registered from GitHub'));
+                    spinner.succeed('SpecWeave marketplace refreshed');
+                    // Step 2: Load marketplace.json to get ALL available plugins
+                    spinner.start('Loading available plugins...');
+                    const marketplaceJsonPath = findSourceDir('.claude-plugin/marketplace.json');
+                    if (!fs.existsSync(marketplaceJsonPath)) {
+                        throw new Error('marketplace.json not found - cannot determine plugins to install');
+                    }
+                    const marketplace = JSON.parse(fs.readFileSync(marketplaceJsonPath, 'utf-8'));
+                    const allPlugins = marketplace.plugins || [];
+                    if (allPlugins.length === 0) {
+                        throw new Error('No plugins found in marketplace.json');
+                    }
+                    console.log(chalk.blue(`   📦 Found ${allPlugins.length} plugins to install`));
+                    spinner.succeed(`Found ${allPlugins.length} plugins`);
+                    // Step 3: Install ALL plugins (no selective loading!)
+                    let successCount = 0;
+                    let failCount = 0;
+                    const failedPlugins = [];
+                    for (const plugin of allPlugins) {
+                        const pluginName = plugin.name;
+                        spinner.start(`Installing ${pluginName}...`);
+                        const installResult = execFileNoThrowSync('claude', [
+                            'plugin',
+                            'install',
+                            pluginName
+                        ]);
+                        if (installResult.success) {
+                            successCount++;
+                            spinner.succeed(`${pluginName} installed`);
+                        }
+                        else {
+                            failCount++;
+                            failedPlugins.push(pluginName);
+                            spinner.warn(`${pluginName} failed (will continue)`);
+                        }
+                    }
+                    // Step 4: Report results
+                    console.log('');
+                    console.log(chalk.green.bold(`✅ Plugin Installation Complete`));
+                    console.log(chalk.white(`   Installed: ${successCount}/${allPlugins.length} plugins`));
+                    if (failCount > 0) {
+                        console.log(chalk.yellow(`   Failed: ${failCount} plugins`));
+                        console.log(chalk.gray(`   Failed plugins: ${failedPlugins.join(', ')}`));
+                        console.log(chalk.gray(`   → You can install these manually later`));
+                    }
+                    console.log('');
+                    console.log(chalk.cyan('📋 Available capabilities:'));
+                    console.log(chalk.gray('   • /specweave:increment - Plan new features'));
+                    console.log(chalk.gray('   • /specweave:do - Execute tasks'));
+                    console.log(chalk.gray('   • /specweave-github:sync - GitHub integration'));
+                    console.log(chalk.gray('   • /specweave-jira:sync - JIRA integration'));
+                    console.log(chalk.gray('   • /specweave:docs preview - Documentation preview'));
+                    console.log(chalk.gray('   • ...and more!'));
+                    autoInstallSucceeded = successCount > 0;
+                }
+                catch (error) {
+                    // Installation failed - provide helpful diagnostics
+                    spinner.warn('Could not auto-install plugins');
+                    console.log('');
+                    // Diagnose error and provide actionable hints
+                    if (error.message.includes('not found') || error.message.includes('ENOENT')) {
+                        console.log(chalk.yellow('   Reason: Claude CLI found but command failed'));
+                        console.log(chalk.gray('   → Try manually: /plugin install specweave'));
+                    }
+                    else if (error.message.includes('EACCES') || error.message.includes('permission')) {
+                        console.log(chalk.yellow('   Reason: Permission denied'));
+                        console.log(chalk.gray('   → Check file permissions or run with appropriate access'));
+                    }
+                    else if (error.message.includes('ECONNREFUSED') || error.message.includes('network')) {
+                        console.log(chalk.yellow('   Reason: Network error'));
+                        console.log(chalk.gray('   → Check internet connection and try again'));
+                    }
+                    else if (process.env.DEBUG) {
+                        console.log(chalk.gray(`   Error: ${error.message}`));
+                    }
+                    console.log('');
+                    console.log(chalk.cyan('📦 Manual installation:'));
+                    console.log(chalk.white('   /plugin install specweave'));
+                    console.log(chalk.white('   /plugin install specweave-github'));
+                    console.log(chalk.white('   ...etc.'));
+                    console.log('');
+                    autoInstallSucceeded = false;
+                }
+            }
+            // 10.5 Issue Tracker Integration (CRITICAL!)
+            // MUST happen AFTER plugin installation is complete
+            // Asks user: Which tracker? (GitHub/Jira/ADO/None)
+            // Collects credentials and runs smart validation
+            //
+            // NEW: Always run for ALL projects (including framework repo)
+            // Detects existing config and asks user if they want to change it
+            const isFrameworkRepo = await isSpecWeaveFrameworkRepo(targetDir);
+            try {
+                const { setupIssueTracker } = await import('../helpers/issue-tracker/index.js');
+                // Check if sync config already exists
+                const configPath = path.join(targetDir, '.specweave', 'config.json');
+                let existingTracker = null;
+                if (fs.existsSync(configPath)) {
+                    const config = await fs.readJson(configPath);
+                    if (config.sync?.activeProfile && config.sync?.profiles) {
+                        const activeProfile = config.sync.profiles[config.sync.activeProfile];
+                        if (activeProfile?.provider) {
+                            existingTracker = activeProfile.provider;
+                        }
+                    }
+                }
+                if (existingTracker) {
+                    // Existing config detected - ask if user wants to reconfigure
+                    console.log(chalk.blue('\n🔍 Existing Issue Tracker Configuration Detected'));
+                    console.log(chalk.gray(`   Current: ${existingTracker.charAt(0).toUpperCase() + existingTracker.slice(1)}`));
+                    console.log('');
+                    const { reconfigure } = await inquirer.prompt([{
+                            type: 'confirm',
+                            name: 'reconfigure',
+                            message: 'Do you want to reconfigure your issue tracker?',
+                            default: false
+                        }]);
+                    if (!reconfigure) {
+                        console.log(chalk.gray('   ✓ Keeping existing configuration\n'));
+                    }
+                    else {
+                        // User wants to reconfigure - run setup
+                        await setupIssueTracker({
+                            projectPath: targetDir,
+                            language: language,
+                            maxRetries: 3,
+                            isFrameworkRepo
+                        });
+                    }
+                }
+                else {
+                    // No existing config - run setup
+                    if (isFrameworkRepo) {
+                        console.log(chalk.blue('\n🔍 Detected SpecWeave framework repository'));
+                        console.log(chalk.gray('   Recommended: Configure GitHub sync for automatic bidirectional sync'));
+                        console.log('');
+                    }
+                    await setupIssueTracker({
+                        projectPath: targetDir,
+                        language: language,
+                        maxRetries: 3,
+                        isFrameworkRepo
+                    });
+                }
+            }
+            catch (error) {
+                // Non-critical error - log but continue
+                if (process.env.DEBUG) {
+                    console.error(chalk.red(`\n❌ Issue tracker setup error: ${error.message}`));
+                }
+                console.log(chalk.yellow('\n⚠️  Issue tracker setup skipped (can configure later)'));
+            }
+        }
+        showNextSteps(finalProjectName, toolName, language, usedDotNotation, toolName === 'claude' ? autoInstallSucceeded : undefined);
+    }
+    catch (error) {
+        spinner.fail('Failed to create project');
+        console.error(chalk.red(`\n${locale.t('cli', 'init.genericError')}`), error);
+        process.exit(1);
+    }
+}
+function createDirectoryStructure(targetDir, adapterName) {
+    const directories = [
+        // Core increment structure
+        '.specweave/increments',
+        // 6-pillar documentation structure
+        '.specweave/docs/internal/strategy', // Business specs (WHAT, WHY)
+        '.specweave/docs/internal/specs', // Feature specifications (detailed requirements)
+        '.specweave/docs/internal/architecture', // Technical design (HOW)
+        '.specweave/docs/internal/architecture/adr', // Architecture Decision Records
+        '.specweave/docs/internal/architecture/diagrams', // Architecture diagrams
+        '.specweave/docs/internal/delivery', // Roadmap, CI/CD, guides
+        '.specweave/docs/internal/operations', // Runbooks, SLOs
+        '.specweave/docs/internal/governance', // Security, compliance
+        '.specweave/docs/public', // Published documentation
+    ];
+    // For Claude Code ONLY: Create .claude/ folder (for settings.json)
+    // Non-Claude adapters: NO .claude/ folder (they use plugins/ folder directly)
+    if (adapterName === 'claude') {
+        directories.push('.claude');
+    }
+    directories.forEach((dir) => {
+        fs.mkdirSync(path.join(targetDir, dir), { recursive: true });
+    });
+}
+async function copyTemplates(templatesDir, targetDir, projectName, language = 'en') {
+    const locale = getLocaleManager(language);
+    // Verify templates directory exists
+    if (!fs.existsSync(templatesDir)) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.templatesNotFound', { path: templatesDir })}`));
+        const packageRoot = findPackageRoot(__dirname);
+        if (packageRoot) {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.packageRoot', { root: packageRoot })}`));
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.tryingAlternate')}`));
+            // Try src/templates as fallback
+            const altPath = path.join(packageRoot, 'src', 'templates');
+            if (fs.existsSync(altPath)) {
+                console.error(chalk.yellow(`   ${locale.t('cli', 'init.errors.foundTemplatesAt', { path: altPath })}`));
+                templatesDir = altPath;
+            }
+            else {
+                throw new Error('Failed to locate templates directory');
+            }
+        }
+        else {
+            throw new Error('Failed to locate templates directory and package root');
+        }
+    }
+    // Copy README.md
+    const readmeTemplate = path.join(templatesDir, 'README.md.template');
+    if (fs.existsSync(readmeTemplate)) {
+        let readme = fs.readFileSync(readmeTemplate, 'utf-8');
+        readme = readme.replace(/{{PROJECT_NAME}}/g, projectName);
+        fs.writeFileSync(path.join(targetDir, 'README.md'), readme);
+    }
+    // Generate CLAUDE.md - PRIMARY instruction file for Claude Code
+    // CRITICAL: Claude Code ONLY reads CLAUDE.md (NOT AGENTS.md!)
+    // This is the native/baseline experience - skills, agents, hooks, slash commands
+    const skillsDir = findSourceDir('skills');
+    const agentsDir = findSourceDir('agents');
+    const commandsDir = findSourceDir('commands');
+    const claudeMdTemplatePath = path.normalize(path.join(templatesDir, 'CLAUDE.md.template'));
+    const claudeGen = new ClaudeMdGenerator(skillsDir, agentsDir, commandsDir);
+    const claudeMd = await claudeGen.generate({
+        projectName,
+        projectPath: targetDir,
+        templatePath: fs.existsSync(claudeMdTemplatePath) ? claudeMdTemplatePath : undefined
+    });
+    fs.writeFileSync(path.join(targetDir, 'CLAUDE.md'), claudeMd);
+    // Generate AGENTS.md - Universal file for ALL OTHER AI tools
+    // Following agents.md standard: https://agents.md/
+    // Used by: Cursor, Gemini CLI, Codex, GitHub Copilot, and ANY non-Claude tool
+    // NOTE: Claude Code does NOT read this file - it only reads CLAUDE.md above
+    // Replaces: .cursorrules, instructions.md, and other tool-specific files
+    const agentsMdTemplatePath = path.normalize(path.join(templatesDir, 'AGENTS.md.template'));
+    const agentsGen = new AgentsMdGenerator(skillsDir, agentsDir, commandsDir);
+    const agentsMd = await agentsGen.generate({
+        projectName,
+        projectPath: targetDir,
+        templatePath: fs.existsSync(agentsMdTemplatePath) ? agentsMdTemplatePath : undefined
+    });
+    fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), agentsMd);
+    // Copy .gitignore
+    const gitignoreTemplate = path.join(templatesDir, '.gitignore.template');
+    if (fs.existsSync(gitignoreTemplate)) {
+        fs.copyFileSync(gitignoreTemplate, path.join(targetDir, '.gitignore'));
+    }
+    // Copy .gitattributes (forces LF line endings on all platforms, prevents Windows CRLF warnings)
+    const gitattributesTemplate = path.join(templatesDir, '.gitattributes.template');
+    if (fs.existsSync(gitattributesTemplate)) {
+        fs.copyFileSync(gitattributesTemplate, path.join(targetDir, '.gitattributes'));
+    }
+}
+/**
+ * Detect ALL parent directories that contain .specweave/ folders
+ * SpecWeave ONLY supports root-level .specweave/ folders
+ * Nested .specweave/ folders are NOT supported
+ *
+ * @param targetDir - Directory where user wants to initialize
+ * @returns Array of paths to parent .specweave/ folders with depth info, or null if none found
+ */
+function detectNestedSpecweave(targetDir) {
+    const foundFolders = [];
+    // Start from parent of target directory
+    let currentDir = path.dirname(path.resolve(targetDir));
+    const root = path.parse(currentDir).root;
+    let depth = 1;
+    // Walk up the directory tree and find ALL .specweave/ folders
+    while (currentDir !== root) {
+        const specweavePath = path.join(currentDir, '.specweave');
+        // Check if .specweave/ exists at this level
+        if (fs.existsSync(specweavePath)) {
+            foundFolders.push({ path: currentDir, depth });
+        }
+        // Move up one level
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            break; // Reached root
+        currentDir = parentDir;
+        depth++;
+    }
+    return foundFolders.length > 0 ? foundFolders : null;
+}
+/**
+ * Find the package root by walking up the directory tree looking for package.json
+ * This works reliably on all platforms including Windows with UNC paths
+ */
+function findPackageRoot(startDir) {
+    let currentDir = startDir;
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const packageJsonPath = path.join(currentDir, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            try {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                // Verify this is the specweave package
+                if (packageJson.name === 'specweave') {
+                    return currentDir;
+                }
+            }
+            catch (error) {
+                // Not a valid package.json, continue searching
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            break; // Reached root
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Find the source directory, trying multiple possible locations
+ * Handles both development and installed package scenarios
+ * Windows-compatible with proper path normalization
+ */
+function findSourceDir(relativePath) {
+    // First, try to find package root by walking up from __dirname
+    const packageRoot = findPackageRoot(__dirname);
+    if (packageRoot) {
+        // Try directly in package root FIRST (for plugins/, .claude-plugin/)
+        // This is critical because package.json includes these folders for npm publish
+        const rootPath = path.normalize(path.join(packageRoot, relativePath));
+        if (fs.existsSync(rootPath)) {
+            return rootPath;
+        }
+        // Try src/ directory (for templates/, utils/, etc.)
+        const srcPath = path.normalize(path.join(packageRoot, 'src', relativePath));
+        if (fs.existsSync(srcPath)) {
+            return srcPath;
+        }
+        // Try dist/ directory (fallback for compiled outputs)
+        const distPath = path.normalize(path.join(packageRoot, 'dist', relativePath));
+        if (fs.existsSync(distPath)) {
+            return distPath;
+        }
+    }
+    // Fallback: Try multiple possible locations relative to __dirname
+    const possiblePaths = [
+        // Development: dist/cli/commands -> src/
+        path.normalize(path.join(__dirname, '../../..', relativePath)),
+        // Installed: node_modules/specweave/dist/cli/commands -> node_modules/specweave/src/
+        path.normalize(path.join(__dirname, '../../../src', relativePath)),
+        // Alternative: go up from dist/ to package root, then to src/
+        path.normalize(path.join(__dirname, '../../..', 'src', relativePath)),
+        // Absolute from package root (for global installs)
+        path.resolve(__dirname, '../../../src', relativePath),
+    ];
+    for (const testPath of possiblePaths) {
+        if (fs.existsSync(testPath)) {
+            return testPath;
+        }
+    }
+    // If nothing found, return the first path and let the caller handle the error
+    return possiblePaths[0];
+}
+function copyCommands(commandsDir, targetCommandsDir, language) {
+    const locale = getLocaleManager(language);
+    // v0.4.0+: Commands moved to plugins/specweave/commands/
+    const sourceDir = findSourceDir('plugins/specweave/commands');
+    if (!fs.existsSync(sourceDir)) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.sourceNotFound', { type: 'commands' })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.expectedAt', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.dirname', { path: __dirname })}`));
+        const packageRoot = findPackageRoot(__dirname);
+        if (packageRoot) {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.packageRoot', { root: packageRoot })}`));
+        }
+        else {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.couldNotFindRoot')}`));
+        }
+        throw new Error('Failed to locate source commands directory. This may be a Windows path resolution issue.');
+    }
+    // Validate source directory contains files
+    const sourceFiles = fs.readdirSync(sourceDir).filter(f => f.endsWith('.md'));
+    if (sourceFiles.length === 0) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.sourceEmpty', { type: 'commands' })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.directory', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.installationIssue')}`));
+        throw new Error('Source commands directory exists but contains no .md files');
+    }
+    try {
+        // Ensure target directory exists
+        fs.ensureDirSync(targetCommandsDir);
+        // Copy each command file and inject system prompts if needed
+        for (const file of sourceFiles) {
+            const sourcePath = path.join(sourceDir, file);
+            const targetPath = path.join(targetCommandsDir, file);
+            // Read, potentially inject, and write
+            const content = fs.readFileSync(sourcePath, 'utf-8');
+            const modifiedContent = language !== 'en'
+                ? injectSystemPromptForInit(content, language)
+                : content;
+            fs.writeFileSync(targetPath, modifiedContent, 'utf-8');
+        }
+        // Validate files were copied
+        const copiedFiles = fs.readdirSync(targetCommandsDir).filter(f => f.endsWith('.md'));
+        if (copiedFiles.length === 0) {
+            throw new Error(`Copy completed but no files found in target directory: ${targetCommandsDir}`);
+        }
+        console.log(chalk.gray(`   ${locale.t('cli', 'init.info.copiedFiles', { count: copiedFiles.length })}`));
+    }
+    catch (error) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.errorCopying', { type: 'commands', error: error.message })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.source', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.target', { path: targetCommandsDir })}`));
+        throw error;
+    }
+}
+function copyAgents(agentsDir, targetAgentsDir, language) {
+    const locale = getLocaleManager(language);
+    // v0.4.0+: Agents moved to plugins/specweave/agents/
+    const sourceDir = findSourceDir('plugins/specweave/agents');
+    if (!fs.existsSync(sourceDir)) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.sourceNotFound', { type: 'agents' })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.expectedAt', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.dirname', { path: __dirname })}`));
+        const packageRoot = findPackageRoot(__dirname);
+        if (packageRoot) {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.packageRoot', { root: packageRoot })}`));
+        }
+        else {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.couldNotFindRoot')}`));
+        }
+        throw new Error('Failed to locate source agents directory. This may be a Windows path resolution issue.');
+    }
+    // Validate source directory contains subdirectories with AGENT.md files
+    const agentDirs = fs.readdirSync(sourceDir, { withFileTypes: true })
+        .filter(dirent => dirent.isDirectory());
+    if (agentDirs.length === 0) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.sourceEmpty', { type: 'agents' })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.directory', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.installationIssue')}`));
+        throw new Error('Source agents directory exists but contains no agent subdirectories');
+    }
+    try {
+        // Ensure target directory exists
+        fs.ensureDirSync(targetAgentsDir);
+        // Copy each agent directory and inject system prompts if needed
+        for (const agentDir of agentDirs) {
+            const sourcePath = path.join(sourceDir, agentDir.name);
+            const targetPath = path.join(targetAgentsDir, agentDir.name);
+            // Copy entire agent directory first
+            fs.copySync(sourcePath, targetPath, {
+                overwrite: true,
+                errorOnExist: false
+            });
+            // Then inject system prompt into AGENT.md if language !== 'en'
+            if (language !== 'en') {
+                const agentMdPath = path.join(targetPath, 'AGENT.md');
+                if (fs.existsSync(agentMdPath)) {
+                    const content = fs.readFileSync(agentMdPath, 'utf-8');
+                    const modifiedContent = injectSystemPromptForInit(content, language);
+                    fs.writeFileSync(agentMdPath, modifiedContent, 'utf-8');
+                }
+            }
+        }
+        // Validate subdirectories were copied
+        const copiedDirs = fs.readdirSync(targetAgentsDir, { withFileTypes: true })
+            .filter(dirent => dirent.isDirectory());
+        if (copiedDirs.length === 0) {
+            throw new Error(`Copy completed but no agent directories found in target: ${targetAgentsDir}`);
+        }
+        console.log(chalk.gray(`   ${locale.t('cli', 'init.info.copiedAgents', { count: copiedDirs.length })}`));
+    }
+    catch (error) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.errorCopying', { type: 'agents', error: error.message })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.source', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.target', { path: targetAgentsDir })}`));
+        throw error;
+    }
+}
+/**
+ * Inject system prompt for non-English languages
+ */
+function injectSystemPromptForInit(content, language) {
+    if (language === 'en') {
+        return content; // No changes for English
+    }
+    const systemPrompt = getSystemPromptForLanguage(language);
+    // Inject after YAML frontmatter if present
+    if (content.startsWith('---')) {
+        const endOfFrontmatter = content.indexOf('---', 3);
+        if (endOfFrontmatter !== -1) {
+            const frontmatter = content.substring(0, endOfFrontmatter + 3);
+            const body = content.substring(endOfFrontmatter + 3);
+            return `${frontmatter}\n\n${systemPrompt}\n${body}`;
+        }
+    }
+    // No frontmatter - inject at the top
+    return `${systemPrompt}\n\n${content}`;
+}
+function copySkills(skillsDir, targetSkillsDir, language) {
+    const locale = getLocaleManager(language);
+    // v0.4.0+: Skills moved to plugins/specweave/skills/
+    const sourceDir = findSourceDir('plugins/specweave/skills');
+    if (!fs.existsSync(sourceDir)) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.sourceNotFound', { type: 'skills' })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.expectedAt', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.dirname', { path: __dirname })}`));
+        const packageRoot = findPackageRoot(__dirname);
+        if (packageRoot) {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.packageRoot', { root: packageRoot })}`));
+        }
+        else {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.couldNotFindRoot')}`));
+        }
+        throw new Error('Failed to locate source skills directory. This may be a Windows path resolution issue.');
+    }
+    // Validate source directory contains subdirectories with SKILL.md files
+    const skillDirs = fs.readdirSync(sourceDir, { withFileTypes: true })
+        .filter(dirent => dirent.isDirectory());
+    if (skillDirs.length === 0) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.sourceEmpty', { type: 'skills' })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.directory', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.installationIssue')}`));
+        throw new Error('Source skills directory exists but contains no skill subdirectories');
+    }
+    try {
+        // Ensure target directory exists
+        fs.ensureDirSync(targetSkillsDir);
+        // Copy each skill directory and inject system prompts if needed
+        for (const skillDir of skillDirs) {
+            const sourcePath = path.join(sourceDir, skillDir.name);
+            const targetPath = path.join(targetSkillsDir, skillDir.name);
+            // Copy entire skill directory first
+            fs.copySync(sourcePath, targetPath, {
+                overwrite: true,
+                errorOnExist: false
+            });
+            // Then inject system prompt into SKILL.md if language !== 'en'
+            if (language !== 'en') {
+                const skillMdPath = path.join(targetPath, 'SKILL.md');
+                if (fs.existsSync(skillMdPath)) {
+                    const content = fs.readFileSync(skillMdPath, 'utf-8');
+                    const modifiedContent = injectSystemPromptForInit(content, language);
+                    fs.writeFileSync(skillMdPath, modifiedContent, 'utf-8');
+                }
+            }
+        }
+        // Validate subdirectories were copied
+        const copiedDirs = fs.readdirSync(targetSkillsDir, { withFileTypes: true })
+            .filter(dirent => dirent.isDirectory());
+        if (copiedDirs.length === 0) {
+            throw new Error(`Copy completed but no skill directories found in target: ${targetSkillsDir}`);
+        }
+        console.log(chalk.gray(`   ${locale.t('cli', 'init.info.copiedSkills', { count: copiedDirs.length })}`));
+    }
+    catch (error) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.errorCopying', { type: 'skills', error: error.message })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.source', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.target', { path: targetSkillsDir })}`));
+        throw error;
+    }
+}
+function copyHooks(hooksDir, targetHooksDir, language = 'en') {
+    const locale = getLocaleManager(language);
+    // v0.4.0+: Hooks moved to plugins/specweave/hooks/
+    const sourceDir = findSourceDir('plugins/specweave/hooks');
+    if (!fs.existsSync(sourceDir)) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.sourceNotFound', { type: 'hooks' })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.expectedAt', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.dirname', { path: __dirname })}`));
+        const packageRoot = findPackageRoot(__dirname);
+        if (packageRoot) {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.packageRoot', { root: packageRoot })}`));
+        }
+        else {
+            console.error(chalk.red(`   ${locale.t('cli', 'init.errors.couldNotFindRoot')}`));
+        }
+        throw new Error('Failed to locate source hooks directory. This may be a Windows path resolution issue.');
+    }
+    // Validate source directory contains hook files
+    const hookFiles = fs.readdirSync(sourceDir).filter(f => f.endsWith('.sh') || f === 'README.md');
+    if (hookFiles.length === 0) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.sourceEmpty', { type: 'hooks' })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.directory', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.installationIssue')}`));
+        throw new Error('Source hooks directory exists but contains no hook files');
+    }
+    try {
+        // Ensure target directory exists
+        fs.ensureDirSync(targetHooksDir);
+        // Copy all files from source to target
+        fs.copySync(sourceDir, targetHooksDir, {
+            overwrite: true,
+            errorOnExist: false
+        });
+        // Validate files were copied
+        const copiedFiles = fs.readdirSync(targetHooksDir).filter(f => f.endsWith('.sh') || f === 'README.md');
+        if (copiedFiles.length === 0) {
+            throw new Error(`Copy completed but no hook files found in target: ${targetHooksDir}`);
+        }
+        console.log(chalk.gray(`   ${locale.t('cli', 'init.info.copiedHooks', { count: copiedFiles.length })}`));
+    }
+    catch (error) {
+        console.error(chalk.red(`\n${locale.t('cli', 'init.errors.errorCopying', { type: 'hooks', error: error.message })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.source', { path: sourceDir })}`));
+        console.error(chalk.red(`   ${locale.t('cli', 'init.errors.target', { path: targetHooksDir })}`));
+        throw error;
+    }
+}
+/**
+ * Create .specweave/config.json with project settings
+ */
+function createConfigFile(targetDir, projectName, adapter, language, enableDocsPreview = true) {
+    const configPath = path.join(targetDir, '.specweave', 'config.json');
+    const config = {
+        project: {
+            name: projectName,
+            version: '0.1.0',
+        },
+        adapters: {
+            default: adapter,
+        },
+        // Documentation preview settings (for Claude Code only)
+        ...(adapter === 'claude' && {
+            documentation: {
+                preview: {
+                    enabled: enableDocsPreview,
+                    autoInstall: false, // Lazy install on first use
+                    port: 3015, // Internal docs (avoid port 3000 - used by React/Next.js/Vite)
+                    openBrowser: true,
+                    theme: 'default',
+                    excludeFolders: ['legacy', 'node_modules']
+                }
+            }
+        }),
+        // Only include language if non-English
+        ...(language !== 'en' && {
+            language,
+            translation: {
+                method: 'in-session',
+                autoTranslateLivingDocs: false,
+                keepFrameworkTerms: true,
+                keepTechnicalTerms: true,
+                translateCodeComments: true,
+                translateVariableNames: false,
+            },
+        }),
+    };
+    fs.writeJsonSync(configPath, config, { spaces: 2 });
+}
+/**
+ * Setup Claude Code automatic plugin registration
+ * Creates .claude/settings.json with extraKnownMarketplaces
+ * This triggers Claude's native auto-install when users trust the folder
+ */
+function setupClaudePluginAutoRegistration(targetDir, language) {
+    const locale = getLocaleManager(language);
+    const settingsPath = path.join(targetDir, '.claude', 'settings.json');
+    // Create settings.json with GitHub marketplace registration
+    // ✅ Claude Code fetches plugins from GitHub (no local marketplace files needed!)
+    const settings = {
+        extraKnownMarketplaces: {
+            specweave: {
+                source: {
+                    source: 'github',
+                    repo: 'anton-abyzov/specweave',
+                    path: '.claude-plugin'
+                }
+            }
+        }
+    };
+    try {
+        fs.writeJsonSync(settingsPath, settings, { spaces: 2 });
+        console.log(chalk.green(`\n✅ ${locale.t('cli', 'init.success.pluginAutoSetup')}`));
+        console.log(chalk.gray(`   Marketplace: github.com/anton-abyzov/specweave/.claude-plugin`));
+        console.log(chalk.gray(`   Plugins will be fetched from GitHub (always up-to-date)`));
+    }
+    catch (error) {
+        throw new Error(`Failed to create .claude/settings.json: ${error.message}`);
+    }
+}
+function showNextSteps(projectName, adapterName, language, usedDotNotation = false, pluginAutoInstalled = false) {
+    const locale = getLocaleManager(language);
+    console.log('');
+    console.log(chalk.cyan.bold(locale.t('cli', 'init.nextSteps.header')));
+    console.log('');
+    let stepNumber = 1;
+    // Only show "cd" step if we created a subdirectory
+    if (!usedDotNotation) {
+        console.log(`   ${stepNumber}. ${chalk.white(locale.t('cli', 'init.nextSteps.cd', { projectName }))}`);
+        console.log('');
+        stepNumber++;
+    }
+    // Adapter-specific instructions
+    if (adapterName === 'claude') {
+        console.log(`   ${stepNumber}. ${chalk.white(locale.t('cli', 'init.nextSteps.claude.step1'))}`);
+        console.log('');
+        stepNumber++;
+        // Only show manual install if auto-install failed
+        if (!pluginAutoInstalled) {
+            console.log(`   ${stepNumber}. ${chalk.yellow.bold('⚠️  ' + locale.t('cli', 'init.nextSteps.claude.step2'))}`);
+            console.log(`      ${chalk.cyan.bold(locale.t('cli', 'init.nextSteps.claude.installCore'))}`);
+            console.log(`      ${chalk.gray('↑ Required for slash commands like /specweave:increment')}`);
+            console.log('');
+            stepNumber++;
+        }
+        console.log(`   ${stepNumber}. ${chalk.white('All plugins are already installed!')}`);
+        console.log(`      ${chalk.gray('✔ All 19+ SpecWeave plugins installed automatically')}`);
+        console.log(`      ${chalk.gray('✔ No need to install additional plugins manually')}`);
+        console.log(`      ${chalk.gray('✔ Full capabilities available immediately')}`);
+        console.log('');
+        stepNumber++;
+        console.log(`   ${stepNumber}. ${chalk.white(locale.t('cli', 'init.nextSteps.claude.step4'))}`);
+        console.log(`      ${chalk.cyan(locale.t('cli', 'init.nextSteps.claude.example'))}`);
+        console.log(`      ${chalk.gray(locale.t('cli', 'init.nextSteps.claude.autoActivate'))}`);
+    }
+    else if (adapterName === 'cursor') {
+        console.log(`   ${stepNumber}. ${chalk.white(locale.t('cli', 'init.nextSteps.cursor.step1'))}`);
+        console.log('');
+        console.log(`   ${stepNumber + 1}. ${chalk.white(locale.t('cli', 'init.nextSteps.cursor.step2'))}`);
+        console.log(`      ${locale.t('cli', 'init.nextSteps.cursor.guide')}`);
+        console.log('');
+        console.log(`   ${stepNumber + 2}. ${chalk.white(locale.t('cli', 'init.nextSteps.cursor.step3'))}`);
+        console.log(`      ${locale.t('cli', 'init.nextSteps.cursor.shortcuts')}`);
+    }
+    else if (adapterName === 'generic') {
+        console.log(`   ${stepNumber}. ${chalk.white(locale.t('cli', 'init.nextSteps.generic.step1'))}`);
+        console.log('');
+        console.log(`   ${stepNumber + 1}. ${chalk.white(locale.t('cli', 'init.nextSteps.generic.step2'))}`);
+        console.log(`      ${locale.t('cli', 'init.nextSteps.generic.compatibility')}`);
+    }
+    console.log('');
+    console.log(chalk.green.bold(locale.t('cli', 'init.nextSteps.footer')));
+    console.log('');
+    console.log(chalk.gray(locale.t('cli', 'init.nextSteps.docsLink')));
+    console.log(chalk.gray(locale.t('cli', 'init.nextSteps.githubLink')));
+    console.log('');
+}
+//# sourceMappingURL=init.js.map