@dynamicworks/br-openspec 1.3.1

package/dist/core/update.js

@@ -0,0 +1,538 @@
+/**
+ * Update Command
+ *
+ * Refreshes BR-OpenSpec skills and commands for configured tools.
+ * Supports profile-aware updates, delivery changes, migration, and smart update detection.
+ */
+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 { transformToHyphenCommands } from '../utils/command-references.js';
+import { AI_TOOLS, OPENSPEC_DIR_NAME } from './config.js';
+import { generateCommands, CommandAdapterRegistry, } from './command-generation/index.js';
+import { getToolVersionStatus, getSkillTemplates, getCommandContents, generateSkillContent, getToolsWithSkillsDir, } from './shared/index.js';
+import { detectLegacyArtifacts, cleanupLegacyArtifacts, formatCleanupSummary, formatDetectionSummary, getToolsFromLegacyArtifacts, } from './legacy-cleanup.js';
+import { isInteractive } from '../utils/interactive.js';
+import { getGlobalConfig } from './global-config.js';
+import { UPDATE_MESSAGES } from '../messages/index.js';
+import { getProfileWorkflows, ALL_WORKFLOWS } from './profiles.js';
+import { getAvailableTools } from './available-tools.js';
+import { WORKFLOW_TO_SKILL_DIR, getCommandConfiguredTools, getConfiguredToolsForProfileSync, getToolsNeedingProfileSync, } from './profile-sync-drift.js';
+import { scanInstalledWorkflows as scanInstalledWorkflowsShared, migrateIfNeeded as migrateIfNeededShared, } from './migration.js';
+const require = createRequire(import.meta.url);
+const { version: OPENSPEC_VERSION } = require('../../package.json');
+/**
+ * Scans installed workflow artifacts (skills and managed commands) across all configured tools.
+ * Returns the union of detected workflow IDs that match ALL_WORKFLOWS.
+ *
+ * Wrapper around the shared migration module's scanInstalledWorkflows that accepts tool IDs.
+ */
+export function scanInstalledWorkflows(projectPath, toolIds) {
+    const tools = toolIds
+        .map((id) => AI_TOOLS.find((t) => t.value === id))
+        .filter((t) => t != null);
+    return scanInstalledWorkflowsShared(projectPath, tools);
+}
+export class UpdateCommand {
+    force;
+    constructor(options = {}) {
+        this.force = options.force ?? false;
+    }
+    async execute(projectPath) {
+        const resolvedProjectPath = path.resolve(projectPath);
+        const openspecPath = path.join(resolvedProjectPath, OPENSPEC_DIR_NAME);
+        // 1. Check openspec directory exists
+        if (!await FileSystemUtils.directoryExists(openspecPath)) {
+            throw new Error(UPDATE_MESSAGES.noOpenspecDir);
+        }
+        // 2. Perform one-time migration if needed before any legacy upgrade generation.
+        // Use detected tool directories to preserve existing opsx skills/commands.
+        const detectedTools = getAvailableTools(resolvedProjectPath);
+        migrateIfNeededShared(resolvedProjectPath, detectedTools);
+        // 3. Read global config for profile/delivery
+        const globalConfig = getGlobalConfig();
+        const profile = globalConfig.profile ?? 'core';
+        const delivery = globalConfig.delivery ?? 'both';
+        const profileWorkflows = getProfileWorkflows(profile, globalConfig.workflows);
+        const desiredWorkflows = profileWorkflows.filter((workflow) => ALL_WORKFLOWS.includes(workflow));
+        const shouldGenerateSkills = delivery !== 'commands';
+        const shouldGenerateCommands = delivery !== 'skills';
+        // 4. Detect and handle legacy artifacts + upgrade legacy tools using effective config
+        const newlyConfiguredTools = await this.handleLegacyCleanup(resolvedProjectPath, desiredWorkflows, delivery);
+        // 5. Find configured tools
+        const configuredTools = getConfiguredToolsForProfileSync(resolvedProjectPath);
+        if (configuredTools.length === 0 && newlyConfiguredTools.length === 0) {
+            console.log(chalk.yellow(UPDATE_MESSAGES.noConfiguredTools));
+            console.log(chalk.dim(UPDATE_MESSAGES.runInitHint));
+            return;
+        }
+        // 6. Check version status for all configured tools
+        const commandConfiguredTools = getCommandConfiguredTools(resolvedProjectPath);
+        const commandConfiguredSet = new Set(commandConfiguredTools);
+        const toolStatuses = configuredTools.map((toolId) => {
+            const status = getToolVersionStatus(resolvedProjectPath, toolId, OPENSPEC_VERSION);
+            if (!status.configured && commandConfiguredSet.has(toolId)) {
+                return { ...status, configured: true };
+            }
+            return status;
+        });
+        const statusByTool = new Map(toolStatuses.map((status) => [status.toolId, status]));
+        // 7. Smart update detection
+        const toolsNeedingVersionUpdate = toolStatuses
+            .filter((s) => s.needsUpdate)
+            .map((s) => s.toolId);
+        const toolsNeedingConfigSync = getToolsNeedingProfileSync(resolvedProjectPath, desiredWorkflows, delivery, configuredTools);
+        const toolsToUpdateSet = new Set([
+            ...toolsNeedingVersionUpdate,
+            ...toolsNeedingConfigSync,
+        ]);
+        const toolsUpToDate = toolStatuses.filter((s) => !toolsToUpdateSet.has(s.toolId));
+        if (!this.force && toolsToUpdateSet.size === 0) {
+            // All tools are up to date
+            this.displayUpToDateMessage(toolStatuses);
+            // Still check for new tool directories and extra workflows
+            this.detectNewTools(resolvedProjectPath, configuredTools);
+            this.displayExtraWorkflowsNote(resolvedProjectPath, configuredTools, desiredWorkflows);
+            return;
+        }
+        // 8. Display update plan
+        if (this.force) {
+            console.log(UPDATE_MESSAGES.forceUpdating(configuredTools.length, configuredTools.join(', ')));
+        }
+        else {
+            this.displayUpdatePlan([...toolsToUpdateSet], statusByTool, toolsUpToDate);
+        }
+        console.log();
+        // 9. Determine what to generate based on delivery
+        const skillTemplates = shouldGenerateSkills ? getSkillTemplates(desiredWorkflows) : [];
+        const commandContents = shouldGenerateCommands ? getCommandContents(desiredWorkflows) : [];
+        // 10. Update tools (all if force, otherwise only those needing update)
+        const toolsToUpdate = this.force ? configuredTools : [...toolsToUpdateSet];
+        const updatedTools = [];
+        const failedTools = [];
+        let removedCommandCount = 0;
+        let removedSkillCount = 0;
+        let removedDeselectedCommandCount = 0;
+        let removedDeselectedSkillCount = 0;
+        for (const toolId of toolsToUpdate) {
+            const tool = AI_TOOLS.find((t) => t.value === toolId);
+            if (!tool?.skillsDir)
+                continue;
+            const spinner = ora(UPDATE_MESSAGES.updatingTool(tool.name)).start();
+            try {
+                const skillsDir = path.join(resolvedProjectPath, tool.skillsDir, 'skills');
+                // Generate skill files if delivery includes skills
+                if (shouldGenerateSkills) {
+                    for (const { template, dirName } of skillTemplates) {
+                        const skillDir = path.join(skillsDir, dirName);
+                        const skillFile = path.join(skillDir, 'SKILL.md');
+                        // Use hyphen-based command references for OpenCode
+                        const transformer = (tool.value === 'opencode' || tool.value === 'pi') ? transformToHyphenCommands : undefined;
+                        const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
+                        await FileSystemUtils.writeFile(skillFile, skillContent);
+                    }
+                    removedDeselectedSkillCount += await this.removeUnselectedSkillDirs(skillsDir, desiredWorkflows);
+                }
+                // Delete skill directories if delivery is commands-only
+                if (!shouldGenerateSkills) {
+                    removedSkillCount += await this.removeSkillDirs(skillsDir);
+                }
+                // 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 = path.isAbsolute(cmd.path) ? cmd.path : path.join(resolvedProjectPath, cmd.path);
+                            await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
+                        }
+                        removedDeselectedCommandCount += await this.removeUnselectedCommandFiles(resolvedProjectPath, toolId, desiredWorkflows);
+                    }
+                }
+                // Delete command files if delivery is skills-only
+                if (!shouldGenerateCommands) {
+                    removedCommandCount += await this.removeCommandFiles(resolvedProjectPath, toolId);
+                }
+                spinner.succeed(UPDATE_MESSAGES.updatedTool(tool.name));
+                updatedTools.push(tool.name);
+            }
+            catch (error) {
+                spinner.fail(UPDATE_MESSAGES.failedToUpdate(tool.name));
+                failedTools.push({
+                    name: tool.name,
+                    error: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+        // 11. Summary
+        console.log();
+        if (updatedTools.length > 0) {
+            console.log(chalk.green(UPDATE_MESSAGES.updated(updatedTools.join(', '), OPENSPEC_VERSION)));
+        }
+        if (failedTools.length > 0) {
+            console.log(chalk.red(UPDATE_MESSAGES.failed(failedTools.map(f => `${f.name} (${f.error})`).join(', '))));
+        }
+        if (removedCommandCount > 0) {
+            console.log(chalk.dim(UPDATE_MESSAGES.removedCommands(removedCommandCount)));
+        }
+        if (removedSkillCount > 0) {
+            console.log(chalk.dim(UPDATE_MESSAGES.removedSkills(removedSkillCount)));
+        }
+        if (removedDeselectedCommandCount > 0) {
+            console.log(chalk.dim(UPDATE_MESSAGES.removedDeselectedCommands(removedDeselectedCommandCount)));
+        }
+        if (removedDeselectedSkillCount > 0) {
+            console.log(chalk.dim(UPDATE_MESSAGES.removedDeselectedSkills(removedDeselectedSkillCount)));
+        }
+        // 12. Show onboarding message for newly configured tools from legacy upgrade
+        if (newlyConfiguredTools.length > 0) {
+            console.log();
+            console.log(chalk.bold(UPDATE_MESSAGES.gettingStarted));
+            console.log(UPDATE_MESSAGES.cmdNew);
+            console.log(UPDATE_MESSAGES.cmdContinue);
+            console.log(UPDATE_MESSAGES.cmdApply);
+            console.log();
+            console.log(UPDATE_MESSAGES.learnMore(chalk.cyan('https://github.com/dynamicworks-com-br/BR-OpenSpec')));
+        }
+        const configuredAndNewTools = [...new Set([...configuredTools, ...newlyConfiguredTools])];
+        // 13. Detect new tool directories not currently configured
+        this.detectNewTools(resolvedProjectPath, configuredAndNewTools);
+        // 14. Display note about extra workflows not in profile
+        this.displayExtraWorkflowsNote(resolvedProjectPath, configuredAndNewTools, desiredWorkflows);
+        // 15. List affected tools
+        if (updatedTools.length > 0) {
+            const toolDisplayNames = updatedTools;
+            console.log(chalk.dim(UPDATE_MESSAGES.toolsList(toolDisplayNames.join(', '))));
+        }
+        console.log();
+        console.log(chalk.dim(UPDATE_MESSAGES.restartIDE));
+    }
+    /**
+     * Display message when all tools are up to date.
+     */
+    displayUpToDateMessage(toolStatuses) {
+        const toolNames = toolStatuses.map((s) => s.toolId);
+        console.log(chalk.green(UPDATE_MESSAGES.allUpToDate(toolStatuses.length, OPENSPEC_VERSION)));
+        console.log(chalk.dim(UPDATE_MESSAGES.toolsList(toolNames.join(', '))));
+        console.log();
+        console.log(chalk.dim(UPDATE_MESSAGES.useForceHint));
+    }
+    /**
+     * Display the update plan showing which tools need updating.
+     */
+    displayUpdatePlan(toolsToUpdate, statusByTool, upToDate) {
+        const updates = toolsToUpdate.map((toolId) => {
+            const status = statusByTool.get(toolId);
+            if (status?.needsUpdate) {
+                const fromVersion = status.generatedByVersion ?? 'unknown';
+                return `${status.toolId} (${fromVersion} → ${OPENSPEC_VERSION})`;
+            }
+            return `${toolId} (config sync)`;
+        });
+        console.log(UPDATE_MESSAGES.updatingPlan(toolsToUpdate.length, updates.join(', ')));
+        if (upToDate.length > 0) {
+            const upToDateNames = upToDate.map((s) => s.toolId);
+            console.log(chalk.dim(UPDATE_MESSAGES.alreadyUpToDate(upToDateNames.join(', '))));
+        }
+    }
+    /**
+     * Detects new tool directories that aren't currently configured and displays a hint.
+     */
+    detectNewTools(projectPath, configuredTools) {
+        const availableTools = getAvailableTools(projectPath);
+        const configuredSet = new Set(configuredTools);
+        const newTools = availableTools.filter((t) => !configuredSet.has(t.value));
+        if (newTools.length > 0) {
+            const newToolNames = newTools.map((tool) => tool.name);
+            const isSingleTool = newToolNames.length === 1;
+            const toolNoun = isSingleTool ? UPDATE_MESSAGES.toolNoun : UPDATE_MESSAGES.toolsNoun;
+            const pronoun = isSingleTool ? UPDATE_MESSAGES.it : UPDATE_MESSAGES.them;
+            console.log();
+            console.log(chalk.yellow(UPDATE_MESSAGES.detectedNewTools(toolNoun, newToolNames.join(', '), pronoun)));
+        }
+    }
+    /**
+     * Displays a note about extra workflows installed that aren't in the current profile.
+     */
+    displayExtraWorkflowsNote(projectPath, configuredTools, profileWorkflows) {
+        const installedWorkflows = scanInstalledWorkflows(projectPath, configuredTools);
+        const profileSet = new Set(profileWorkflows);
+        const extraWorkflows = installedWorkflows.filter((w) => !profileSet.has(w));
+        if (extraWorkflows.length > 0) {
+            console.log(chalk.dim(UPDATE_MESSAGES.extraWorkflowsNote(extraWorkflows.length)));
+        }
+    }
+    /**
+     * Removes skill directories for workflows when delivery changed to commands-only.
+     * Returns the number of directories removed.
+     */
+    async removeSkillDirs(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);
+            try {
+                if (fs.existsSync(skillDir)) {
+                    await fs.promises.rm(skillDir, { recursive: true, force: true });
+                    removed++;
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        return removed;
+    }
+    /**
+     * Removes skill directories for workflows that are no longer selected in the active profile.
+     * Returns the number of directories removed.
+     */
+    async removeUnselectedSkillDirs(skillsDir, desiredWorkflows) {
+        const desiredSet = new Set(desiredWorkflows);
+        let removed = 0;
+        for (const workflow of ALL_WORKFLOWS) {
+            if (desiredSet.has(workflow))
+                continue;
+            const dirName = WORKFLOW_TO_SKILL_DIR[workflow];
+            if (!dirName)
+                continue;
+            const skillDir = path.join(skillsDir, dirName);
+            try {
+                if (fs.existsSync(skillDir)) {
+                    await fs.promises.rm(skillDir, { recursive: true, force: true });
+                    removed++;
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        return removed;
+    }
+    /**
+     * Removes command files for workflows when delivery changed to skills-only.
+     * Returns the number of files 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 = path.isAbsolute(cmdPath) ? cmdPath : path.join(projectPath, cmdPath);
+            try {
+                if (fs.existsSync(fullPath)) {
+                    await fs.promises.unlink(fullPath);
+                    removed++;
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        return removed;
+    }
+    /**
+     * Removes command files for workflows that are no longer selected in the active profile.
+     * Returns the number of files removed.
+     */
+    async removeUnselectedCommandFiles(projectPath, toolId, desiredWorkflows) {
+        let removed = 0;
+        const adapter = CommandAdapterRegistry.get(toolId);
+        if (!adapter)
+            return 0;
+        const desiredSet = new Set(desiredWorkflows);
+        for (const workflow of ALL_WORKFLOWS) {
+            if (desiredSet.has(workflow))
+                continue;
+            const cmdPath = adapter.getFilePath(workflow);
+            const fullPath = path.isAbsolute(cmdPath) ? cmdPath : path.join(projectPath, cmdPath);
+            try {
+                if (fs.existsSync(fullPath)) {
+                    await fs.promises.unlink(fullPath);
+                    removed++;
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        return removed;
+    }
+    /**
+     * Detect and handle legacy BR-OpenSpec artifacts.
+     * Unlike init, update warns but continues if legacy files found in non-interactive mode.
+     * Returns array of tool IDs that were newly configured during legacy upgrade.
+     */
+    async handleLegacyCleanup(projectPath, desiredWorkflows, delivery) {
+        // Detect legacy artifacts
+        const detection = await detectLegacyArtifacts(projectPath);
+        if (!detection.hasLegacyArtifacts) {
+            return []; // No legacy artifacts found
+        }
+        // Show what was detected
+        console.log();
+        console.log(formatDetectionSummary(detection));
+        console.log();
+        const canPrompt = isInteractive();
+        if (this.force) {
+            // --force flag: proceed with cleanup automatically
+            await this.performLegacyCleanup(projectPath, detection);
+            // Then upgrade legacy tools to new skills
+            return this.upgradeLegacyTools(projectPath, detection, canPrompt, desiredWorkflows, delivery);
+        }
+        if (!canPrompt) {
+            // Non-interactive mode without --force: warn and continue
+            // (Unlike init, update doesn't abort - user may just want to update skills)
+            console.log(chalk.yellow(UPDATE_MESSAGES.forceLegacyHint));
+            console.log();
+            return [];
+        }
+        // Interactive mode: prompt for confirmation
+        const { confirm } = await import('@inquirer/prompts');
+        const shouldCleanup = await confirm({
+            message: UPDATE_MESSAGES.upgradeLegacyPrompt,
+            default: true,
+        });
+        if (shouldCleanup) {
+            await this.performLegacyCleanup(projectPath, detection);
+            // Then upgrade legacy tools to new skills
+            return this.upgradeLegacyTools(projectPath, detection, canPrompt, desiredWorkflows, delivery);
+        }
+        else {
+            console.log(chalk.dim(UPDATE_MESSAGES.skippingLegacyCleanup));
+            console.log();
+            return [];
+        }
+    }
+    /**
+     * Perform cleanup of legacy artifacts.
+     */
+    async performLegacyCleanup(projectPath, detection) {
+        const spinner = ora(UPDATE_MESSAGES.cleaningLegacy).start();
+        const result = await cleanupLegacyArtifacts(projectPath, detection);
+        spinner.succeed(UPDATE_MESSAGES.legacyCleaned);
+        const summary = formatCleanupSummary(result);
+        if (summary) {
+            console.log();
+            console.log(summary);
+        }
+        console.log();
+    }
+    /**
+     * Upgrade legacy tools to new skills system.
+     * Returns array of tool IDs that were newly configured.
+     */
+    async upgradeLegacyTools(projectPath, detection, canPrompt, desiredWorkflows, delivery) {
+        // Get tools that had legacy artifacts
+        const legacyTools = getToolsFromLegacyArtifacts(detection);
+        if (legacyTools.length === 0) {
+            return [];
+        }
+        // Get currently configured tools
+        const configuredTools = getConfiguredToolsForProfileSync(projectPath);
+        const configuredSet = new Set(configuredTools);
+        // Filter to tools that aren't already configured
+        const unconfiguredLegacyTools = legacyTools.filter((t) => !configuredSet.has(t));
+        if (unconfiguredLegacyTools.length === 0) {
+            return [];
+        }
+        // Get valid tools (those with skillsDir)
+        const validToolIds = new Set(getToolsWithSkillsDir());
+        const validUnconfiguredTools = unconfiguredLegacyTools.filter((t) => validToolIds.has(t));
+        if (validUnconfiguredTools.length === 0) {
+            return [];
+        }
+        // Show what tools were detected from legacy artifacts
+        console.log(chalk.bold(UPDATE_MESSAGES.toolsDetectedFromLegacy));
+        for (const toolId of validUnconfiguredTools) {
+            const tool = AI_TOOLS.find((t) => t.value === toolId);
+            console.log(`  • ${tool?.name || toolId}`);
+        }
+        console.log();
+        let selectedTools;
+        if (this.force || !canPrompt) {
+            // Non-interactive with --force: auto-select detected tools
+            selectedTools = validUnconfiguredTools;
+            console.log(UPDATE_MESSAGES.setupSkillsFor(selectedTools.join(', ')));
+        }
+        else {
+            // Interactive mode: prompt for tool selection with detected tools pre-selected
+            const { searchableMultiSelect } = await import('../prompts/searchable-multi-select.js');
+            const sortedChoices = validUnconfiguredTools.map((toolId) => {
+                const tool = AI_TOOLS.find((t) => t.value === toolId);
+                return {
+                    name: tool?.name || toolId,
+                    value: toolId,
+                    configured: false,
+                    preSelected: true, // Pre-select all detected legacy tools
+                };
+            });
+            selectedTools = await searchableMultiSelect({
+                message: UPDATE_MESSAGES.selectToolsNewSkillSystem,
+                pageSize: 15,
+                choices: sortedChoices,
+                validate: (_selected) => true, // Allow empty selection (user can skip)
+            });
+            if (selectedTools.length === 0) {
+                console.log(chalk.dim(UPDATE_MESSAGES.skippingToolSetup));
+                console.log();
+                return [];
+            }
+        }
+        // Create skills/commands for selected tools using effective profile+delivery.
+        const newlyConfigured = [];
+        const shouldGenerateSkills = delivery !== 'commands';
+        const shouldGenerateCommands = delivery !== 'skills';
+        const skillTemplates = shouldGenerateSkills ? getSkillTemplates(desiredWorkflows) : [];
+        const commandContents = shouldGenerateCommands ? getCommandContents(desiredWorkflows) : [];
+        for (const toolId of selectedTools) {
+            const tool = AI_TOOLS.find((t) => t.value === toolId);
+            if (!tool?.skillsDir)
+                continue;
+            const spinner = ora(UPDATE_MESSAGES.settingUp(tool.name)).start();
+            try {
+                const skillsDir = path.join(projectPath, tool.skillsDir, 'skills');
+                // Create skill files when delivery includes skills
+                if (shouldGenerateSkills) {
+                    for (const { template, dirName } of skillTemplates) {
+                        const skillDir = path.join(skillsDir, dirName);
+                        const skillFile = path.join(skillDir, 'SKILL.md');
+                        // Use hyphen-based command references for OpenCode
+                        const transformer = (tool.value === 'opencode' || tool.value === 'pi') ? transformToHyphenCommands : undefined;
+                        const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
+                        await FileSystemUtils.writeFile(skillFile, skillContent);
+                    }
+                }
+                // Create commands when 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 = path.isAbsolute(cmd.path) ? cmd.path : path.join(projectPath, cmd.path);
+                            await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
+                        }
+                    }
+                }
+                spinner.succeed(UPDATE_MESSAGES.setupComplete(tool.name));
+                newlyConfigured.push(toolId);
+            }
+            catch (error) {
+                spinner.fail(UPDATE_MESSAGES.failedToSetup(tool.name));
+                console.log(chalk.red(`  ${error instanceof Error ? error.message : String(error)}`));
+            }
+        }
+        if (newlyConfigured.length > 0) {
+            console.log();
+        }
+        return newlyConfigured;
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/core/validation/constants.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Validation threshold constants
+ */
+export declare const MIN_WHY_SECTION_LENGTH = 50;
+export declare const MIN_PURPOSE_LENGTH = 50;
+export declare const MAX_WHY_SECTION_LENGTH = 1000;
+export declare const MAX_REQUIREMENT_TEXT_LENGTH = 500;
+export declare const MAX_DELTAS_PER_CHANGE = 10;
+export declare const VALIDATION_MESSAGES: {
+    readonly SCENARIO_EMPTY: "O texto do cenário não pode estar vazio";
+    readonly REQUIREMENT_EMPTY: "O texto do requisito não pode estar vazio";
+    readonly REQUIREMENT_NO_SHALL: "O requisito deve conter as palavras-chave SHALL ou MUST";
+    readonly REQUIREMENT_NO_SCENARIOS: "O requisito deve ter pelo menos um cenário";
+    readonly SPEC_NAME_EMPTY: "O nome da especificação não pode estar vazio";
+    readonly SPEC_PURPOSE_EMPTY: "A seção Purpose não pode estar vazia";
+    readonly SPEC_NO_REQUIREMENTS: "A especificação deve ter pelo menos um requisito";
+    readonly CHANGE_NAME_EMPTY: "O nome da alteração não pode estar vazio";
+    readonly CHANGE_WHY_TOO_SHORT: "A seção Why deve ter pelo menos 50 caracteres";
+    readonly CHANGE_WHY_TOO_LONG: "A seção Why não deve exceder 1000 caracteres";
+    readonly CHANGE_WHAT_EMPTY: "A seção What Changes não pode estar vazia";
+    readonly CHANGE_NO_DELTAS: "A alteração deve ter pelo menos um delta";
+    readonly CHANGE_TOO_MANY_DELTAS: "Considere dividir alterações com mais de 10 deltas";
+    readonly DELTA_SPEC_EMPTY: "O nome da especificação não pode estar vazio";
+    readonly DELTA_DESCRIPTION_EMPTY: "A descrição do delta não pode estar vazia";
+    readonly PURPOSE_TOO_BRIEF: "A seção Purpose é muito breve (menos de 50 caracteres)";
+    readonly REQUIREMENT_TOO_LONG: "O texto do requisito é muito longo (>500 caracteres). Considere dividi-lo.";
+    readonly DELTA_DESCRIPTION_TOO_BRIEF: "A descrição do delta é muito breve";
+    readonly DELTA_MISSING_REQUIREMENTS: "O delta deve incluir requisitos";
+    readonly GUIDE_NO_DELTAS: "Nenhum delta encontrado. Certifique-se de que a alteração possui um diretório specs/ com pastas de capacidade (ex: specs/http-server/spec.md) contendo arquivos .md que usam cabeçalhos de delta (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) e que cada requisito inclui pelo menos um bloco \"#### Scenario:\". Dica: execute \"openspec change show <change-id> --json --deltas-only\" para inspecionar os deltas analisados.";
+    readonly GUIDE_MISSING_SPEC_SECTIONS: "Seções obrigatórias ausentes. Cabeçalhos esperados: \"## Purpose\" e \"## Requirements\". Exemplo:\n## Purpose\n[breve propósito]\n\n## Requirements\n### Requirement: Declaração clara de requisito\nUsers SHALL ...\n\n#### Scenario: Nome descritivo\n- **WHEN** ...\n- **THEN** ...";
+    readonly GUIDE_MISSING_CHANGE_SECTIONS: "Seções obrigatórias ausentes. Cabeçalhos esperados: \"## Why\" e \"## What Changes\". Certifique-se de que os deltas estão documentados em specs/ usando cabeçalhos de delta.";
+    readonly GUIDE_SCENARIO_FORMAT: "Os cenários devem usar cabeçalhos de nível 4. Converta listas em:\n#### Scenario: Nome curto\n- **WHEN** ...\n- **THEN** ...\n- **AND** ...";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/validation/constants.js

@@ -0,0 +1,40 @@
+/**
+ * Validation threshold constants
+ */
+// Minimum character lengths
+export const MIN_WHY_SECTION_LENGTH = 50;
+export const MIN_PURPOSE_LENGTH = 50;
+// Maximum character/item limits
+export const MAX_WHY_SECTION_LENGTH = 1000;
+export const MAX_REQUIREMENT_TEXT_LENGTH = 500;
+export const MAX_DELTAS_PER_CHANGE = 10;
+// Validation messages
+export const VALIDATION_MESSAGES = {
+    // Required content
+    SCENARIO_EMPTY: 'O texto do cenário não pode estar vazio',
+    REQUIREMENT_EMPTY: 'O texto do requisito não pode estar vazio',
+    REQUIREMENT_NO_SHALL: 'O requisito deve conter as palavras-chave SHALL ou MUST',
+    REQUIREMENT_NO_SCENARIOS: 'O requisito deve ter pelo menos um cenário',
+    SPEC_NAME_EMPTY: 'O nome da especificação não pode estar vazio',
+    SPEC_PURPOSE_EMPTY: 'A seção Purpose não pode estar vazia',
+    SPEC_NO_REQUIREMENTS: 'A especificação deve ter pelo menos um requisito',
+    CHANGE_NAME_EMPTY: 'O nome da alteração não pode estar vazio',
+    CHANGE_WHY_TOO_SHORT: `A seção Why deve ter pelo menos ${MIN_WHY_SECTION_LENGTH} caracteres`,
+    CHANGE_WHY_TOO_LONG: `A seção Why não deve exceder ${MAX_WHY_SECTION_LENGTH} caracteres`,
+    CHANGE_WHAT_EMPTY: 'A seção What Changes não pode estar vazia',
+    CHANGE_NO_DELTAS: 'A alteração deve ter pelo menos um delta',
+    CHANGE_TOO_MANY_DELTAS: `Considere dividir alterações com mais de ${MAX_DELTAS_PER_CHANGE} deltas`,
+    DELTA_SPEC_EMPTY: 'O nome da especificação não pode estar vazio',
+    DELTA_DESCRIPTION_EMPTY: 'A descrição do delta não pode estar vazia',
+    // Warnings
+    PURPOSE_TOO_BRIEF: `A seção Purpose é muito breve (menos de ${MIN_PURPOSE_LENGTH} caracteres)`,
+    REQUIREMENT_TOO_LONG: `O texto do requisito é muito longo (>${MAX_REQUIREMENT_TEXT_LENGTH} caracteres). Considere dividi-lo.`,
+    DELTA_DESCRIPTION_TOO_BRIEF: 'A descrição do delta é muito breve',
+    DELTA_MISSING_REQUIREMENTS: 'O delta deve incluir requisitos',
+    // Guidance snippets (appended to primary messages for remediation)
+    GUIDE_NO_DELTAS: 'Nenhum delta encontrado. Certifique-se de que a alteração possui um diretório specs/ com pastas de capacidade (ex: specs/http-server/spec.md) contendo arquivos .md que usam cabeçalhos de delta (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) e que cada requisito inclui pelo menos um bloco "#### Scenario:". Dica: execute "openspec change show <change-id> --json --deltas-only" para inspecionar os deltas analisados.',
+    GUIDE_MISSING_SPEC_SECTIONS: 'Seções obrigatórias ausentes. Cabeçalhos esperados: "## Purpose" e "## Requirements". Exemplo:\n## Purpose\n[breve propósito]\n\n## Requirements\n### Requirement: Declaração clara de requisito\nUsers SHALL ...\n\n#### Scenario: Nome descritivo\n- **WHEN** ...\n- **THEN** ...',
+    GUIDE_MISSING_CHANGE_SECTIONS: 'Seções obrigatórias ausentes. Cabeçalhos esperados: "## Why" e "## What Changes". Certifique-se de que os deltas estão documentados em specs/ usando cabeçalhos de delta.',
+    GUIDE_SCENARIO_FORMAT: 'Os cenários devem usar cabeçalhos de nível 4. Converta listas em:\n#### Scenario: Nome curto\n- **WHEN** ...\n- **THEN** ...\n- **AND** ...',
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/validation/types.d.ts

@@ -0,0 +1,18 @@
+export type ValidationLevel = 'ERROR' | 'WARNING' | 'INFO';
+export interface ValidationIssue {
+    level: ValidationLevel;
+    path: string;
+    message: string;
+    line?: number;
+    column?: number;
+}
+export interface ValidationReport {
+    valid: boolean;
+    issues: ValidationIssue[];
+    summary: {
+        errors: number;
+        warnings: number;
+        info: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/validation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/validation/validator.d.ts

@@ -0,0 +1,33 @@
+import { ValidationReport } from './types.js';
+export declare class Validator {
+    private strictMode;
+    constructor(strictMode?: boolean);
+    validateSpec(filePath: string): Promise<ValidationReport>;
+    /**
+     * Validate spec content from a string (used for pre-write validation of rebuilt specs)
+     */
+    validateSpecContent(specName: string, content: string): Promise<ValidationReport>;
+    validateChange(filePath: string): Promise<ValidationReport>;
+    /**
+     * Validate delta-formatted spec files under a change directory.
+     * Enforces:
+     * - At least one delta across all files
+     * - ADDED/MODIFIED: each requirement has SHALL/MUST and at least one scenario
+     * - REMOVED: names only; no scenario/description required
+     * - RENAMED: pairs well-formed
+     * - No duplicates within sections; no cross-section conflicts per spec
+     */
+    validateChangeDeltaSpecs(changeDir: string): Promise<ValidationReport>;
+    private convertZodErrors;
+    private applySpecRules;
+    private applyChangeRules;
+    private enrichTopLevelError;
+    private extractNameFromPath;
+    private createReport;
+    isValid(report: ValidationReport): boolean;
+    private extractRequirementText;
+    private containsShallOrMust;
+    private countScenarios;
+    private formatSectionList;
+}
+//# sourceMappingURL=validator.d.ts.map