@dedesfr/prompter 0.9.0 → 1.0.0

package/src/commands/init.ts

@@ -1,597 +0,0 @@
-import { promises as fs } from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import chalk from 'chalk';
-import { checkbox, Separator } from '@inquirer/prompts';
-import { PROMPTER_DIR, SUPPORTED_TOOLS, PrompterConfig } from '../core/config.js';
-import { projectTemplate, agentsTemplate, claudeTemplate } from '../core/templates/index.js';
-import { registry } from '../core/configurators/slash/index.js';
-import { discoverSkills, SkillMetadata } from '../core/skill-discovery.js';
-
-interface InitOptions {
-    tools?: string[];
-    skills?: string[];
-    noInteractive?: boolean;
-}
-
-export class InitCommand {
-    private truncateDescription(desc: string, max = 72): string {
-        return desc.length > max ? desc.slice(0, max - 1) + '…' : desc;
-    }
-
-    private getCategorizedSkillChoices(availableSkills: SkillMetadata[], currentSkillNames: string[]): any[] {
-        const categories = [
-            {
-                name: '📋 Planning & Strategy',
-                skills: ['project-orchestrator', 'feature-planner', 'prd-generator', 'prd-agent-generator', 'product-brief']
-            },
-            {
-                name: '🎯 Agile & Backlog',
-                skills: ['epic-single', 'epic-generator', 'story-single', 'story-generator']
-            },
-            {
-                name: '📐 Specification & Architecture',
-                skills: ['fsd-generator', 'tdd-generator', 'tdd-lite-generator', 'erd-generator', 'api-contract-generator']
-            },
-            {
-                name: '🎨 Design & UI/UX',
-                skills: ['ui-ux-pro', 'design-system-generator', 'design-system', 'wireframe-generator', 'design-md', 'frontend-design']
-            },
-            {
-                name: '⚙️ Development & Code Review',
-                skills: ['code-review', 'laravel-code-review', 'mcp-builder', 'skill-creator']
-            },
-            {
-                name: '✅ Testing & QA',
-                skills: ['qa-test-scenario']
-            },
-            {
-                name: '⚡ Prompter Workflow',
-                skills: ['prompter-workflow', 'prompter-specs', 'proposal', 'apply', 'archive']
-            },
-            {
-                name: '📝 Documentation',
-                skills: ['doc-builder', 'document-translator', 'document-explainer', 'ai-context-generator', 'meeting-notes', 'sph-generator']
-            },
-            {
-                name: '✨ Content & Productivity',
-                skills: ['enhance', 'enhance-prompt', 'ai-humanizer', 'gamma-builder', 'cerebro']
-            }
-        ];
-
-        const categorized = new Set<string>();
-        const choices: any[] = [];
-
-        for (const category of categories) {
-            const skillsInCategory = category.skills
-                .map(name => availableSkills.find(s => s.name === name))
-                .filter((s): s is SkillMetadata => !!s);
-
-            if (skillsInCategory.length === 0) continue;
-
-            choices.push(new Separator(chalk.bold.cyan(category.name)));
-            for (const skill of skillsInCategory) {
-                categorized.add(skill.name);
-                choices.push({
-                    name: `  ${skill.name} ${chalk.gray('- ' + this.truncateDescription(skill.description))}`,
-                    value: skill.name,
-                    checked: currentSkillNames.includes(skill.name)
-                });
-            }
-        }
-
-        // Uncategorized skills
-        const uncategorized = availableSkills.filter(s => !categorized.has(s.name));
-        if (uncategorized.length > 0) {
-            choices.push(new Separator(chalk.bold.cyan('🔧 Other')));
-            for (const skill of uncategorized) {
-                choices.push({
-                    name: `  ${skill.name} ${chalk.gray('- ' + this.truncateDescription(skill.description))}`,
-                    value: skill.name,
-                    checked: currentSkillNames.includes(skill.name)
-                });
-            }
-        }
-
-        return choices;
-    }
-
-    async execute(options: InitOptions = {}): Promise<void> {
-        const projectPath = process.cwd();
-        const isReInitialization = await PrompterConfig.prompterDirExists(projectPath);
-
-        // Display ASCII art banner for initial setup
-        if (!isReInitialization) {
-            console.log(chalk.cyan(`
- ██████  ██████   ██████  ███    ███ ██████  ████████ ███████ ██████  
- ██   ██ ██   ██ ██    ██ ████  ████ ██   ██    ██    ██      ██   ██ 
- ██████  ██████  ██    ██ ██ ████ ██ ██████     ██    █████   ██████  
- ██      ██   ██ ██    ██ ██  ██  ██ ██         ██    ██      ██   ██ 
- ██      ██   ██  ██████  ██      ██ ██         ██    ███████ ██   ██ 
-`));
-            console.log(chalk.white.bold('Welcome to Prompter!\n'));
-        }
-
-        if (isReInitialization) {
-            console.log(chalk.blue('\n🔄 Re-configuring Prompter tools...\n'));
-        } else {
-            console.log(chalk.blue('🚀 Initializing Prompter...\n'));
-        }
-
-        // Detect currently configured tools if re-initializing
-        let currentTools: string[] = [];
-        if (isReInitialization) {
-            currentTools = await this.detectConfiguredTools(projectPath);
-            if (currentTools.length > 0) {
-                console.log(chalk.gray('Currently configured tools: ') + chalk.cyan(currentTools.map(t => {
-                    const tool = SUPPORTED_TOOLS.find(st => st.value === t);
-                    return tool ? tool.name : t;
-                }).join(', ')));
-                console.log();
-            }
-        }
-
-        // Select tools
-        let selectedTools: string[] = [];
-
-        if (options.tools && options.tools.length > 0) {
-            // Handle comma-separated values in a single string or array of strings
-            selectedTools = options.tools.flatMap(tool => tool.split(',').map(t => t.trim()));
-        } else if (!options.noInteractive) {
-            try {
-                const message = isReInitialization 
-                    ? 'Select AI tools to configure (check/uncheck to add/remove):'
-                    : 'Select AI tools to configure:';
-                
-                selectedTools = await checkbox({
-                    message,
-                    choices: SUPPORTED_TOOLS.map(tool => ({
-                        name: tool.name,
-                        value: tool.value,
-                        checked: isReInitialization 
-                            ? currentTools.includes(tool.value) 
-                            : tool.value === 'antigravity' // Default check Antigravity for new init
-                    }))
-                });
-            } catch (error) {
-                // User cancelled
-                console.log(chalk.yellow(isReInitialization ? '\nRe-configuration cancelled.' : '\nInitialization cancelled.'));
-                return;
-            }
-        } else if (isReInitialization && selectedTools.length === 0) {
-            // In non-interactive re-init without tools specified, keep current tools
-            selectedTools = currentTools;
-        }
-
-        // Select skills — resolve from the package directory, not the user's project
-        // dist/commands/init.js → go up two levels to reach the package root
-        const packageDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
-        const availableSkills = await discoverSkills(path.join(packageDir, 'skills'));
-        let selectedSkills: SkillMetadata[] = [];
-
-        if (options.skills && options.skills.length > 0) {
-            const requestedNames = options.skills.flatMap(s => s.split(',').map(s => s.trim()));
-            selectedSkills = availableSkills.filter(s => requestedNames.includes(s.name));
-        } else if (!options.noInteractive && availableSkills.length > 0) {
-            try {
-                const prompterPathForDetection = path.join(projectPath, PROMPTER_DIR);
-                const currentSkillNames = await this.detectInstalledSkills(prompterPathForDetection);
-
-                const selectedSkillNames = await checkbox({
-                    message: 'Select skills to install:',
-                    choices: this.getCategorizedSkillChoices(availableSkills, currentSkillNames),
-                    pageSize: 20
-                });
-                selectedSkills = availableSkills.filter(s => selectedSkillNames.includes(s.name));
-            } catch (error) {
-                // User cancelled
-                console.log(chalk.yellow(isReInitialization ? '\nRe-configuration cancelled.' : '\nInitialization cancelled.'));
-                return;
-            }
-        }
-
-        // Create or ensure prompter directory
-        const prompterPath = await PrompterConfig.ensurePrompterDir(projectPath);
-        if (!isReInitialization) {
-            console.log(chalk.green('✓') + ` Created ${chalk.cyan(PROMPTER_DIR + '/')}`);
-        }
-
-        // Create project.md if not exists
-        const projectMdPath = path.join(prompterPath, 'project.md');
-        const projectMdExists = await this.fileExists(projectMdPath);
-        if (!projectMdExists) {
-            try {
-                if (!projectTemplate) {
-                    throw new Error('project.md template is undefined');
-                }
-                await fs.writeFile(projectMdPath, projectTemplate, 'utf-8');
-                console.log(chalk.green('✓') + ` Created ${chalk.cyan(PROMPTER_DIR + '/project.md')}`);
-            } catch (error) {
-                console.error(chalk.red('✗') + ` Failed to create project.md: ${error}`);
-            }
-        } else if (isReInitialization) {
-            console.log(chalk.gray('  project.md already exists, keeping it'));
-        }
-
-        // Create or update AGENTS.md for universal support
-        const agentsMdPath = path.join(prompterPath, 'AGENTS.md');
-        const agentsExists = await this.fileExists(agentsMdPath);
-        try {
-            if (!agentsTemplate) {
-                throw new Error('AGENTS.md template is undefined');
-            }
-            await fs.writeFile(agentsMdPath, agentsTemplate, 'utf-8');
-            if (!agentsExists) {
-                console.log(chalk.green('✓') + ` Created ${chalk.cyan(PROMPTER_DIR + '/AGENTS.md')}`);
-            } else if (isReInitialization) {
-                console.log(chalk.green('✓') + ` Updated ${chalk.cyan(PROMPTER_DIR + '/AGENTS.md')}`);
-            }
-        } catch (error) {
-            console.error(chalk.red('✗') + ` Failed to ${agentsExists ? 'update' : 'create'} AGENTS.md: ${error}`);
-        }
-
-        // Create or update CLAUDE.md for Claude Code support
-        const claudeMdPath = path.join(prompterPath, 'CLAUDE.md');
-        const claudeExists = await this.fileExists(claudeMdPath);
-        try {
-            if (!claudeTemplate) {
-                throw new Error('CLAUDE.md template is undefined');
-            }
-            await fs.writeFile(claudeMdPath, claudeTemplate, 'utf-8');
-            if (!claudeExists) {
-                console.log(chalk.green('✓') + ` Created ${chalk.cyan(PROMPTER_DIR + '/CLAUDE.md')}`);
-            } else if (isReInitialization) {
-                console.log(chalk.green('✓') + ` Updated ${chalk.cyan(PROMPTER_DIR + '/CLAUDE.md')}`);
-            }
-        } catch (error) {
-            console.error(chalk.red('✗') + ` Failed to ${claudeExists ? 'update' : 'create'} CLAUDE.md: ${error}`);
-        }
-
-        // Ensure root AGENTS.md has Prompter instructions
-        await this.ensureRootAgentsFile(projectPath);
-
-        // Ensure root CLAUDE.md has Prompter instructions
-        await this.ensureRootClaudeFile(projectPath);
-
-        // Handle tool changes
-        const toolsToAdd = selectedTools.filter(t => !currentTools.includes(t));
-        const toolsToRemove = currentTools.filter(t => !selectedTools.includes(t));
-        const toolsToKeep = selectedTools.filter(t => currentTools.includes(t));
-
-        // Remove old tool files
-        if (toolsToRemove.length > 0) {
-            console.log(chalk.blue('\n🗑️  Removing workflow files...\n'));
-            for (const toolId of toolsToRemove) {
-                const configurator = registry.get(toolId);
-                if (configurator) {
-                    try {
-                        const files = await this.removeToolFiles(projectPath, configurator);
-                        for (const file of files) {
-                            console.log(chalk.yellow('✓') + ` Removed ${chalk.cyan(file)}`);
-                        }
-                    } catch (error) {
-                        console.log(chalk.red('✗') + ` Failed to remove files for ${toolId}: ${error}`);
-                    }
-                }
-            }
-        }
-
-        // Show kept tools
-        if (isReInitialization && toolsToKeep.length > 0 && (toolsToAdd.length > 0 || toolsToRemove.length > 0)) {
-            console.log(chalk.blue('\n✨ Keeping existing tools:\n'));
-            for (const toolId of toolsToKeep) {
-                const tool = SUPPORTED_TOOLS.find(t => t.value === toolId);
-                if (tool) {
-                    console.log(chalk.gray('  • ') + chalk.cyan(tool.name));
-                }
-            }
-        }
-
-        // --- Skills setup ---
-        const skillChanges = await this.setupSkills(projectPath, prompterPath, selectedTools, selectedSkills);
-
-        // Success message
-        if (isReInitialization) {
-            console.log(chalk.green('\n✅ Prompter tools updated successfully!\n'));
-            if (toolsToAdd.length > 0 || toolsToRemove.length > 0 || skillChanges.added.length > 0 || skillChanges.removed.length > 0) {
-                console.log(chalk.blue('Summary:'));
-                if (toolsToAdd.length > 0) {
-                    console.log(chalk.green('  Tools Added: ') + toolsToAdd.map(t => {
-                        const tool = SUPPORTED_TOOLS.find(st => st.value === t);
-                        return tool ? tool.name : t;
-                    }).join(', '));
-                }
-                if (toolsToRemove.length > 0) {
-                    console.log(chalk.yellow('  Tools Removed: ') + toolsToRemove.map(t => {
-                        const tool = SUPPORTED_TOOLS.find(st => st.value === t);
-                        return tool ? tool.name : t;
-                    }).join(', '));
-                }
-                if (skillChanges.added.length > 0) {
-                    console.log(chalk.green('  Skills Added: ') + skillChanges.added.join(', '));
-                }
-                if (skillChanges.removed.length > 0) {
-                    console.log(chalk.yellow('  Skills Removed: ') + skillChanges.removed.join(', '));
-                }
-                console.log();
-            } else {
-                console.log(chalk.gray('  No changes made.\n'));
-            }
-        } else {
-            console.log(chalk.green('\n✅ Prompter initialized successfully!\n'));
-            if (skillChanges.added.length > 0) {
-                console.log(chalk.gray(`Installed ${skillChanges.added.length} skill(s).\n`));
-            }
-            console.log(chalk.gray('Run `prompter guide` for next steps.\n'));
-        }
-    }
-
-    private async fileExists(filePath: string): Promise<boolean> {
-        try {
-            await fs.access(filePath);
-            return true;
-        } catch {
-            return false;
-        }
-    }
-
-    private async detectConfiguredTools(projectPath: string): Promise<string[]> {
-        const configuredTools: string[] = [];
-        const allConfigurators = registry.getAll();
-
-        for (const configurator of allConfigurators) {
-            const skillsRoot = path.join(projectPath, configurator.getSkillsRootDir());
-            try {
-                const stat = await fs.stat(skillsRoot);
-                if (stat.isDirectory()) configuredTools.push(configurator.toolId);
-            } catch {
-                // directory doesn't exist — tool not configured
-            }
-        }
-
-        return configuredTools;
-    }
-
-    private async removeToolFiles(projectPath: string, configurator: any): Promise<string[]> {
-        await configurator.removeAllDeployedSkills(projectPath);
-        return [configurator.getSkillsRootDir() + '/'];
-    }
-
-
-
-    private async ensureRootClaudeFile(projectPath: string): Promise<void> {
-        const rootClaudePath = path.join(projectPath, 'CLAUDE.md');
-        const instructionsBlock = `<!-- PROMPTER:START -->
-# Prompter Instructions
-
-These instructions are for AI assistants working in this project.
-
-Always open \`@/prompter/CLAUDE.md\` when the request:
-- Mentions planning or proposals (words like proposal, spec, change, plan)
-- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
-- Sounds ambiguous and you need the authoritative spec before coding
-
-Use \`@/prompter/CLAUDE.md\` to learn:
-- How to create and apply change proposals
-- Spec format and conventions
-- Project structure and guidelines
-- Show Remaining Tasks
-
-<!-- PROMPTER:END -->`;
-
-        const rootClaudeExists = await this.fileExists(rootClaudePath);
-
-        if (!rootClaudeExists) {
-            await fs.writeFile(rootClaudePath, instructionsBlock + '\n', 'utf-8');
-            console.log(chalk.green('✓') + ` Created ${chalk.cyan('CLAUDE.md')} in root`);
-        } else {
-            const content = await fs.readFile(rootClaudePath, 'utf-8');
-            const startMarker = '<!-- PROMPTER:START -->';
-            const endMarker = '<!-- PROMPTER:END -->';
-            const startIndex = content.indexOf(startMarker);
-            const endIndex = content.indexOf(endMarker);
-
-            if (startIndex === -1 || endIndex === -1) {
-                const updatedContent = instructionsBlock + '\n\n' + content;
-                await fs.writeFile(rootClaudePath, updatedContent, 'utf-8');
-                console.log(chalk.green('✓') + ` Added Prompter instructions to ${chalk.cyan('CLAUDE.md')}`);
-            } else {
-                const before = content.substring(0, startIndex);
-                const after = content.substring(endIndex + endMarker.length);
-                const updatedContent = before + instructionsBlock + after;
-                await fs.writeFile(rootClaudePath, updatedContent, 'utf-8');
-                console.log(chalk.gray('  CLAUDE.md instructions block already exists, updated'));
-            }
-        }
-    }
-
-    private async setupSkills(
-        projectPath: string,
-        prompterPath: string,
-        selectedTools: string[],
-        selectedSkills: SkillMetadata[]
-    ): Promise<{ added: string[]; removed: string[] }> {
-        const result = { added: [] as string[], removed: [] as string[] };
-
-        const installedSkillNames = await this.detectInstalledSkills(prompterPath);
-        const selectedSkillNames = selectedSkills.map(s => s.name);
-
-        const skillsToAdd = selectedSkills.filter(s => !installedSkillNames.includes(s.name));
-        const skillsToRemove = installedSkillNames.filter(n => !selectedSkillNames.includes(n));
-        const skillsToKeep = selectedSkills.filter(s => installedSkillNames.includes(s.name));
-
-        const skillsTargetDir = path.join(prompterPath, 'skills');
-
-        // Remove deselected skills
-        if (skillsToRemove.length > 0) {
-            console.log(chalk.blue('\n🗑️  Removing skills...\n'));
-
-            for (const skillName of skillsToRemove) {
-                const staleDir = path.join(skillsTargetDir, skillName);
-                try {
-                    await fs.rm(staleDir, { recursive: true, force: true });
-                    console.log(chalk.yellow('✓') + ` Removed skill ${chalk.cyan(skillName)}`);
-                    result.removed.push(skillName);
-                } catch {
-                    // ignore
-                }
-
-                for (const toolId of selectedTools) {
-                    const configurator = registry.get(toolId);
-                    if (!configurator) continue;
-                    const removed = await configurator.removeSkillFiles(projectPath, [skillName]);
-                    for (const file of removed) {
-                        console.log(chalk.yellow('✓') + ` Removed ${chalk.cyan(file)}`);
-                    }
-                }
-            }
-        }
-
-        // Install new skills
-        if (skillsToAdd.length > 0) {
-            console.log(chalk.blue('\n🧩 Installing skills...\n'));
-            await fs.mkdir(skillsTargetDir, { recursive: true });
-
-            for (const skill of skillsToAdd) {
-                const targetDir = path.join(skillsTargetDir, skill.name);
-                try {
-                    await this.copyDirectory(skill.sourcePath, targetDir);
-                    console.log(chalk.green('✓') + ` Installed skill ${chalk.cyan(skill.name)}`);
-                    result.added.push(skill.name);
-                } catch (error) {
-                    console.log(chalk.red('✗') + ` Failed to install skill ${skill.name}: ${error}`);
-                }
-            }
-
-            if (selectedTools.length > 0) {
-                console.log(chalk.blue('\n📝 Creating skill workflow files...\n'));
-                for (const toolId of selectedTools) {
-                    const configurator = registry.get(toolId);
-                    if (!configurator) continue;
-                    try {
-                        const files = await configurator.generateSkills(projectPath, skillsToAdd);
-                        for (const file of files) {
-                            console.log(chalk.green('✓') + ` Created ${chalk.cyan(file)}`);
-                        }
-                    } catch (error) {
-                        console.log(chalk.red('✗') + ` Failed to create skill files for ${toolId}: ${error}`);
-                    }
-                }
-            }
-        }
-
-        // Update kept skills
-        if (skillsToKeep.length > 0) {
-            await fs.mkdir(skillsTargetDir, { recursive: true });
-
-            for (const skill of skillsToKeep) {
-                const targetDir = path.join(skillsTargetDir, skill.name);
-                try {
-                    await this.copyDirectory(skill.sourcePath, targetDir);
-                } catch {
-                    // ignore update errors
-                }
-            }
-
-            for (const toolId of selectedTools) {
-                const configurator = registry.get(toolId);
-                if (!configurator) continue;
-                try {
-                    await configurator.generateSkills(projectPath, skillsToKeep);
-                } catch {
-                    // ignore
-                }
-            }
-        }
-
-        return result;
-    }
-
-    private async detectInstalledSkills(prompterPath: string): Promise<string[]> {
-        const skillsDir = path.join(prompterPath, 'skills');
-        const names: string[] = [];
-
-        try {
-            const entries = await fs.readdir(skillsDir, { withFileTypes: true });
-            for (const entry of entries) {
-                if (!entry.isDirectory()) continue;
-                const skillMdPath = path.join(skillsDir, entry.name, 'SKILL.md');
-                if (await this.fileExists(skillMdPath)) {
-                    names.push(entry.name);
-                }
-            }
-        } catch {
-            // skills directory doesn't exist yet
-        }
-
-        return names;
-    }
-
-    private async copyDirectory(src: string, dest: string): Promise<void> {
-        await fs.mkdir(dest, { recursive: true });
-        const entries = await fs.readdir(src, { withFileTypes: true });
-
-        for (const entry of entries) {
-            const srcPath = path.join(src, entry.name);
-            const destPath = path.join(dest, entry.name);
-
-            if (entry.isDirectory()) {
-                await this.copyDirectory(srcPath, destPath);
-            } else {
-                await fs.copyFile(srcPath, destPath);
-            }
-        }
-    }
-
-    private async ensureRootAgentsFile(projectPath: string): Promise<void> {
-        const rootAgentsPath = path.join(projectPath, 'AGENTS.md');
-        const instructionsBlock = `<!-- PROMPTER:START -->
-# Prompter Instructions
-
-These instructions are for AI assistants working in this project.
-
-Always open \`@/prompter/AGENTS.md\` when the request:
-- Mentions planning or proposals (words like proposal, spec, change, plan)
-- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
-- Sounds ambiguous and you need the authoritative spec before coding
-
-Use \`@/prompter/AGENTS.md\` to learn:
-- How to create and apply change proposals
-- Spec format and conventions
-- Project structure and guidelines
-- Show Remaining Tasks
-
-<!-- PROMPTER:END -->`;
-
-        const rootAgentsExists = await this.fileExists(rootAgentsPath);
-        
-        if (!rootAgentsExists) {
-            // Create new file with instructions block
-            await fs.writeFile(rootAgentsPath, instructionsBlock + '\n', 'utf-8');
-            console.log(chalk.green('✓') + ` Created ${chalk.cyan('AGENTS.md')} in root`);
-        } else {
-            // Read existing file
-            const content = await fs.readFile(rootAgentsPath, 'utf-8');
-            
-            // Check if instructions block already exists
-            const startMarker = '<!-- PROMPTER:START -->';
-            const endMarker = '<!-- PROMPTER:END -->';
-            const startIndex = content.indexOf(startMarker);
-            const endIndex = content.indexOf(endMarker);
-            
-            if (startIndex === -1 || endIndex === -1) {
-                // Add instructions block at the top
-                const updatedContent = instructionsBlock + '\n\n' + content;
-                await fs.writeFile(rootAgentsPath, updatedContent, 'utf-8');
-                console.log(chalk.green('✓') + ` Added Prompter instructions to ${chalk.cyan('AGENTS.md')}`);
-            } else {
-                // Replace existing block
-                const before = content.substring(0, startIndex);
-                const after = content.substring(endIndex + endMarker.length);
-                const updatedContent = before + instructionsBlock + after;
-                await fs.writeFile(rootAgentsPath, updatedContent, 'utf-8');
-                console.log(chalk.gray('  AGENTS.md instructions block already exists, updated'));
-            }
-        }
-    }
-}