@nclamvn/vibecode-cli 2.0.0 → 2.1.0

package/src/commands/wizard.js

@@ -0,0 +1,322 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Interactive Wizard
+// Phase H1: Smart Defaults - No args = Interactive menu
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { VERSION } from '../config/constants.js';
+
+/**
+ * Wizard Command - Interactive menu when no args provided
+ *
+ * Usage:
+ *   vibecode  (no args) → Shows interactive menu
+ */
+export async function wizardCommand() {
+  // Show welcome banner
+  console.log(chalk.cyan(`
+╭────────────────────────────────────────────────────────────────────╮
+│                                                                    │
+│   🏗️  VIBECODE v${VERSION.padEnd(43)}│
+│   Build Software with Discipline                                   │
+│                                                                    │
+╰────────────────────────────────────────────────────────────────────╯
+  `));
+
+  const { action } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'Bạn muốn làm gì hôm nay?',
+      choices: [
+        { name: '🚀 Tạo project mới nhanh', value: 'go' },
+        { name: '🤖 Build project phức tạp (nhiều modules)', value: 'agent' },
+        { name: '🔍 Debug/fix lỗi', value: 'debug' },
+        { name: '🤝 Trợ giúp từ AI', value: 'assist' },
+        new inquirer.Separator(),
+        { name: '📊 Xem trạng thái project hiện tại', value: 'status' },
+        { name: '⚙️  Cài đặt', value: 'config' },
+        { name: '📁 Khởi tạo workspace mới', value: 'init' },
+        new inquirer.Separator(),
+        { name: '❓ Xem trợ giúp', value: 'help' },
+        { name: '👋 Thoát', value: 'exit' }
+      ]
+    }
+  ]);
+
+  switch (action) {
+    case 'go':
+      await handleGo();
+      break;
+    case 'agent':
+      await handleAgent();
+      break;
+    case 'debug':
+      await handleDebug();
+      break;
+    case 'assist':
+      await handleAssist();
+      break;
+    case 'status':
+      await handleStatus();
+      break;
+    case 'config':
+      await handleConfig();
+      break;
+    case 'init':
+      await handleInit();
+      break;
+    case 'help':
+      showHelp();
+      break;
+    case 'exit':
+      console.log(chalk.cyan('\n👋 Hẹn gặp lại!\n'));
+      process.exit(0);
+  }
+}
+
+/**
+ * Handle Go command with prompts
+ */
+async function handleGo() {
+  const { goCommand } = await import('./go.js');
+
+  const { description } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'description',
+      message: 'Mô tả project bạn muốn tạo:',
+      validate: (input) => input.length > 5 || 'Vui lòng mô tả chi tiết hơn (ít nhất 6 ký tự)'
+    }
+  ]);
+
+  const { template } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'template',
+      message: 'Chọn template (hoặc để trống):',
+      choices: [
+        { name: '🎨 Không dùng template (tự do)', value: null },
+        { name: '🌐 Landing page', value: 'landing' },
+        { name: '💼 SaaS application', value: 'saas' },
+        { name: '⌨️  CLI tool', value: 'cli' },
+        { name: '🔌 REST API', value: 'api' }
+      ]
+    }
+  ]);
+
+  const { confirm } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'confirm',
+      message: `Tạo project: "${description}"${template ? ` (template: ${template})` : ''}?`,
+      default: true
+    }
+  ]);
+
+  if (confirm) {
+    const options = {};
+    if (template) options.template = template;
+    await goCommand(description, options);
+  } else {
+    console.log(chalk.gray('\n✗ Đã huỷ.\n'));
+  }
+}
+
+/**
+ * Handle Agent command with prompts
+ */
+async function handleAgent() {
+  const { agentCommand } = await import('./agent.js');
+
+  const { description } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'description',
+      message: 'Mô tả project phức tạp (VD: SaaS với auth, billing, dashboard):',
+      validate: (input) => input.length > 10 || 'Vui lòng mô tả chi tiết hơn (ít nhất 11 ký tự)'
+    }
+  ]);
+
+  const { createNew } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'createNew',
+      message: 'Tạo thư mục project mới?',
+      default: true
+    }
+  ]);
+
+  const { verbose } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'verbose',
+      message: 'Hiển thị chi tiết quá trình build?',
+      default: false
+    }
+  ]);
+
+  console.log(chalk.blue('\n🤖 Bắt đầu Agent Mode...\n'));
+  await agentCommand(description, { new: createNew, verbose });
+}
+
+/**
+ * Handle Debug command
+ */
+async function handleDebug() {
+  const { debugCommand } = await import('./debug.js');
+
+  const { mode } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'mode',
+      message: 'Chọn chế độ debug:',
+      choices: [
+        { name: '🔄 Interactive - Debug trực tiếp', value: 'interactive' },
+        { name: '🔍 Auto-scan - Tự động tìm và fix lỗi', value: 'auto' },
+        { name: '📝 Mô tả lỗi', value: 'describe' }
+      ]
+    }
+  ]);
+
+  if (mode === 'interactive') {
+    await debugCommand([], { interactive: true });
+  } else if (mode === 'auto') {
+    await debugCommand([], { auto: true });
+  } else {
+    const { description } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'description',
+        message: 'Mô tả lỗi bạn gặp phải:',
+        validate: (input) => input.length > 5 || 'Vui lòng mô tả chi tiết hơn'
+      }
+    ]);
+    await debugCommand([description], {});
+  }
+}
+
+/**
+ * Handle Assist command
+ */
+async function handleAssist() {
+  const { assistCommand } = await import('./assist.js');
+
+  const { hasPrompt } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'hasPrompt',
+      message: 'Bạn có câu hỏi cụ thể không?',
+      default: false
+    }
+  ]);
+
+  if (hasPrompt) {
+    const { prompt } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'prompt',
+        message: 'Nhập câu hỏi của bạn:',
+        validate: (input) => input.length > 3 || 'Vui lòng nhập câu hỏi'
+      }
+    ]);
+    await assistCommand([prompt], {});
+  } else {
+    await assistCommand([], {});
+  }
+}
+
+/**
+ * Handle Status command
+ */
+async function handleStatus() {
+  const { statusCommand } = await import('./status.js');
+  await statusCommand({});
+}
+
+/**
+ * Handle Config command
+ */
+async function handleConfig() {
+  const { configCommand } = await import('./config.js');
+
+  const { action } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'Cài đặt:',
+      choices: [
+        { name: '👀 Xem cài đặt hiện tại', value: 'show' },
+        { name: '🔧 Thay đổi provider', value: 'provider' }
+      ]
+    }
+  ]);
+
+  if (action === 'show') {
+    await configCommand({ show: true });
+  } else {
+    const { provider } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'provider',
+        message: 'Chọn AI provider:',
+        choices: [
+          { name: 'Claude Code (mặc định)', value: 'claude-code' }
+        ]
+      }
+    ]);
+    await configCommand({ provider });
+  }
+}
+
+/**
+ * Handle Init command
+ */
+async function handleInit() {
+  const { initCommand } = await import('./init.js');
+
+  const { confirm } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'confirm',
+      message: `Khởi tạo Vibecode workspace tại ${process.cwd()}?`,
+      default: true
+    }
+  ]);
+
+  if (confirm) {
+    await initCommand({});
+  }
+}
+
+/**
+ * Show help text
+ */
+function showHelp() {
+  console.log(chalk.white(`
+📚 VIBECODE COMMANDS
+
+  ${chalk.cyan('Workflow cơ bản:')}
+    vibecode init          Khởi tạo workspace
+    vibecode start         Bắt đầu intake → blueprint → contract
+    vibecode lock          Khoá contract
+    vibecode plan          Tạo execution plan
+    vibecode build         Build với AI
+    vibecode review        Kiểm tra kết quả
+    vibecode snapshot      Tạo release
+
+  ${chalk.cyan('Power commands:')}
+    vibecode go "..."      Một lệnh, tạo cả project
+    vibecode agent "..."   Build project phức tạp tự động
+    vibecode debug         Debug thông minh 9 bước
+    vibecode assist        Trợ giúp trực tiếp từ AI
+
+  ${chalk.cyan('Khác:')}
+    vibecode status        Xem trạng thái
+    vibecode config        Cài đặt
+    vibecode doctor        Kiểm tra health
+
+📖 Chi tiết: ${chalk.yellow('vibecode <command> --help')}
+  `));
+}

package/src/config/constants.js

@@ -3,7 +3,11 @@
 // Spec Hash: 0fe43335f5a325e3279a079ce616c052
 // ═══════════════════════════════════════════════════════════════════════════════
 
-export const VERSION = '2.0.0';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+
+export const VERSION = pkg.version;
 export const SPEC_HASH = '0fe43335f5a325e3279a079ce616c052';
 
 // ─────────────────────────────────────────────────────────────────────────────

package/src/config/templates.js

@@ -124,11 +124,39 @@ src/
 }
 
 /**
- * Get contract template
+ * Get contract template with content extracted from intake and blueprint
  */
-export function getContractTemplate(projectName, sessionId) {
+export function getContractTemplate(projectName, sessionId, intakeContent = '', blueprintContent = '') {
   const timestamp = new Date().toISOString();
 
+  // Extract goal from intake (look for "Mô tả dự án" section)
+  let goal = extractSection(intakeContent, '## 🎯 Mô tả dự án', '---') ||
+             extractSection(intakeContent, '## Mô tả dự án', '---') ||
+             '[Define your clear, specific goal here]';
+
+  // Extract tech stack from blueprint
+  let techStack = extractSection(blueprintContent, '## 💻 Tech Stack', '---') || '';
+
+  // Extract architecture from blueprint
+  let architecture = extractSection(blueprintContent, '## 📐 Architecture', '---') || '';
+
+  // Extract file structure from blueprint
+  let fileStructure = extractSection(blueprintContent, '## 📁 File Structure', '---') || '';
+
+  // Generate deliverables from goal and architecture
+  const deliverables = generateDeliverablesFromContent(goal, techStack, architecture);
+
+  // Generate acceptance criteria from deliverables
+  const acceptanceCriteria = generateAcceptanceCriteria(deliverables);
+
+  // Generate in-scope items
+  const inScopeItems = deliverables.map(d => `- [ ] ${d.item}`).join('\n');
+
+  // Generate deliverables table
+  const deliverablesTable = deliverables.map((d, i) =>
+    `| ${i + 1} | ${d.item} | ${d.description} | ⬜ |`
+  ).join('\n');
+
   return `# 📜 CONTRACT: ${projectName}
 
 ## Session: ${sessionId}
@@ -140,22 +168,21 @@ export function getContractTemplate(projectName, sessionId) {
 
 ## 🎯 Goal
 
-[Define your clear, specific goal here]
+${goal.trim()}
 
 ---
 
 ## ✅ In-Scope
 
-- [ ] [Deliverable 1]
-- [ ] [Deliverable 2]
-- [ ] [Deliverable 3]
+${inScopeItems || '- [ ] [Deliverable 1]\n- [ ] [Deliverable 2]\n- [ ] [Deliverable 3]'}
 
 ---
 
 ## ❌ Out-of-Scope
 
-- [What is NOT included]
-- [Explicitly excluded items]
+- Features not mentioned in goal
+- Additional integrations not specified
+- Performance optimization beyond MVP
 
 ---
 
@@ -163,14 +190,13 @@ export function getContractTemplate(projectName, sessionId) {
 
 | # | Item | Description | Status |
 |---|------|-------------|--------|
-| 1 | [Item] | [Description] | ⬜ |
+${deliverablesTable || '| 1 | [Item] | [Description] | ⬜ |'}
 
 ---
 
 ## ✔️ Acceptance Criteria
 
-- [ ] [Criterion 1]
-- [ ] [Criterion 2]
+${acceptanceCriteria || '- [ ] [Criterion 1]\n- [ ] [Criterion 2]'}
 
 ---
 
@@ -178,13 +204,17 @@ export function getContractTemplate(projectName, sessionId) {
 
 | Risk | Mitigation |
 |------|------------|
-| [Risk] | [Mitigation] |
+| Dependencies unavailable | Use alternative packages |
+| Scope creep | Strict contract adherence |
 
 ---
 
 ## 🔙 Rollback Plan
 
-[Define rollback strategy]
+If build fails:
+1. Revert to last stable commit
+2. Review contract requirements
+3. Rebuild with corrections
 
 ---
 
@@ -193,6 +223,91 @@ export function getContractTemplate(projectName, sessionId) {
 `;
 }
 
+/**
+ * Extract a section from markdown content
+ */
+function extractSection(content, startMarker, endMarker) {
+  if (!content) return null;
+
+  const startIndex = content.indexOf(startMarker);
+  if (startIndex === -1) return null;
+
+  const contentStart = startIndex + startMarker.length;
+  const endIndex = content.indexOf(endMarker, contentStart);
+
+  if (endIndex === -1) {
+    return content.substring(contentStart).trim();
+  }
+
+  return content.substring(contentStart, endIndex).trim();
+}
+
+/**
+ * Generate deliverables from content analysis
+ */
+function generateDeliverablesFromContent(goal, techStack, architecture) {
+  const deliverables = [];
+
+  // Parse goal for keywords to generate deliverables
+  const goalLower = goal.toLowerCase();
+
+  // Common patterns
+  if (goalLower.includes('landing page') || goalLower.includes('website')) {
+    deliverables.push({ item: 'Landing Page', description: 'Main landing page with hero section' });
+    deliverables.push({ item: 'Responsive Design', description: 'Mobile-friendly layout' });
+  }
+
+  if (goalLower.includes('cli') || goalLower.includes('command')) {
+    deliverables.push({ item: 'CLI Commands', description: 'Core command implementations' });
+    deliverables.push({ item: 'Help System', description: 'Command help and documentation' });
+  }
+
+  if (goalLower.includes('api') || goalLower.includes('backend')) {
+    deliverables.push({ item: 'API Endpoints', description: 'REST/GraphQL endpoints' });
+    deliverables.push({ item: 'Data Models', description: 'Database models and schemas' });
+  }
+
+  if (goalLower.includes('auth') || goalLower.includes('login')) {
+    deliverables.push({ item: 'Authentication', description: 'User login/logout flow' });
+  }
+
+  if (goalLower.includes('dashboard') || goalLower.includes('admin')) {
+    deliverables.push({ item: 'Dashboard UI', description: 'Admin dashboard interface' });
+  }
+
+  // Always include core deliverables if none detected
+  if (deliverables.length === 0) {
+    deliverables.push({ item: 'Core Implementation', description: 'Main functionality as described' });
+    deliverables.push({ item: 'UI/UX', description: 'User interface implementation' });
+    deliverables.push({ item: 'Documentation', description: 'Usage documentation' });
+  }
+
+  // Add testing if not already included
+  if (!deliverables.some(d => d.item.toLowerCase().includes('test'))) {
+    deliverables.push({ item: 'Testing', description: 'Basic functionality tests' });
+  }
+
+  return deliverables;
+}
+
+/**
+ * Generate acceptance criteria from deliverables
+ */
+function generateAcceptanceCriteria(deliverables) {
+  if (!deliverables || deliverables.length === 0) {
+    return '- [ ] All features work as expected\n- [ ] No console errors\n- [ ] Documentation complete';
+  }
+
+  const criteria = deliverables.map(d =>
+    `- [ ] ${d.item} is complete and functional`
+  );
+
+  criteria.push('- [ ] No console errors or warnings');
+  criteria.push('- [ ] Code is clean and documented');
+
+  return criteria.join('\n');
+}
+
 /**
  * Get plan template
  */
@@ -260,9 +375,13 @@ ${deliverables}
 /**
  * Get coder pack template - instructions for AI coder
  */
-export function getCoderPackTemplate(projectName, sessionId, specHash, contractContent, blueprintContent) {
+export function getCoderPackTemplate(projectName, sessionId, specHash, contractContent, blueprintContent, intakeContent = '') {
   const timestamp = new Date().toISOString();
 
+  // Extract the goal from intake for quick reference
+  const goalMatch = intakeContent.match(/## 🎯 Mô tả dự án\s*([\s\S]*?)(?=---|##|$)/);
+  const projectGoal = goalMatch ? goalMatch[1].trim() : 'See contract for details';
+
   return `# 🏗️ CODER PACK: ${projectName}
 
 ## Session: ${sessionId}
@@ -283,6 +402,12 @@ You are the **Thợ (Builder)**. Your job is to execute the locked contract exac
 
 ---
 
+## 🎯 PROJECT GOAL (Quick Reference)
+
+${projectGoal}
+
+---
+
 ## 📜 CONTRACT (LOCKED)
 
 ${contractContent}
@@ -291,7 +416,13 @@ ${contractContent}
 
 ## 📘 BLUEPRINT REFERENCE
 
-${blueprintContent}
+${blueprintContent || '[No blueprint provided - follow contract specifications]'}
+
+---
+
+## 📥 ORIGINAL INTAKE
+
+${intakeContent || '[No intake provided]'}
 
 ---