/**
 * Init Command
 *
 * Sets up OpenSpec with Agent Skills and /opsx:* slash commands.
 * This is the unified setup command that replaces both the old init and experimental commands.
 */
import path from 'path';
import chalk from 'chalk';
import ora from 'ora';
import * as fs from 'fs';
import { createRequire } from 'module';
import { FileSystemUtils } from '../utils/file-system.js';
import { classifyOpenSpecDir, storePointerProblem } from './project-config.js';
import { findRepoPlanningRootSync } from './planning-home.js';
import { getSkillReferenceTransformer, getTransformerForTool, usesNaturalLanguageSkillReferences } from '../utils/command-references.js';
import { AI_TOOLS, OPENSPEC_DIR_NAME, resolveToolIdAlias, } from './config.js';
import { PALETTE } from './styles/palette.js';
import { isInteractive } from '../utils/interactive.js';
import { serializeConfig } from './config-prompts.js';
import { generateCommands, CommandAdapterRegistry, } from './command-generation/index.js';
import { detectLegacyArtifacts, cleanupLegacyArtifacts, formatCleanupSummary, formatDeferredGlobalPromptSummary, formatDetectionSummary, getLegacyGlobalPromptMatches, omitGlobalLegacyPromptFiles, pickGlobalLegacyPromptFiles, } from './legacy-cleanup.js';
import { getToolsWithSkillsDir, getToolStates, getSkillTemplates, getCommandContents, generateSkillContent, hasGlobalSkillTarget, resolveToolSkillsDir, toolSupportsSkills, } from './shared/index.js';
import { getGlobalConfig } from './global-config.js';
import { getProfileWorkflows, ALL_WORKFLOWS } from './profiles.js';
import { getAvailableTools } from './available-tools.js';
import { writeSharedSkillTarget } from './shared-skill-target.js';
import { migrateIfNeeded, migrateLegacyToolDirs, describeLegacyMigration, keptInPlaceNotice, hasMovableContent, scanInstalledWorkflows as scanInstalledWorkflowsShared } from './migration.js';
import { resolveCommandSurfaceCapability, resolveCommandInvocation, shouldGenerateCommandsForTool, shouldGenerateSkillsForTool, shouldReconcileCommandFilesForTool, shouldRemoveSkillsForTool, } from './command-surface.js';
import { writeCopilotCloudFiles, readCopilotCloudOptIn, hasExistingManagedCloudFiles, persistCopilotCloudOptIn, removeCopilotCloudFiles, findUnmanagedCloudFiles, listManagedCloudFiles, } from './github-copilot/cloud-agent.js';
const require = createRequire(import.meta.url);
const { version: OPENSPEC_VERSION } = require('../../package.json');
// -----------------------------------------------------------------------------
// Constants
// -----------------------------------------------------------------------------
const DEFAULT_SCHEMA = 'spec-driven';
const PROGRESS_SPINNER = {
    interval: 80,
    frames: ['░░░', '▒░░', '▒▒░', '▒▒▒', '▓▒▒', '▓▓▒', '▓▓▓', '▒▓▓', '░▒▓'],
};
const WORKFLOW_TO_SKILL_DIR = {
    'explore': 'openspec-explore',
    'new': 'openspec-new-change',
    'continue': 'openspec-continue-change',
    'apply': 'openspec-apply-change',
    'update': 'openspec-update-change',
    'ff': 'openspec-ff-change',
    'sync': 'openspec-sync-specs',
    'archive': 'openspec-archive-change',
    'bulk-archive': 'openspec-bulk-archive-change',
    'verify': 'openspec-verify-change',
    'onboard': 'openspec-onboard',
    'propose': 'openspec-propose',
};
// -----------------------------------------------------------------------------
// Init Command Class
// -----------------------------------------------------------------------------
export class InitCommand {
    toolsArg;
    force;
    interactiveOption;
    profileOverride;
    animation;
    copilotCloudOption;
    constructor(options = {}) {
        this.toolsArg = options.tools;
        this.force = options.force ?? false;
        this.interactiveOption = options.interactive;
        this.profileOverride = options.profile;
        this.animation = options.animation ?? true;
        this.copilotCloudOption = options.copilotCloud;
    }
    async execute(targetPath) {
        const projectPath = path.resolve(targetPath);
        const openspecDir = OPENSPEC_DIR_NAME;
        const openspecPath = path.join(projectPath, openspecDir);
        // Validation happens silently in the background
        const extendMode = await this.validate(projectPath, openspecPath);
        // Pointer guard (slice 3.2): a config-only openspec/ with a store:
        // declaration is externalized planning, not a root to extend — and a
        // subdirectory of such a repo must not silently grow a nested root.
        // Refuse before legacy cleanup, migration, or prompts touch anything.
        // In extend mode the walk finds projectPath itself; otherwise it
        // finds the nearest ancestor root (so pointer-repo subdirectories
        // refuse exactly where a normal command would resolve the pointer).
        const guardRoot = findRepoPlanningRootSync(projectPath);
        if (guardRoot) {
            const { hasPlanningShape, pointer } = classifyOpenSpecDir(guardRoot);
            if (!hasPlanningShape) {
                if (pointer.malformed) {
                    throw new Error(`The store declaration in ${pointer.filePath} is invalid (` +
                        storePointerProblem(pointer.malformed) +
                        `). Fix or remove the store: line before running openspec init.`);
                }
                if (pointer.value !== undefined) {
                    throw new Error(`This repo's planning is externalized to store '${pointer.value}' (${pointer.filePath}). ` +
                        `Remove the store: line first to convert this repo to a local OpenSpec root.`);
                }
            }
        }
        // Check for legacy artifacts and handle cleanup
        const deferredLegacyCleanup = await this.handleLegacyCleanup(projectPath, extendMode);
        // Migrate OpenSpec-managed skills left in renamed tool directories
        // (e.g. .kimi -> .kimi-code) before detection so they stay recognized.
        migrateLegacyToolDirs(projectPath);
        // Detect available tools in the project (task 7.1)
        const detectedTools = getAvailableTools(projectPath);
        // Migration check: migrate existing projects to profile system (task 7.3)
        if (extendMode) {
            migrateIfNeeded(projectPath, detectedTools);
        }
        // Validate profile override early so invalid values fail before tool setup.
        // The resolved value is consumed later when generation reads effective config.
        // This runs ahead of the welcome screen so an invalid --profile does not make
        // the user press Enter before seeing the error.
        this.resolveProfileOverride();
        // Show animated welcome screen (interactive mode only)
        const canPrompt = this.canPromptInteractively();
        if (canPrompt) {
            const { showWelcomeScreen } = await import('../ui/welcome-screen.js');
            await showWelcomeScreen(this.getActiveWorkflows(), { animate: this.animation });
        }
        // Get tool states before processing
        const toolStates = getToolStates(projectPath);
        // Get tool selection (pass detected tools for pre-selection)
        const selectedToolIds = await this.getSelectedTools(toolStates, extendMode, detectedTools, projectPath);
        // Validate selected tools
        const validatedTools = this.validateTools(selectedToolIds, toolStates, projectPath);
        // Selecting a renamed tool is consent to leave its former directory:
        // init is about to write the current one, and leaving OpenSpec content
        // behind would give the user two installs of the same tool.
        for (const migration of migrateLegacyToolDirs(projectPath, validatedTools.map((tool) => tool.value))) {
            if (hasMovableContent(migration)) {
                console.log(chalk.dim(`Migrated ${describeLegacyMigration(migration)}: ${migration.from} → ${migration.to}`));
            }
            const kept = keptInPlaceNotice(migration);
            if (kept)
                console.log(chalk.dim(kept));
        }
        // Decide whether to generate GitHub Copilot cloud files. This is opt-in
        // (see cloud-agent.ts): selecting the Copilot tool no longer silently
        // writes a GitHub Actions workflow into the user's .github/. The decision
        // is made before generation so the write can be gated, and persisted after
        // config.yaml exists so future non-interactive updates honor it.
        const copilotDecision = await this.resolveCopilotCloudDecision(projectPath, validatedTools);
        // Create directory structure and config
        await this.createDirectoryStructure(openspecPath, extendMode);
        // Generate skills and commands for each tool
        const results = await this.generateSkillsAndCommands(projectPath, validatedTools, copilotDecision.write);
        // Legacy cleanup was deferred to avoid interfering with skill/command generation;
        // now that outputs are written, finalize the cleanup (e.g. remove stale files).
        if (deferredLegacyCleanup) {
            await this.finalizeDeferredLegacyCleanup(projectPath, deferredLegacyCleanup);
        }
        // Create config.yaml if needed
        const configStatus = await this.createConfig(openspecPath, extendMode);
        // Persist an explicit Copilot cloud decision so `openspec update` (which
        // never prompts) honors it. Best-effort: a config-write failure must not
        // fail an otherwise-successful init.
        if (copilotDecision.persist !== undefined) {
            try {
                await persistCopilotCloudOptIn(projectPath, copilotDecision.persist);
            }
            catch {
                // Non-fatal: the files (if any) were still written correctly.
            }
        }
        // An explicit opt-out means "no cloud files here": clean up any that a
        // previous run (or an older OpenSpec) generated. Only OpenSpec-managed
        // files are removed — a user-customized file is preserved.
        let copilotRemoved = 0;
        if (copilotDecision.optedOut) {
            try {
                copilotRemoved = await removeCopilotCloudFiles(projectPath);
            }
            catch {
                // Non-fatal: removal targets files from a prior run; a failure here
                // just leaves them for the next `openspec update` to clean up.
            }
        }
        // Report the cloud outcome from what is actually on disk after the write,
        // not from the decision alone: writing over a user-owned file is a no-op,
        // and the alternate-agent path can remove a managed file — so list only
        // managed files that exist, and separately flag any left-untouched ones.
        const copilotSucceeded = [...results.createdTools, ...results.refreshedTools].some((tool) => tool.value === 'github-copilot');
        const wroteCloud = copilotDecision.write && copilotSucceeded;
        const copilotPresent = wroteCloud ? await listManagedCloudFiles(projectPath) : [];
        const copilotCollisions = wroteCloud ? await findUnmanagedCloudFiles(projectPath) : [];
        // Display success message
        this.displaySuccessMessage(projectPath, validatedTools, results, configStatus, {
            write: copilotDecision.write,
            skippedUndecided: copilotDecision.skippedUndecided,
            present: copilotPresent,
            collisions: copilotCollisions,
            removed: copilotRemoved,
        });
        if (results.failedTools.length > 0) {
            throw new Error(`OpenSpec setup failed for: ${results.failedTools.map((tool) => tool.name).join(', ')}`);
        }
    }
    // ═══════════════════════════════════════════════════════════
    // VALIDATION & SETUP
    // ═══════════════════════════════════════════════════════════
    async validate(projectPath, openspecPath) {
        const extendMode = await FileSystemUtils.directoryExists(openspecPath);
        // Check write permissions
        if (!(await FileSystemUtils.ensureWritePermissions(projectPath))) {
            throw new Error(`Insufficient permissions to write to ${projectPath}`);
        }
        return extendMode;
    }
    canPromptInteractively() {
        if (this.interactiveOption === false)
            return false;
        if (this.toolsArg !== undefined)
            return false;
        return isInteractive({ interactive: this.interactiveOption });
    }
    /**
     * Decide whether to generate GitHub Copilot cloud files, and whether to
     * persist that decision. Precedence:
     *   1. `--copilot-cloud` / `--no-copilot-cloud` flag (explicit this run)
     *   2. persisted opt-in in config.yaml
     *   3. managed files already present (migration for pre-opt-in projects)
     *   4. interactive confirm (default No)
     *   5. non-interactive with no signal: skip, and don't persist a default
     *
     * @returns `write` — generate the files this run; `persist` — value to write
     *   back to config (undefined = leave config untouched); `optedOut` — the user
     *   explicitly declined, so any already-generated managed files should be
     *   removed; `skippedUndecided` — selected but no signal and couldn't ask, so
     *   the caller can hint that the opt-in exists.
     */
    async resolveCopilotCloudDecision(projectPath, tools) {
        const copilotSelected = tools.some((tool) => tool.value === 'github-copilot');
        if (!copilotSelected) {
            // A flag that can't apply is a likely mistake — say so rather than no-op.
            if (this.copilotCloudOption !== undefined) {
                console.log(chalk.yellow('--copilot-cloud/--no-copilot-cloud was ignored because the github-copilot tool was not selected.'));
            }
            return { write: false, optedOut: false, skippedUndecided: false };
        }
        if (this.copilotCloudOption !== undefined) {
            return {
                write: this.copilotCloudOption,
                persist: this.copilotCloudOption,
                optedOut: !this.copilotCloudOption,
                skippedUndecided: false,
            };
        }
        const persistedOptIn = readCopilotCloudOptIn(projectPath);
        if (typeof persistedOptIn === 'boolean') {
            return { write: persistedOptIn, optedOut: !persistedOptIn, skippedUndecided: false };
        }
        if (await hasExistingManagedCloudFiles(projectPath)) {
            return { write: true, optedOut: false, skippedUndecided: false };
        }
        if (this.canPromptInteractively()) {
            const { confirm } = await import('@inquirer/prompts');
            const answer = await confirm({
                message: 'Set up GitHub Copilot cloud coding-agent files? This is for the GitHub-hosted ' +
                    'Copilot coding agent (github.com), not Copilot in your editor. It writes two files: ' +
                    '.github/workflows/copilot-setup-steps.yml and .github/agents/openspec.agent.md.',
                default: false,
            });
            return { write: answer, persist: answer, optedOut: !answer, skippedUndecided: false };
        }
        // Non-interactive with no explicit signal: don't write, and leave the
        // decision unpersisted so a later interactive run can still prompt.
        return { write: false, optedOut: false, skippedUndecided: true };
    }
    resolveProfileOverride() {
        if (this.profileOverride === undefined) {
            return undefined;
        }
        if (this.profileOverride === 'core' || this.profileOverride === 'custom') {
            return this.profileOverride;
        }
        throw new Error(`Invalid profile "${this.profileOverride}". Available profiles: core, custom`);
    }
    /**
     * Resolves the workflows the effective profile installs, so onboarding output
     * only mentions commands that will actually exist.
     */
    getActiveWorkflows() {
        const globalCfg = getGlobalConfig();
        const activeProfile = this.resolveProfileOverride() ?? globalCfg.profile ?? 'core';
        return [...getProfileWorkflows(activeProfile, globalCfg.workflows)];
    }
    // ═══════════════════════════════════════════════════════════
    // LEGACY CLEANUP
    // ═══════════════════════════════════════════════════════════
    /**
     * Cleans repo-local legacy artifacts immediately and defers global Codex prompt
     * cleanup until replacement skills have been installed.
     */
    async handleLegacyCleanup(projectPath, extendMode) {
        // Detect legacy artifacts
        const detection = await detectLegacyArtifacts(projectPath);
        if (!detection.hasLegacyArtifacts) {
            return null; // No legacy artifacts found
        }
        const immediateDetection = omitGlobalLegacyPromptFiles(detection);
        // Show what was detected
        const immediateSummary = formatDetectionSummary(immediateDetection);
        if (immediateSummary) {
            console.log();
            console.log(immediateSummary);
            console.log();
        }
        // Show which global prompts are deferred — they'll only be removed once
        // the corresponding replacement skills are installed during generation.
        const deferredSummary = formatDeferredGlobalPromptSummary(detection);
        if (deferredSummary) {
            console.log(deferredSummary);
            console.log();
        }
        const canPrompt = this.canPromptInteractively();
        if (this.force || !canPrompt) {
            // --force flag or non-interactive mode: proceed with cleanup automatically.
            // Legacy slash commands are 100% OpenSpec-managed, and config file cleanup
            // only removes markers (never deletes files), so auto-cleanup is safe.
            await this.performImmediateLegacyCleanup(projectPath, detection);
            return detection.globalSlashCommandFiles.length > 0 ? { detection } : null;
        }
        // Interactive mode: prompt for confirmation
        const { confirm } = await import('@inquirer/prompts');
        const shouldCleanup = await confirm({
            message: 'Upgrade and clean up legacy files?',
            default: true,
        });
        if (!shouldCleanup) {
            console.log(chalk.dim('Initialization cancelled.'));
            console.log(chalk.dim('Run with --force to skip this prompt, or manually remove legacy files.'));
            process.exit(0);
        }
        await this.performImmediateLegacyCleanup(projectPath, detection);
        return detection.globalSlashCommandFiles.length > 0 ? { detection } : null;
    }
    /**
     * Applies the safe subset of legacy cleanup that does not depend on newly
     * generated Codex skills.
     */
    async performImmediateLegacyCleanup(projectPath, detection) {
        const immediateDetection = omitGlobalLegacyPromptFiles(detection);
        if (!immediateDetection.hasLegacyArtifacts) {
            return;
        }
        await this.performLegacyCleanup(projectPath, immediateDetection);
    }
    /**
     * Removes only the legacy global Codex prompts whose workflows now have
     * replacement skills in the project.
     */
    async finalizeDeferredLegacyCleanup(projectPath, deferredCleanup) {
        const availableCodexWorkflows = await this.getInstalledWorkflowsForTool(projectPath, 'codex');
        const removableMatches = getLegacyGlobalPromptMatches(deferredCleanup.detection)
            .filter((prompt) => prompt.workflowIds.every((workflowId) => availableCodexWorkflows.has(workflowId)));
        if (removableMatches.length > 0) {
            await this.performLegacyCleanup(projectPath, pickGlobalLegacyPromptFiles(deferredCleanup.detection, removableMatches.map((prompt) => prompt.path)));
        }
        const blockedMatches = getLegacyGlobalPromptMatches(deferredCleanup.detection)
            .filter((prompt) => !removableMatches.some((match) => match.path === prompt.path));
        if (blockedMatches.length > 0) {
            console.log(chalk.yellow('Preserved deferred global prompts without replacement skills:'));
            for (const prompt of blockedMatches) {
                console.log(chalk.dim(`  - ${prompt.toolId}: ${prompt.path}`));
            }
            console.log();
        }
    }
    /**
     * Reads the currently installed workflow IDs for a single tool from the
     * generated skill layout on disk.
     */
    async getInstalledWorkflowsForTool(projectPath, toolId) {
        const tool = AI_TOOLS.find((candidate) => candidate.value === toolId);
        if (!tool) {
            return new Set();
        }
        return new Set(scanInstalledWorkflowsShared(projectPath, [tool]));
    }
    async performLegacyCleanup(projectPath, detection) {
        const spinner = ora('Cleaning up legacy files...').start();
        const result = await cleanupLegacyArtifacts(projectPath, detection);
        spinner.succeed('Legacy files cleaned up');
        const summary = formatCleanupSummary(result);
        if (summary) {
            console.log();
            console.log(summary);
        }
        console.log();
    }
    // ═══════════════════════════════════════════════════════════
    // TOOL SELECTION
    // ═══════════════════════════════════════════════════════════
    async getSelectedTools(toolStates, extendMode, detectedTools, projectPath) {
        // Check for --tools flag first
        const nonInteractiveSelection = this.resolveToolsArg();
        if (nonInteractiveSelection !== null) {
            return nonInteractiveSelection;
        }
        const validTools = getToolsWithSkillsDir();
        const detectedToolIds = new Set(detectedTools.map((t) => t.value));
        const configuredToolIds = new Set([...toolStates.entries()]
            .filter(([, status]) => status.configured)
            .map(([toolId]) => toolId));
        const shouldPreselectDetected = !extendMode && configuredToolIds.size === 0;
        const canPrompt = this.canPromptInteractively();
        // Non-interactive mode: use detected tools as fallback (task 7.8)
        if (!canPrompt) {
            if (detectedToolIds.size > 0) {
                return [...detectedToolIds];
            }
            throw new Error(`No tools detected and no --tools flag provided. Valid tools:\n  ${validTools.join('\n  ')}\n\nUse --tools all, --tools none, or --tools claude,cursor,...`);
        }
        if (validTools.length === 0) {
            throw new Error(`No tools available for skill generation.`);
        }
        // Interactive mode: show searchable multi-select
        const { searchableMultiSelect } = await import('../prompts/searchable-multi-select.js');
        // Build choices: pre-select configured tools; keep detected tools visible but unselected.
        const sortedChoices = validTools
            .map((toolId) => {
            const tool = AI_TOOLS.find((t) => t.value === toolId);
            const status = toolStates.get(toolId);
            const configured = status?.configured ?? false;
            const detected = detectedToolIds.has(toolId);
            return {
                name: tool?.name || toolId,
                value: toolId,
                configured,
                detected: detected && !configured,
                preSelected: configured || (shouldPreselectDetected && detected && !configured),
            };
        })
            .sort((a, b) => {
            // Configured tools first, then detected (not configured), then everything else.
            if (a.configured && !b.configured)
                return -1;
            if (!a.configured && b.configured)
                return 1;
            if (a.detected && !b.detected)
                return -1;
            if (!a.detected && b.detected)
                return 1;
            return 0;
        });
        const configuredNames = validTools
            .filter((toolId) => configuredToolIds.has(toolId))
            .map((toolId) => AI_TOOLS.find((t) => t.value === toolId)?.name || toolId);
        if (configuredNames.length > 0) {
            console.log(`OpenSpec configured: ${configuredNames.join(', ')} (pre-selected)`);
        }
        const detectedOnlyNames = detectedTools
            .filter((tool) => !configuredToolIds.has(tool.value))
            .map((tool) => tool.name);
        if (detectedOnlyNames.length > 0) {
            const detectionLabel = shouldPreselectDetected
                ? 'pre-selected for first-time setup'
                : 'not pre-selected';
            console.log(`Detected tool directories: ${detectedOnlyNames.join(', ')} (${detectionLabel})`);
        }
        const selectedTools = await searchableMultiSelect({
            message: `Select tools to set up (${validTools.length} available)`,
            pageSize: 15,
            choices: sortedChoices,
            validate: (selected) => selected.length > 0 || 'Select at least one tool',
        });
        if (selectedTools.length === 0) {
            throw new Error('At least one tool must be selected');
        }
        return selectedTools;
    }
    resolveToolsArg() {
        if (typeof this.toolsArg === 'undefined') {
            return null;
        }
        const raw = this.toolsArg.trim();
        if (raw.length === 0) {
            throw new Error('The --tools option requires a value. Use "all", "none", or a comma-separated list of tool IDs.');
        }
        const availableTools = getToolsWithSkillsDir();
        const availableSet = new Set(availableTools);
        const availableList = ['all', 'none', ...availableTools].join(', ');
        const lowerRaw = raw.toLowerCase();
        if (lowerRaw === 'all') {
            return availableTools;
        }
        if (lowerRaw === 'none') {
            return [];
        }
        const tokens = raw
            .split(',')
            .map((token) => token.trim())
            .filter((token) => token.length > 0);
        if (tokens.length === 0) {
            throw new Error('The --tools option requires at least one tool ID when not using "all" or "none".');
        }
        // Retired ids resolve to their current tool, so a rebrand does not break
        // an existing `--tools windsurf` in someone's setup script.
        const normalizedTokens = tokens.map((token) => resolveToolIdAlias(token.toLowerCase()));
        if (normalizedTokens.some((token) => token === 'all' || token === 'none')) {
            throw new Error('Cannot combine reserved values "all" or "none" with specific tool IDs.');
        }
        const invalidTokens = tokens.filter((_token, index) => !availableSet.has(normalizedTokens[index]));
        if (invalidTokens.length > 0) {
            throw new Error(`Invalid tool(s): ${invalidTokens.join(', ')}. Available values: ${availableList}`);
        }
        // Deduplicate while preserving order
        const deduped = [];
        for (const token of normalizedTokens) {
            if (!deduped.includes(token)) {
                deduped.push(token);
            }
        }
        return deduped;
    }
    validateTools(toolIds, toolStates, projectPath) {
        const validatedTools = [];
        const reconciledToolIds = toolIds.includes('codex') && toolIds.includes('agents')
            ? toolIds.filter((toolId) => toolId !== 'agents')
            : toolIds;
        if (reconciledToolIds.length !== toolIds.length) {
            console.log(chalk.dim('Codex and agents share .agents/skills; writing one tree with Codex and generic skill references.'));
        }
        for (const toolId of reconciledToolIds) {
            const tool = AI_TOOLS.find((t) => t.value === toolId);
            if (!tool) {
                const validToolIds = getToolsWithSkillsDir();
                throw new Error(`Unknown tool '${toolId}'. Valid tools:\n  ${validToolIds.join('\n  ')}`);
            }
            if (!toolSupportsSkills(tool)) {
                const validToolsWithSkills = getToolsWithSkillsDir();
                throw new Error(`Tool '${toolId}' does not support skill generation.\nTools with skill generation support:\n  ${validToolsWithSkills.join('\n  ')}`);
            }
            const preState = toolStates.get(tool.value);
            const skillsPath = resolveToolSkillsDir(projectPath, tool);
            const isGlobalSkillTarget = hasGlobalSkillTarget(tool);
            validatedTools.push({
                value: tool.value,
                name: tool.name,
                skillsDir: tool.skillsDir,
                skillsPath,
                skillsRoot: isGlobalSkillTarget ? skillsPath : projectPath,
                isGlobalSkillTarget,
                wasConfigured: preState?.configured ?? false,
                requiresIdeRestart: tool.requiresIdeRestart,
            });
        }
        return validatedTools;
    }
    // ═══════════════════════════════════════════════════════════
    // DIRECTORY STRUCTURE
    // ═══════════════════════════════════════════════════════════
    async createDirectoryStructure(openspecPath, extendMode) {
        if (extendMode) {
            // In extend mode, just ensure directories exist without spinner
            const directories = [
                openspecPath,
                path.join(openspecPath, 'specs'),
                path.join(openspecPath, 'changes'),
                path.join(openspecPath, 'changes', 'archive'),
            ];
            for (const dir of directories) {
                FileSystemUtils.assertProjectArtifactPath(path.dirname(openspecPath), dir);
                await FileSystemUtils.createDirectory(dir);
            }
            return;
        }
        const spinner = this.startSpinner('Creating OpenSpec structure...');
        const directories = [
            openspecPath,
            path.join(openspecPath, 'specs'),
            path.join(openspecPath, 'changes'),
            path.join(openspecPath, 'changes', 'archive'),
        ];
        for (const dir of directories) {
            FileSystemUtils.assertProjectArtifactPath(path.dirname(openspecPath), dir);
            await FileSystemUtils.createDirectory(dir);
        }
        spinner.stopAndPersist({
            symbol: PALETTE.white('▌'),
            text: PALETTE.white('OpenSpec structure created'),
        });
    }
    // ═══════════════════════════════════════════════════════════
    // SKILL & COMMAND GENERATION
    // ═══════════════════════════════════════════════════════════
    /**
     * Generates skill files and slash commands for each selected tool,
     * honoring the configured delivery mode (skills, commands, or both).
     *
     * @param projectPath - Absolute path to the project root
     * @param tools - Selected tools with their skill directory metadata
     * @returns Created, refreshed, and failed tools plus removed artifact counts
     */
    async generateSkillsAndCommands(projectPath, tools, writeCopilotCloud) {
        const createdTools = [];
        const refreshedTools = [];
        const failedTools = [];
        const commandsSkipped = [];
        const skillsInvocableCommandSkips = [];
        let removedCommandCount = 0;
        let removedSkillCount = 0;
        // Read global config for profile and delivery settings (use --profile override if set)
        const globalConfig = getGlobalConfig();
        const profile = this.resolveProfileOverride() ?? globalConfig.profile ?? 'core';
        const delivery = globalConfig.delivery ?? 'both';
        const workflows = getProfileWorkflows(profile, globalConfig.workflows);
        // Get skill and command templates filtered by profile workflows
        const deliveryIncludesCommands = delivery !== 'skills';
        const skillTemplates = getSkillTemplates(workflows);
        const commandContents = getCommandContents(workflows);
        // Process each tool
        for (const tool of tools) {
            const spinner = ora(`Setting up ${tool.name}...`).start();
            try {
                const shouldGenerateSkills = shouldGenerateSkillsForTool(tool.value, delivery);
                const shouldGenerateCommands = shouldGenerateCommandsForTool(tool.value, delivery);
                // Generate skill files if the selected delivery and tool capability allow skills
                if (shouldGenerateSkills) {
                    // Create skill directories and SKILL.md files
                    for (const { template, dirName } of skillTemplates) {
                        const skillDir = path.join(tool.skillsPath, dirName);
                        const skillFile = path.join(skillDir, 'SKILL.md');
                        // Generate SKILL.md content with YAML frontmatter including generatedBy
                        const transformer = getTransformerForTool(tool.value, delivery, resolveCommandSurfaceCapability(tool.value), resolveCommandInvocation(tool.value));
                        const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
                        // Write the skill file
                        FileSystemUtils.assertPathWithin(tool.skillsRoot, skillFile);
                        await FileSystemUtils.writeFile(skillFile, skillContent);
                    }
                    writeSharedSkillTarget(projectPath, tool.value);
                }
                if (shouldRemoveSkillsForTool(tool.value, delivery) && !tool.isGlobalSkillTarget) {
                    removedSkillCount += await this.removeSkillDirs(tool.skillsRoot, tool.skillsPath);
                    // Retain an explicit selection even when this delivery mode produces
                    // no skills, so a divergent legacy sibling cannot reclaim ownership.
                    writeSharedSkillTarget(projectPath, tool.value);
                }
                // Generate commands if delivery includes commands
                if (shouldGenerateCommands) {
                    const adapter = CommandAdapterRegistry.get(tool.value);
                    if (adapter) {
                        const generatedCommands = generateCommands(commandContents, adapter);
                        for (const cmd of generatedCommands) {
                            const commandFile = FileSystemUtils.resolveProjectArtifactPath(projectPath, cmd.path);
                            await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
                        }
                    }
                }
                else if (deliveryIncludesCommands) {
                    if (resolveCommandSurfaceCapability(tool.value) === 'skills-invocable') {
                        skillsInvocableCommandSkips.push(tool.value);
                    }
                    else {
                        commandsSkipped.push(tool.value);
                    }
                }
                if (shouldReconcileCommandFilesForTool(tool.value, delivery)) {
                    removedCommandCount += await this.removeCommandFiles(projectPath, tool.value);
                }
                if (tool.value === 'github-copilot' && writeCopilotCloud) {
                    await writeCopilotCloudFiles(projectPath);
                }
                spinner.succeed(`Setup complete for ${tool.name}`);
                if (tool.wasConfigured) {
                    refreshedTools.push(tool);
                }
                else {
                    createdTools.push(tool);
                }
            }
            catch (error) {
                spinner.fail(`Failed for ${tool.name}`);
                failedTools.push({ name: tool.name, error: error });
            }
        }
        for (const tool of [...createdTools, ...refreshedTools]) {
            for (const migration of migrateLegacyToolDirs(projectPath, [tool.value], 'after-generation')) {
                if (hasMovableContent(migration)) {
                    console.log(chalk.dim(`Migrated ${describeLegacyMigration(migration)}: ${migration.from} → ${migration.to}`));
                }
                const kept = keptInPlaceNotice(migration);
                if (kept)
                    console.log(chalk.dim(kept));
            }
        }
        return {
            createdTools,
            refreshedTools,
            failedTools,
            commandsSkipped,
            skillsInvocableCommandSkips,
            removedCommandCount,
            removedSkillCount,
        };
    }
    // ═══════════════════════════════════════════════════════════
    // CONFIG FILE
    // ═══════════════════════════════════════════════════════════
    async createConfig(openspecPath, extendMode) {
        const configPath = path.join(openspecPath, 'config.yaml');
        const configYmlPath = path.join(openspecPath, 'config.yml');
        const configYamlExists = fs.existsSync(configPath);
        const configYmlExists = fs.existsSync(configYmlPath);
        if (configYamlExists || configYmlExists) {
            return 'exists';
        }
        try {
            const yamlContent = serializeConfig({ schema: DEFAULT_SCHEMA });
            FileSystemUtils.assertProjectArtifactPath(path.dirname(openspecPath), configPath);
            await FileSystemUtils.writeFile(configPath, yamlContent);
            return 'created';
        }
        catch {
            return 'skipped';
        }
    }
    // ═══════════════════════════════════════════════════════════
    // UI & OUTPUT
    // ═══════════════════════════════════════════════════════════
    displaySuccessMessage(projectPath, tools, results, configStatus, copilot) {
        console.log();
        console.log(chalk.bold(results.failedTools.length > 0 ? 'OpenSpec Setup Incomplete' : 'OpenSpec Setup Complete'));
        console.log();
        // Show created vs refreshed tools
        if (results.createdTools.length > 0) {
            console.log(`Created: ${results.createdTools.map((t) => t.name).join(', ')}`);
        }
        if (results.refreshedTools.length > 0) {
            console.log(`Refreshed: ${results.refreshedTools.map((t) => t.name).join(', ')}`);
        }
        // Show counts (respecting profile filter)
        const successfulTools = [...results.createdTools, ...results.refreshedTools];
        if (successfulTools.length > 0) {
            const globalConfig = getGlobalConfig();
            const profile = this.profileOverride ?? globalConfig.profile ?? 'core';
            const delivery = globalConfig.delivery ?? 'both';
            const workflows = getProfileWorkflows(profile, globalConfig.workflows);
            const usesGlobalSkillTarget = successfulTools.some((tool) => tool.isGlobalSkillTarget);
            if (!usesGlobalSkillTarget) {
                const toolDirs = [
                    ...new Set(successfulTools
                        .map((tool) => tool.skillsDir)
                        .filter((skillsDir) => Boolean(skillsDir))),
                ].join(', ');
                const skillCount = successfulTools.some((tool) => shouldGenerateSkillsForTool(tool.value, delivery))
                    ? getSkillTemplates(workflows).length
                    : 0;
                const commandCount = successfulTools.some((tool) => shouldGenerateCommandsForTool(tool.value, delivery))
                    ? getCommandContents(workflows).length
                    : 0;
                if (skillCount > 0 && commandCount > 0) {
                    console.log(`${skillCount} skills and ${commandCount} commands in ${toolDirs}/`);
                }
                else if (skillCount > 0) {
                    console.log(`${skillCount} skills in ${toolDirs}/`);
                }
                else if (commandCount > 0) {
                    console.log(`${commandCount} commands in ${toolDirs}/`);
                }
            }
            else {
                const skillTools = successfulTools.filter((tool) => shouldGenerateSkillsForTool(tool.value, delivery));
                const skillCount = skillTools.length * getSkillTemplates(workflows).length;
                if (skillCount > 0) {
                    const skillDirs = [...new Set(skillTools.map((tool) => tool.skillsPath))];
                    console.log(`${skillCount} skills in ${skillDirs.join(', ')}`);
                }
                const commandContents = getCommandContents(workflows);
                const commandTools = successfulTools.filter((tool) => shouldGenerateCommandsForTool(tool.value, delivery));
                const commandCount = commandTools.length * commandContents.length;
                if (commandCount > 0) {
                    const commandDirs = [
                        ...new Set(commandTools.flatMap((tool) => {
                            const adapter = CommandAdapterRegistry.get(tool.value);
                            if (!adapter)
                                return [];
                            return commandContents.map((command) => {
                                const commandPath = adapter.getFilePath(command.id);
                                const absolutePath = path.isAbsolute(commandPath)
                                    ? commandPath
                                    : path.join(projectPath, commandPath);
                                return path.dirname(absolutePath);
                            });
                        })),
                    ];
                    console.log(`${commandCount} commands in ${commandDirs.join(', ')}`);
                }
            }
        }
        // Show failures
        if (results.failedTools.length > 0) {
            console.log(chalk.red(`Failed: ${results.failedTools.map((f) => `${f.name} (${f.error.message})`).join(', ')}`));
        }
        // Show skipped commands
        if (results.commandsSkipped.length > 0) {
            console.log(chalk.dim(`Commands skipped for: ${results.commandsSkipped.join(', ')} (no adapter)`));
        }
        if (results.skillsInvocableCommandSkips.length > 0) {
            console.log(chalk.dim(`Commands skipped for: ${results.skillsInvocableCommandSkips.join(', ')} (uses skills)`));
        }
        if (results.removedCommandCount > 0) {
            console.log(chalk.dim(`Removed: ${results.removedCommandCount} command files (delivery: skills)`));
        }
        if (results.removedSkillCount > 0) {
            console.log(chalk.dim(`Removed: ${results.removedSkillCount} skill directories (delivery: commands)`));
        }
        // GitHub Copilot cloud files are opt-in — report what is actually on disk:
        // list the managed files that now exist (never files we didn't write), flag
        // any user-owned file we left untouched, note an opt-out cleanup, or (when
        // skipped for want of a signal) say how to turn them on.
        const copilotSucceeded = successfulTools.some((tool) => tool.value === 'github-copilot');
        if (copilotSucceeded && copilot.write) {
            if (copilot.present.length > 0) {
                console.log(`GitHub Copilot cloud files: ${copilot.present.join(', ')}`);
            }
            if (copilot.collisions.length > 0) {
                console.log(chalk.dim(`Left your existing ${copilot.collisions.join(' and ')} untouched — add the OpenSpec ` +
                    `install step by hand so the Copilot cloud agent can run openspec.`));
            }
        }
        else if (copilotSucceeded && copilot.removed > 0) {
            console.log(chalk.dim(`Removed: ${copilot.removed} Copilot cloud agent file(s) (opted out of cloud files)`));
        }
        else if (copilotSucceeded && copilot.skippedUndecided) {
            console.log(chalk.dim("Skipped GitHub Copilot cloud files (opt-in). Enable with 'openspec init --copilot-cloud'."));
        }
        // Show manual setup notes for tools that need extra configuration
        for (const tool of successfulTools) {
            const setupNote = AI_TOOLS.find((t) => t.value === tool.value)?.setupNote;
            if (setupNote) {
                console.log(chalk.yellow(`Setup required for ${tool.name}: ${setupNote}`));
            }
        }
        // Config status
        if (configStatus === 'created') {
            console.log(`Config: openspec/config.yaml (schema: ${DEFAULT_SCHEMA})`);
        }
        else if (configStatus === 'exists') {
            // Show actual filename (config.yaml or config.yml)
            const configYaml = path.join(projectPath, OPENSPEC_DIR_NAME, 'config.yaml');
            const configYml = path.join(projectPath, OPENSPEC_DIR_NAME, 'config.yml');
            const configName = fs.existsSync(configYaml) ? 'config.yaml' : fs.existsSync(configYml) ? 'config.yml' : 'config.yaml';
            console.log(`Config: openspec/${configName} (exists)`);
        }
        else {
            console.log(chalk.dim(`Config: skipped (non-interactive mode)`));
        }
        // Getting started (task 7.6: show propose if in profile)
        const activeWorkflows = this.getActiveWorkflows();
        // When no tool got /opsx:* commands, point at the skill instead of a
        // command that does not exist.
        const activeDelivery = getGlobalConfig().delivery ?? 'both';
        const commandsGenerated = successfulTools.some((tool) => shouldGenerateCommandsForTool(tool.value, activeDelivery));
        const skillsGenerated = successfulTools.some((tool) => shouldGenerateSkillsForTool(tool.value, activeDelivery));
        // Each hint line must be a usable instruction for the tool it serves.
        // Tools that generated commands are told the command name their files
        // answer to (/opsx:* when namespaced under opsx/, /opsx-* when the
        // filename is the command); tools that only got skills are told their
        // documented skill invocation (Kimi Code: /skill:openspec-*; Codex CLI:
        // $openspec-*; others: /openspec-*). Tools that got no artifacts are
        // covered by the configuration correction instead. When the selection
        // disagrees, print one line per distinct instruction, labeled with the
        // tools it applies to.
        const startHintLines = (command) => {
            const hintToTools = new Map();
            for (const tool of successfulTools) {
                let hint;
                if (shouldGenerateCommandsForTool(tool.value, activeDelivery)) {
                    const transformer = getTransformerForTool(tool.value, activeDelivery, resolveCommandSurfaceCapability(tool.value), resolveCommandInvocation(tool.value));
                    hint = `Start your first change: ${transformer ? transformer(command) : command} "your idea"`;
                }
                else if (shouldGenerateSkillsForTool(tool.value, activeDelivery)) {
                    const skillReference = getSkillReferenceTransformer(tool.value)(command);
                    // Tools with no slash surface (e.g. Rovo Dev) reference skills as
                    // prose ("the openspec-propose skill"); phrase the hint so it reads
                    // as an instruction rather than a dead command with an argument.
                    hint = usesNaturalLanguageSkillReferences(tool.value)
                        ? `Start your first change: ask ${tool.name} to use ${skillReference} with "your idea"`
                        : `Start your first change: ${skillReference} "your idea"`;
                }
                else {
                    continue;
                }
                hintToTools.set(hint, [...(hintToTools.get(hint) ?? []), tool.name]);
            }
            if (hintToTools.size === 0) {
                // No successful tools: keep the generic command hint
                return [`Start your first change: ${command} "your idea"`];
            }
            if (hintToTools.size === 1) {
                return [[...hintToTools.keys()][0]];
            }
            return [...hintToTools.entries()].map(([hint, toolNames]) => `${hint} (${toolNames.join(', ')})`);
        };
        const printStartHints = (command) => {
            console.log(chalk.bold('Getting started:'));
            for (const line of startHintLines(command)) {
                console.log(`  ${line}`);
            }
        };
        console.log();
        // delivery=commands with tools that only support skills: those tools get
        // no artifacts at all, so print a per-tool configuration correction
        // rather than leave them with a dead (or missing) instruction — even
        // when other selected tools did get commands or skills.
        const zeroArtifactTools = successfulTools.filter((tool) => !shouldGenerateSkillsForTool(tool.value, activeDelivery) &&
            !shouldGenerateCommandsForTool(tool.value, activeDelivery));
        if (zeroArtifactTools.length > 0) {
            const names = zeroArtifactTools.map((tool) => tool.name).join(', ');
            console.log(chalk.yellow(`No skills or commands were generated for ${names}: delivery is set to 'commands' but ` +
                `${zeroArtifactTools.length === 1 ? 'it supports' : 'they support'} only skills. ` +
                `Run 'openspec config set delivery both' to generate skills.`));
        }
        if (successfulTools.length > 0 && !commandsGenerated && !skillsGenerated) {
            // Nothing was generated for any tool: the correction above is the
            // whole story, so don't advertise an invocation that doesn't exist.
        }
        else if (activeWorkflows.includes('propose')) {
            printStartHints('/opsx:propose');
        }
        else if (activeWorkflows.includes('new')) {
            printStartHints('/opsx:new');
        }
        else {
            console.log("Done. Run 'openspec config profile' to configure your workflows.");
        }
        // Links
        console.log();
        console.log(`Learn more: ${chalk.cyan('https://github.com/Fission-AI/OpenSpec')}`);
        console.log(`Feedback:   ${chalk.cyan('https://github.com/Fission-AI/OpenSpec/issues')}`);
        // Restart instruction only when at least one IDE/editor-resident tool
        // actually received a generated surface. Two conditions, coupled to the SAME
        // tool: (1) its commands/skills are loaded by a long-running editor process
        // (CLI tools pick the files up immediately, so a restart line would be wrong
        // for them — see #1067), and (2) a surface was actually generated for it
        // under the active delivery (an IDE tool that generated nothing has nothing a
        // restart would pick up, even if a co-configured CLI tool did generate).
        // Wording follows what the IDE tool itself generated, not the global
        // aggregate: it must not say "commands" when the IDE tool only got skills
        // while a co-configured CLI tool got commands. Not "slash commands" either:
        // Amazon Q's generated files are prompt-library entries invoked with @, so a
        // restart line promising slash commands would be wrong for it.
        const restartCommandsGenerated = successfulTools.some((tool) => tool.requiresIdeRestart &&
            shouldGenerateCommandsForTool(tool.value, activeDelivery));
        const restartSkillsGenerated = successfulTools.some((tool) => tool.requiresIdeRestart &&
            shouldGenerateSkillsForTool(tool.value, activeDelivery));
        if (restartCommandsGenerated || restartSkillsGenerated) {
            console.log();
            console.log(chalk.white(restartCommandsGenerated
                ? 'Restart your IDE for the new commands to take effect.'
                : 'Restart your IDE for the new skills to take effect.'));
        }
        console.log();
    }
    startSpinner(text) {
        return ora({
            text,
            stream: process.stdout,
            color: 'gray',
            spinner: PROGRESS_SPINNER,
        }).start();
    }
    async removeSkillDirs(skillsRoot, skillsDir) {
        let removed = 0;
        for (const workflow of ALL_WORKFLOWS) {
            const dirName = WORKFLOW_TO_SKILL_DIR[workflow];
            if (!dirName)
                continue;
            const skillDir = path.join(skillsDir, dirName);
            if (!fs.existsSync(skillDir))
                continue;
            FileSystemUtils.assertPathWithin(skillsRoot, skillDir);
            try {
                await fs.promises.rm(skillDir, { recursive: true, force: true });
                removed++;
            }
            catch {
                // Ignore errors
            }
        }
        return removed;
    }
    async removeCommandFiles(projectPath, toolId) {
        let removed = 0;
        const adapter = CommandAdapterRegistry.get(toolId);
        if (!adapter)
            return 0;
        for (const workflow of ALL_WORKFLOWS) {
            const cmdPath = adapter.getFilePath(workflow);
            const fullPath = FileSystemUtils.resolveProjectArtifactPath(projectPath, cmdPath);
            try {
                if (fs.existsSync(fullPath)) {
                    await fs.promises.unlink(fullPath);
                    removed++;
                }
            }
            catch {
                // Ignore errors
            }
        }
        return removed;
    }
}
//# sourceMappingURL=init.js.map