ai-phase-builder 1.0.0

package/dist/cli/commands/init.js

@@ -0,0 +1,249 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import boxen from 'boxen';
+import { loadGlobalConfig, loadProjectConfig, saveProjectConfig, getProjectPhasesDir, runSetupWizard, } from '../../core/config-manager.js';
+import { createInitialState, saveProjectState } from '../../core/state-manager.js';
+import { initGitRepo, getBaseCommit } from '../../core/git-integration.js';
+import { refineCommand } from './refine.js';
+export async function initCommand(options) {
+    // Check for global config first
+    let globalConfig = await loadGlobalConfig();
+    if (!globalConfig || !globalConfig.setup_complete) {
+        globalConfig = await runSetupWizard();
+    }
+    // Check if already initialized
+    const existingConfig = await loadProjectConfig();
+    if (existingConfig) {
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'overwrite',
+                message: 'This project is already initialized. Reinitialize?',
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            console.log(chalk.dim('Initialization cancelled.'));
+            return;
+        }
+    }
+    console.log(boxen(chalk.bold.cyan('🚀 Initialize AI Phase Builder'), {
+        padding: 1,
+        margin: { top: 1, bottom: 1, left: 0, right: 0 },
+        borderStyle: 'round',
+        borderColor: 'cyan',
+    }));
+    // Gather project info
+    const projectName = path.basename(process.cwd());
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Project name:',
+            default: projectName,
+        },
+        {
+            type: 'list',
+            name: 'ui_library',
+            message: 'UI library:',
+            choices: ['shadcn', 'radix', 'chakra', 'none'],
+            default: options.ui || globalConfig.defaults.ui_library,
+        },
+        {
+            type: 'list',
+            name: 'design_system',
+            message: 'Design principles:',
+            choices: ['vercel', 'apple', 'material', 'custom'],
+            default: options.design || globalConfig.defaults.design_system,
+        },
+    ]);
+    const spinner = ora('Setting up project structure...').start();
+    try {
+        // Create directory structure
+        const phasesDir = getProjectPhasesDir();
+        await fs.ensureDir(phasesDir);
+        await fs.ensureDir(path.join(phasesDir, 'phases'));
+        await fs.ensureDir(path.join(phasesDir, 'logs'));
+        await fs.ensureDir(path.join(phasesDir, 'templates'));
+        // Create project config
+        const projectConfig = {
+            project_name: answers.name,
+            created_at: new Date().toISOString(),
+            ui_library: answers.ui_library,
+            design_system: answers.design_system,
+            total_phases: 0,
+            current_phase: 0,
+            current_attempt: 0,
+            status: 'planning',
+        };
+        await saveProjectConfig(projectConfig);
+        // Create initial templates
+        await createTemplates(phasesDir, answers.ui_library, answers.design_system);
+        // Initialize git if needed
+        await initGitRepo();
+        // Create initial state
+        const baseCommit = await getBaseCommit();
+        const state = await createInitialState(answers.name, options.fromIdea || '');
+        state.git_base_commit = baseCommit;
+        await saveProjectState(state);
+        // Create context.md
+        await createContextFile(phasesDir, answers);
+        spinner.succeed('Project structure created!');
+        // Show summary
+        console.log(chalk.green('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(chalk.green.bold('  ✅ Project Initialized!'));
+        console.log(chalk.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+        console.log(chalk.dim('Created structure:'));
+        console.log(chalk.white('  .ai-phases/'));
+        console.log(chalk.dim('  ├── config.json       ') + chalk.cyan('# Project settings'));
+        console.log(chalk.dim('  ├── state.json        ') + chalk.cyan('# Phase tracking'));
+        console.log(chalk.dim('  ├── context.md        ') + chalk.cyan('# Persistent context'));
+        console.log(chalk.dim('  ├── phases/           ') + chalk.cyan('# Phase directories'));
+        console.log(chalk.dim('  ├── logs/             ') + chalk.cyan('# Decision logs'));
+        console.log(chalk.dim('  └── templates/        ') + chalk.cyan('# Prompt templates'));
+        console.log();
+        // If --from-idea was provided, run refine
+        if (options.fromIdea) {
+            console.log(chalk.cyan('\nStarting idea refinement...\n'));
+            await refineCommand(options.fromIdea, {});
+        }
+        else {
+            console.log(chalk.white('Next steps:\n'));
+            console.log(chalk.cyan('  ai-phases refine "your project idea"'));
+            console.log(chalk.dim('  or'));
+            console.log(chalk.cyan('  ai-phases plan --interactive\n'));
+        }
+    }
+    catch (error) {
+        spinner.fail('Failed to initialize project');
+        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));
+        process.exit(1);
+    }
+}
+async function createTemplates(phasesDir, uiLibrary, designSystem) {
+    // Handover template
+    const handoverTemplate = `# Handover - Phase [N]: [Name]
+
+## Completed Work
+- [What was implemented]
+
+## Files Modified
+| File | Description |
+|------|-------------|
+| \`path/to/file\` | What this file does |
+
+## Key Decisions
+- **Decision**: [What was decided]
+  - **Rationale**: [Why]
+  - **Trade-offs**: [What we gave up]
+
+## Known Issues
+- [ ] [Issue description]
+
+## Context for Next Phase
+- [Important information for the next developer]
+
+## Warnings / Gotchas
+- ⚠️ [Something to watch out for]
+
+## Validation Status
+- [ ] [Criterion 1]
+- [ ] [Criterion 2]
+`;
+    const failureTemplate = `# Failure Report - Phase [N], Attempt [M]
+
+## Date
+[ISO timestamp]
+
+## What Was Attempted
+[Describe what the phase tried to accomplish]
+
+## What Went Wrong
+[Describe the error or failure]
+
+## Error Details
+\`\`\`
+[Error messages, stack traces, etc.]
+\`\`\`
+
+## Root Cause Analysis
+[Why did this happen?]
+
+## Suggested Fix for Next Attempt
+[What should be done differently]
+
+## Files That May Need Attention
+- \`path/to/file\` - [Why]
+`;
+    const phasePromptTemplate = `# Phase [N]: [Name]
+
+## Model
+[Model to use: Claude Opus / Gemini Flash]
+
+## Context
+[Phase description and goals]
+
+## Previous Phase Handover
+[If applicable, summary from previous phase]
+
+## Documentation Lookup (Context7)
+Before coding, use @context7 to look up:
+- [Library/framework topic]
+
+## Tasks
+1. [Task 1]
+2. [Task 2]
+
+## Validation Criteria
+- [ ] [How to verify completion]
+
+## Design Constraints
+- UI Library: ${uiLibrary}
+- Design System: ${designSystem}
+
+## Rules
+- Only modify files relevant to this phase
+- Don't refactor unrelated code
+- Test each change before moving on
+`;
+    await fs.writeFile(path.join(phasesDir, 'templates', 'handover.md'), handoverTemplate);
+    await fs.writeFile(path.join(phasesDir, 'templates', 'failure-report.md'), failureTemplate);
+    await fs.writeFile(path.join(phasesDir, 'templates', 'phase-prompt.md'), phasePromptTemplate);
+}
+async function createContextFile(phasesDir, config) {
+    const contextContent = `# Project Context - ${config.name}
+
+This file contains persistent context that carries across all phases.
+It's automatically included in prompts and handovers.
+
+## Project Overview
+[To be filled after refinement]
+
+## Technical Stack
+- **UI Library**: ${config.ui_library}
+- **Design System**: ${config.design_system}
+
+## Design Tokens
+[To be extracted from design system]
+
+## Architecture Decisions
+[Record important decisions here]
+
+## Component Library
+[Available components will be listed here]
+
+## API Contracts
+[External APIs and their schemas]
+
+## Known Constraints
+[Technical or business constraints]
+
+---
+*This file is managed by AI Phase Builder*
+`;
+    await fs.writeFile(path.join(phasesDir, 'context.md'), contextContent);
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/plan.d.ts

@@ -0,0 +1,7 @@
+interface PlanOptions {
+    interactive?: boolean;
+    fromReadme?: boolean;
+}
+export declare function planCommand(options: PlanOptions): Promise<void>;
+export {};
+//# sourceMappingURL=plan.d.ts.map

package/dist/cli/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"AAYA,UAAU,WAAW;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDrE"}

package/dist/cli/commands/plan.js

@@ -0,0 +1,193 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { getProjectPhasesDir, loadProjectConfig } from '../../core/config-manager.js';
+import { loadProjectState, saveProjectState, createPhaseState, } from '../../core/state-manager.js';
+export async function planCommand(options) {
+    const projectConfig = await loadProjectConfig();
+    if (!projectConfig) {
+        console.log(chalk.yellow('Project not initialized. Run: ai-phases init'));
+        process.exit(1);
+    }
+    const state = await loadProjectState();
+    if (!state) {
+        console.log(chalk.yellow('Project state not found. Run: ai-phases init'));
+        process.exit(1);
+    }
+    if (options.interactive) {
+        await interactivePlanning(state);
+    }
+    else if (options.fromReadme) {
+        await planFromReadme(state);
+    }
+    else {
+        // Open plan.md for editing
+        const planPath = path.join(getProjectPhasesDir(), 'plan.md');
+        if (await fs.pathExists(planPath)) {
+            console.log(chalk.white('\nExisting plan found at:'));
+            console.log(chalk.cyan(`  ${planPath}\n`));
+            const { action } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'action',
+                    message: 'What would you like to do?',
+                    choices: [
+                        { name: 'Edit existing plan', value: 'edit' },
+                        { name: 'Create new plan (interactive)', value: 'interactive' },
+                        { name: 'View current plan', value: 'view' },
+                    ],
+                },
+            ]);
+            if (action === 'interactive') {
+                await interactivePlanning(state);
+            }
+            else if (action === 'view') {
+                const content = await fs.readFile(planPath, 'utf-8');
+                console.log(chalk.dim('\n' + '─'.repeat(60) + '\n'));
+                console.log(content);
+                console.log(chalk.dim('\n' + '─'.repeat(60) + '\n'));
+            }
+            else {
+                console.log(chalk.cyan('\nEdit the plan file and then run:'));
+                console.log(chalk.white('  ai-phases plan --from-file\n'));
+            }
+        }
+        else {
+            console.log(chalk.white('\nNo plan exists yet. Starting interactive planning...\n'));
+            await interactivePlanning(state);
+        }
+    }
+}
+async function interactivePlanning(state) {
+    console.log(chalk.cyan('\n📋 Interactive Phase Planning\n'));
+    const phases = [];
+    let addMore = true;
+    let phaseNumber = 1;
+    while (addMore) {
+        console.log(chalk.yellow(`\n─── Phase ${phaseNumber} ───\n`));
+        const phaseAnswers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'name',
+                message: 'Phase name:',
+                default: phaseNumber === 1 ? 'Project Setup' : `Phase ${phaseNumber}`,
+            },
+            {
+                type: 'input',
+                name: 'description',
+                message: 'Description:',
+            },
+            {
+                type: 'editor',
+                name: 'tasks',
+                message: 'Tasks (one per line):',
+                default: '- Task 1\n- Task 2\n- Task 3',
+            },
+            {
+                type: 'editor',
+                name: 'validation',
+                message: 'Validation criteria (one per line):',
+                default: '- App compiles without errors\n- Basic functionality works',
+            },
+            {
+                type: 'input',
+                name: 'context7',
+                message: 'Context7 docs to look up (comma-separated):',
+                default: '',
+            },
+        ]);
+        // Parse tasks
+        const tasks = phaseAnswers.tasks
+            .split('\n')
+            .filter((line) => line.trim())
+            .map((line, index) => ({
+            id: `task-${phaseNumber}-${index + 1}`,
+            description: line.replace(/^-\s*/, '').trim(),
+            status: 'pending',
+        }));
+        // Parse validation criteria
+        const validation = phaseAnswers.validation
+            .split('\n')
+            .filter((line) => line.trim())
+            .map((line) => line.replace(/^-\s*/, '').trim());
+        // Parse Context7 queries
+        const context7 = phaseAnswers.context7
+            .split(',')
+            .map((q) => q.trim())
+            .filter(Boolean);
+        phases.push(createPhaseState(phaseNumber, phaseAnswers.name, phaseAnswers.description, tasks, validation, context7, 3));
+        const { continueAdding } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'continueAdding',
+                message: 'Add another phase?',
+                default: phaseNumber < 5,
+            },
+        ]);
+        addMore = continueAdding;
+        phaseNumber++;
+    }
+    // Save phases
+    state.phases = phases;
+    state.total_phases = phases.length;
+    state.current_phase = 1;
+    state.status = 'in_progress';
+    await saveProjectState(state);
+    // Generate plan.md
+    const planContent = generatePlanMarkdown(phases);
+    const planPath = path.join(getProjectPhasesDir(), 'plan.md');
+    await fs.writeFile(planPath, planContent);
+    // Create phase directories
+    for (const phase of phases) {
+        const phaseDir = path.join(getProjectPhasesDir(), 'phases', `phase-${phase.phase_number}`);
+        await fs.ensureDir(phaseDir);
+        await fs.writeJson(path.join(phaseDir, 'state.json'), phase, { spaces: 2 });
+    }
+    console.log(chalk.green('\n✓ Plan created with ' + phases.length + ' phases'));
+    console.log(chalk.dim('Saved to: ') + chalk.white(planPath));
+    console.log(chalk.cyan('\nRun: ai-phases run --phase 1\n'));
+}
+async function planFromReadme(state) {
+    const readmePath = path.join(process.cwd(), 'README.md');
+    if (!(await fs.pathExists(readmePath))) {
+        console.log(chalk.yellow('No README.md found in project root.'));
+        return;
+    }
+    const readmeContent = await fs.readFile(readmePath, 'utf-8');
+    console.log(chalk.cyan('\n📖 Inferring phases from README...\n'));
+    console.log(chalk.dim('README content will be used as context for phase generation.'));
+    console.log(chalk.yellow('\nUse the refine command for AI-powered phase generation:'));
+    console.log(chalk.cyan('  ai-phases refine "' + readmeContent.substring(0, 100).replace(/\n/g, ' ') + '..."\n'));
+}
+function generatePlanMarkdown(phases) {
+    let content = '# Phase Plan\n\n';
+    content += `Generated: ${new Date().toISOString()}\n\n`;
+    content += `Total Phases: ${phases.length}\n\n`;
+    content += '---\n\n';
+    for (const phase of phases) {
+        content += `## Phase ${phase.phase_number}: ${phase.name}\n\n`;
+        content += `**Description**: ${phase.description}\n\n`;
+        content += `**Model**: ${phase.model === 'planning' ? 'Claude Opus' : 'Gemini Flash'}\n\n`;
+        content += '### Tasks\n';
+        phase.tasks.forEach((task, i) => {
+            content += `${i + 1}. ${task.description}\n`;
+        });
+        content += '\n';
+        content += '### Validation Criteria\n';
+        phase.validation_criteria.forEach(criterion => {
+            content += `- [ ] ${criterion}\n`;
+        });
+        content += '\n';
+        if (phase.context7_queries && phase.context7_queries.length > 0) {
+            content += '### Context7 Queries\n';
+            phase.context7_queries.forEach(query => {
+                content += `- ${query}\n`;
+            });
+            content += '\n';
+        }
+        content += '---\n\n';
+    }
+    return content;
+}
+//# sourceMappingURL=plan.js.map

package/dist/cli/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/refine.d.ts

@@ -0,0 +1,6 @@
+interface RefineOptions {
+    skipResearch?: boolean;
+}
+export declare function refineCommand(idea: string, options: RefineOptions): Promise<void>;
+export {};
+//# sourceMappingURL=refine.d.ts.map

package/dist/cli/commands/refine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/refine.ts"],"names":[],"mappings":"AAyBA,UAAU,aAAa;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+MvF"}