@nclamvn/vibecode-cli 1.0.0 → 1.0.1

package/src/config/constants.js

@@ -3,51 +3,61 @@
 // Spec Hash: 0fe43335f5a325e3279a079ce616c052
 // ═══════════════════════════════════════════════════════════════════════════════
 
-export const VERSION = '1.0.0';
+export const VERSION = '2.0.0';
 export const SPEC_HASH = '0fe43335f5a325e3279a079ce616c052';
 
 // ─────────────────────────────────────────────────────────────────────────────
-// State Machine
+// State Machine - Phase A + B
 // ─────────────────────────────────────────────────────────────────────────────
 
 export const STATES = {
+  // Phase A: Planning
   INIT: 'INIT',
   INTAKE_CAPTURED: 'INTAKE_CAPTURED',
   BLUEPRINT_DRAFTED: 'BLUEPRINT_DRAFTED',
   CONTRACT_DRAFTED: 'CONTRACT_DRAFTED',
   CONTRACT_LOCKED: 'CONTRACT_LOCKED',
+  // Phase B: Execution
+  PLAN_CREATED: 'PLAN_CREATED',
   BUILD_IN_PROGRESS: 'BUILD_IN_PROGRESS',
   BUILD_DONE: 'BUILD_DONE',
   REVIEW_PASSED: 'REVIEW_PASSED',
-  REVIEW_FAILED: 'REVIEW_FAILED'
+  REVIEW_FAILED: 'REVIEW_FAILED',
+  SHIPPED: 'SHIPPED'
 };
 
 export const TRANSITIONS = {
+  // Phase A transitions
   [STATES.INIT]: [STATES.INTAKE_CAPTURED],
   [STATES.INTAKE_CAPTURED]: [STATES.BLUEPRINT_DRAFTED],
   [STATES.BLUEPRINT_DRAFTED]: [STATES.CONTRACT_DRAFTED, STATES.INTAKE_CAPTURED],
   [STATES.CONTRACT_DRAFTED]: [STATES.CONTRACT_LOCKED, STATES.BLUEPRINT_DRAFTED],
-  [STATES.CONTRACT_LOCKED]: [STATES.BUILD_IN_PROGRESS],
+  // Phase B transitions
+  [STATES.CONTRACT_LOCKED]: [STATES.PLAN_CREATED],
+  [STATES.PLAN_CREATED]: [STATES.BUILD_IN_PROGRESS],
   [STATES.BUILD_IN_PROGRESS]: [STATES.BUILD_DONE],
   [STATES.BUILD_DONE]: [STATES.REVIEW_PASSED, STATES.REVIEW_FAILED],
-  [STATES.REVIEW_PASSED]: [],
-  [STATES.REVIEW_FAILED]: [STATES.BUILD_IN_PROGRESS, STATES.CONTRACT_DRAFTED]
+  [STATES.REVIEW_PASSED]: [STATES.SHIPPED],
+  [STATES.REVIEW_FAILED]: [STATES.BUILD_IN_PROGRESS, STATES.PLAN_CREATED],
+  [STATES.SHIPPED]: []
 };
 
 // ─────────────────────────────────────────────────────────────────────────────
-// Progress Display Mapping
+// Progress Display Mapping (7 stages)
 // ─────────────────────────────────────────────────────────────────────────────
 
 export const PROGRESS_MAP = {
-  [STATES.INIT]: { intake: '🔄', blueprint: '⬜', contract: '⬜', build: '⬜', ship: '⬜' },
-  [STATES.INTAKE_CAPTURED]: { intake: '✅', blueprint: '🔄', contract: '⬜', build: '⬜', ship: '⬜' },
-  [STATES.BLUEPRINT_DRAFTED]: { intake: '✅', blueprint: '✅', contract: '🔄', build: '⬜', ship: '⬜' },
-  [STATES.CONTRACT_DRAFTED]: { intake: '✅', blueprint: '✅', contract: '🔄', build: '⬜', ship: '⬜' },
-  [STATES.CONTRACT_LOCKED]: { intake: '✅', blueprint: '✅', contract: '✅', build: '🔄', ship: '⬜' },
-  [STATES.BUILD_IN_PROGRESS]: { intake: '✅', blueprint: '✅', contract: '✅', build: '🔄', ship: '⬜' },
-  [STATES.BUILD_DONE]: { intake: '✅', blueprint: '✅', contract: '✅', build: '✅', ship: '🔄' },
-  [STATES.REVIEW_PASSED]: { intake: '✅', blueprint: '✅', contract: '✅', build: '✅', ship: '✅' },
-  [STATES.REVIEW_FAILED]: { intake: '✅', blueprint: '✅', contract: '✅', build: '⚠️', ship: '⬜' }
+  [STATES.INIT]: { intake: '🔄', blueprint: '⬜', contract: '⬜', plan: '⬜', build: '⬜', review: '⬜', ship: '⬜' },
+  [STATES.INTAKE_CAPTURED]: { intake: '✅', blueprint: '🔄', contract: '⬜', plan: '⬜', build: '⬜', review: '⬜', ship: '⬜' },
+  [STATES.BLUEPRINT_DRAFTED]: { intake: '✅', blueprint: '✅', contract: '🔄', plan: '⬜', build: '⬜', review: '⬜', ship: '⬜' },
+  [STATES.CONTRACT_DRAFTED]: { intake: '✅', blueprint: '✅', contract: '🔄', plan: '⬜', build: '⬜', review: '⬜', ship: '⬜' },
+  [STATES.CONTRACT_LOCKED]: { intake: '✅', blueprint: '✅', contract: '✅', plan: '🔄', build: '⬜', review: '⬜', ship: '⬜' },
+  [STATES.PLAN_CREATED]: { intake: '✅', blueprint: '✅', contract: '✅', plan: '✅', build: '🔄', review: '⬜', ship: '⬜' },
+  [STATES.BUILD_IN_PROGRESS]: { intake: '✅', blueprint: '✅', contract: '✅', plan: '✅', build: '🔄', review: '⬜', ship: '⬜' },
+  [STATES.BUILD_DONE]: { intake: '✅', blueprint: '✅', contract: '✅', plan: '✅', build: '✅', review: '🔄', ship: '⬜' },
+  [STATES.REVIEW_PASSED]: { intake: '✅', blueprint: '✅', contract: '✅', plan: '✅', build: '✅', review: '✅', ship: '🔄' },
+  [STATES.REVIEW_FAILED]: { intake: '✅', blueprint: '✅', contract: '✅', plan: '✅', build: '⚠️', review: '❌', ship: '⬜' },
+  [STATES.SHIPPED]: { intake: '✅', blueprint: '✅', contract: '✅', plan: '✅', build: '✅', review: '✅', ship: '✅' }
 };
 
 // ─────────────────────────────────────────────────────────────────────────────

package/src/config/templates.js

@@ -188,7 +188,278 @@ export function getContractTemplate(projectName, sessionId) {
 
 ---
 
-*Generated by Vibecode CLI v1.0*
+*Generated by Vibecode CLI v1.1*
 *Lock this contract with \`vibecode lock\` when ready*
 `;
 }
+
+/**
+ * Get plan template
+ */
+export function getPlanTemplate(projectName, sessionId, specHash, contractContent) {
+  const timestamp = new Date().toISOString();
+
+  // Extract deliverables from contract
+  const deliverablesMatch = contractContent.match(/## 📦 Deliverables[\s\S]*?\|[\s\S]*?(?=\n---|\n##|$)/);
+  const deliverables = deliverablesMatch ? deliverablesMatch[0] : '[Extract from contract]';
+
+  return `# 📋 EXECUTION PLAN: ${projectName}
+
+## Session: ${sessionId}
+## Created: ${timestamp}
+## Spec Hash: ${specHash}
+## Status: ACTIVE
+
+---
+
+## 🎯 Objective
+
+Execute the locked contract deliverables in order.
+
+---
+
+## 📦 Deliverables from Contract
+
+${deliverables}
+
+---
+
+## 🔧 Execution Steps
+
+| Step | Task | Command/Action | Status |
+|------|------|----------------|--------|
+| 1 | Setup | Initialize project structure | ⬜ |
+| 2 | Core Build | Implement main functionality | ⬜ |
+| 3 | Styling | Apply design system | ⬜ |
+| 4 | Testing | Run tests and validate | ⬜ |
+| 5 | Review | Check against acceptance criteria | ⬜ |
+
+---
+
+## 📝 Notes
+
+- Follow contract scope strictly
+- Capture evidence for each step
+- No scope creep allowed
+
+---
+
+## ⏱️ Time Tracking
+
+| Phase | Started | Completed | Duration |
+|-------|---------|-----------|----------|
+| Build | ${timestamp} | - | - |
+| Review | - | - | - |
+
+---
+
+*Generated by Vibecode CLI v1.1*
+`;
+}
+
+/**
+ * Get coder pack template - instructions for AI coder
+ */
+export function getCoderPackTemplate(projectName, sessionId, specHash, contractContent, blueprintContent) {
+  const timestamp = new Date().toISOString();
+
+  return `# 🏗️ CODER PACK: ${projectName}
+
+## Session: ${sessionId}
+## Generated: ${timestamp}
+## Spec Hash: ${specHash}
+
+---
+
+## ⚠️ IMPORTANT - READ FIRST
+
+You are the **Thợ (Builder)**. Your job is to execute the locked contract exactly as specified.
+
+**Rules:**
+1. Do NOT add features not in the contract
+2. Do NOT modify the contract
+3. Capture evidence of your work
+4. Report any blockers immediately
+
+---
+
+## 📜 CONTRACT (LOCKED)
+
+${contractContent}
+
+---
+
+## 📘 BLUEPRINT REFERENCE
+
+${blueprintContent}
+
+---
+
+## 🔧 BUILD INSTRUCTIONS
+
+1. Read the contract deliverables table
+2. Implement each item in order
+3. For each deliverable:
+   - Create/modify the required files
+   - Test the implementation
+   - Mark as complete
+4. Capture evidence:
+   - Screenshots if UI
+   - Terminal output if CLI
+   - Test results if automated
+
+---
+
+## 📁 Evidence Collection
+
+Save evidence to: \`.vibecode/sessions/${sessionId}/evidence/\`
+
+Required evidence:
+- \`changes.diff\` - Git diff of all changes
+- \`build.log\` - Terminal output during build
+- \`screenshots/\` - Visual evidence if applicable
+
+---
+
+## ✅ Completion Checklist
+
+- [ ] All deliverables implemented
+- [ ] All acceptance criteria met
+- [ ] Evidence captured
+- [ ] No scope creep
+
+---
+
+*Run \`vibecode build --complete\` when finished*
+
+*Generated by Vibecode CLI v1.1*
+`;
+}
+
+/**
+ * Get build report template
+ */
+export function getBuildReportTemplate(projectName, sessionId, specHash, startTime, endTime, evidence) {
+  const duration = endTime ? Math.round((new Date(endTime) - new Date(startTime)) / 1000 / 60) : 'In progress';
+
+  return `# 🏗️ BUILD REPORT: ${projectName}
+
+## Session: ${sessionId}
+## Spec Hash: ${specHash}
+## Status: ${endTime ? 'COMPLETED' : 'IN PROGRESS'}
+
+---
+
+## ⏱️ Timeline
+
+| Metric | Value |
+|--------|-------|
+| Started | ${startTime} |
+| Completed | ${endTime || '-'} |
+| Duration | ${duration} ${endTime ? 'minutes' : ''} |
+
+---
+
+## 📁 Evidence Collected
+
+${evidence.hasDiff ? '- ✅ changes.diff' : '- ⬜ changes.diff'}
+${evidence.hasLog ? '- ✅ build.log' : '- ⬜ build.log'}
+${evidence.screenshots > 0 ? `- ✅ ${evidence.screenshots} screenshots` : '- ⬜ No screenshots'}
+
+---
+
+## 📊 Summary
+
+- Files changed: ${evidence.filesChanged || 'N/A'}
+- Lines added: ${evidence.linesAdded || 'N/A'}
+- Lines removed: ${evidence.linesRemoved || 'N/A'}
+
+---
+
+## 🔍 Next Steps
+
+${endTime ? '1. Run `vibecode review` to validate build' : '1. Continue building\n2. Run `vibecode build --complete` when done'}
+
+---
+
+*Generated by Vibecode CLI v1.1*
+`;
+}
+
+/**
+ * Get review report template
+ */
+export function getReviewReportTemplate(projectName, sessionId, specHash, checks, passed) {
+  const timestamp = new Date().toISOString();
+
+  const checksList = checks.map(c =>
+    `| ${c.name} | ${c.passed ? '✅ PASS' : '❌ FAIL'} | ${c.message || '-'} |`
+  ).join('\n');
+
+  return `# 🔍 REVIEW REPORT: ${projectName}
+
+## Session: ${sessionId}
+## Spec Hash: ${specHash}
+## Reviewed: ${timestamp}
+## Result: ${passed ? '✅ PASSED' : '❌ FAILED'}
+
+---
+
+## 📋 Automated Checks
+
+| Check | Result | Details |
+|-------|--------|---------|
+${checksList}
+
+---
+
+## ✔️ Acceptance Criteria Review
+
+[Manually verified against contract]
+
+---
+
+## 📊 Summary
+
+- Total checks: ${checks.length}
+- Passed: ${checks.filter(c => c.passed).length}
+- Failed: ${checks.filter(c => !c.passed).length}
+
+---
+
+## 🎯 Verdict
+
+${passed ? `
+**REVIEW PASSED**
+
+All checks passed. Ready for shipping.
+Run \`vibecode snapshot\` to create release.
+` : `
+**REVIEW FAILED**
+
+Some checks failed. Please fix the issues and run \`vibecode build\` again.
+`}
+
+---
+
+*Generated by Vibecode CLI v1.1*
+`;
+}
+
+/**
+ * Get manifest template for release
+ */
+export function getManifestTemplate(projectName, version, specHash, sessionId, files) {
+  const timestamp = new Date().toISOString();
+
+  return {
+    name: projectName,
+    version: version,
+    specHash: specHash,
+    sessionId: sessionId,
+    timestamp: timestamp,
+    generator: 'vibecode-cli@1.1.0',
+    files: files,
+    status: 'SHIPPED'
+  };
+}

package/src/core/session.js

@@ -84,9 +84,16 @@ export async function getSessionFilesStatus() {
   if (!sessionPath) return null;
 
   return {
+    // Phase A files
     intake: await pathExists(path.join(sessionPath, 'intake.md')),
     blueprint: await pathExists(path.join(sessionPath, 'blueprint.md')),
-    contract: await pathExists(path.join(sessionPath, 'contract.md'))
+    contract: await pathExists(path.join(sessionPath, 'contract.md')),
+    // Phase B files
+    plan: await pathExists(path.join(sessionPath, 'plan.md')),
+    coderPack: await pathExists(path.join(sessionPath, 'coder_pack.md')),
+    buildReport: await pathExists(path.join(sessionPath, 'build_report.md')),
+    reviewReport: await pathExists(path.join(sessionPath, 'review_report.md')),
+    manifest: await pathExists(path.join(sessionPath, 'manifest.json'))
   };
 }
 

package/src/index.js

@@ -3,10 +3,24 @@
 // Spec Hash: 0fe43335f5a325e3279a079ce616c052
 // ═══════════════════════════════════════════════════════════════════════════════
 
+// Phase A Commands
 export { initCommand } from './commands/init.js';
 export { startCommand } from './commands/start.js';
 export { statusCommand } from './commands/status.js';
 export { lockCommand } from './commands/lock.js';
 export { doctorCommand } from './commands/doctor.js';
 
+// Phase B Commands
+export { planCommand } from './commands/plan.js';
+export { buildCommand } from './commands/build.js';
+export { reviewCommand } from './commands/review.js';
+export { snapshotCommand } from './commands/snapshot.js';
+
+// Phase C Commands
+export { configCommand } from './commands/config.js';
+
+// Constants
 export { VERSION, SPEC_HASH, STATES } from './config/constants.js';
+
+// Providers
+export { PROVIDERS, getProvider, getDefaultProvider } from './providers/index.js';

package/src/providers/claude-code.js

@@ -0,0 +1,159 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Claude Code Provider
+// "Claude/LLM là PIPELINE, là KIẾN TRÚC SƯ"
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import { spawn } from 'child_process';
+import path from 'path';
+import { pathExists, appendToFile } from '../utils/files.js';
+
+/**
+ * Claude Code optimal configuration
+ * Contract LOCKED = License to build (không cần hỏi thêm)
+ */
+export const CLAUDE_CODE_CONFIG = {
+  command: 'claude',
+  flags: [
+    '--dangerously-skip-permissions',  // Trust the AI - Contract đã locked
+  ],
+  timeout: 30 * 60 * 1000, // 30 minutes max
+};
+
+/**
+ * Check if Claude Code CLI is available
+ */
+export async function isClaudeCodeAvailable() {
+  return new Promise((resolve) => {
+    const proc = spawn('which', ['claude'], { shell: true });
+    proc.on('close', (code) => {
+      resolve(code === 0);
+    });
+    proc.on('error', () => {
+      resolve(false);
+    });
+  });
+}
+
+/**
+ * Spawn Claude Code with optimal settings
+ *
+ * @param {string} prompt - The coder pack / prompt to send
+ * @param {object} options - Configuration options
+ * @param {string} options.cwd - Working directory
+ * @param {string} options.logPath - Path to write build logs
+ * @param {function} options.onOutput - Callback for output
+ * @returns {Promise<{success: boolean, code: number}>}
+ */
+export async function spawnClaudeCode(prompt, options = {}) {
+  const { cwd, logPath, onOutput } = options;
+  const fs = await import('fs-extra');
+  const os = await import('os');
+
+  // Check if Claude Code is available
+  const available = await isClaudeCodeAvailable();
+  if (!available) {
+    throw new Error('Claude Code CLI not found. Install with: npm install -g @anthropic/claude-code');
+  }
+
+  // Write prompt to temp file to avoid shell escaping issues
+  const tempDir = os.default.tmpdir();
+  const promptFile = path.join(tempDir, `vibecode-prompt-${Date.now()}.md`);
+  await fs.default.writeFile(promptFile, prompt, 'utf-8');
+
+  return new Promise((resolve, reject) => {
+    // Use cat to pipe the prompt file content to claude
+    const command = `cat "${promptFile}" | claude ${CLAUDE_CODE_CONFIG.flags.join(' ')}`;
+
+    // Log the command being run
+    if (logPath) {
+      appendToFile(logPath, `\n[${new Date().toISOString()}] Running: claude with prompt from ${promptFile}\n`);
+    }
+
+    const proc = spawn(command, [], {
+      cwd: cwd || process.cwd(),
+      stdio: 'inherit', // Stream directly to terminal
+      shell: true,
+    });
+
+    let timeoutId = setTimeout(() => {
+      proc.kill();
+      // Cleanup temp file
+      fs.default.remove(promptFile).catch(() => {});
+      reject(new Error('Claude Code process timed out'));
+    }, CLAUDE_CODE_CONFIG.timeout);
+
+    proc.on('close', async (code) => {
+      clearTimeout(timeoutId);
+
+      // Cleanup temp file
+      await fs.default.remove(promptFile).catch(() => {});
+
+      const result = {
+        success: code === 0,
+        code: code || 0,
+        timestamp: new Date().toISOString()
+      };
+
+      if (logPath) {
+        const status = result.success ? 'SUCCESS' : 'FAILED';
+        appendToFile(logPath, `\n[${result.timestamp}] Claude Code ${status} (exit code: ${code})\n`);
+      }
+
+      resolve(result);
+    });
+
+    proc.on('error', async (error) => {
+      clearTimeout(timeoutId);
+      // Cleanup temp file
+      await fs.default.remove(promptFile).catch(() => {});
+
+      if (logPath) {
+        appendToFile(logPath, `\n[${new Date().toISOString()}] ERROR: ${error.message}\n`);
+      }
+      reject(error);
+    });
+  });
+}
+
+/**
+ * Build prompt with optional CLAUDE.md injection
+ *
+ * @param {string} coderPackContent - Content of coder_pack.md
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<string>} - Final prompt
+ */
+export async function buildPromptWithContext(coderPackContent, projectRoot) {
+  let fullPrompt = coderPackContent;
+
+  // Check for CLAUDE.md in project root
+  const claudeMdPath = path.join(projectRoot, 'CLAUDE.md');
+  if (await pathExists(claudeMdPath)) {
+    const fs = await import('fs-extra');
+    const claudeMd = await fs.default.readFile(claudeMdPath, 'utf-8');
+
+    // Inject CLAUDE.md rules before coder pack
+    fullPrompt = `# PROJECT RULES (from CLAUDE.md)
+
+${claudeMd}
+
+---
+
+# BUILD INSTRUCTIONS
+
+${coderPackContent}`;
+  }
+
+  return fullPrompt;
+}
+
+/**
+ * Get provider info for status display
+ */
+export function getProviderInfo() {
+  return {
+    name: 'Claude Code',
+    command: CLAUDE_CODE_CONFIG.command,
+    mode: '--dangerously-skip-permissions',
+    description: 'AI coding with guardrails disabled (contract-approved)'
+  };
+}

package/src/providers/index.js

@@ -0,0 +1,45 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - AI Provider Manager
+// ═══════════════════════════════════════════════════════════════════════════════
+
+export {
+  spawnClaudeCode,
+  isClaudeCodeAvailable,
+  buildPromptWithContext,
+  getProviderInfo,
+  CLAUDE_CODE_CONFIG
+} from './claude-code.js';
+
+// Future providers:
+// export { callAnthropicAPI } from './anthropic-api.js';
+// export { spawnCursor } from './cursor.js';
+
+/**
+ * Available providers
+ */
+export const PROVIDERS = {
+  'claude-code': {
+    name: 'Claude Code',
+    description: 'Official Claude CLI for coding',
+    available: true
+  },
+  'anthropic-api': {
+    name: 'Anthropic API',
+    description: 'Direct API calls (coming soon)',
+    available: false
+  }
+};
+
+/**
+ * Get provider by name
+ */
+export function getProvider(name) {
+  return PROVIDERS[name] || null;
+}
+
+/**
+ * Get default provider
+ */
+export function getDefaultProvider() {
+  return 'claude-code';
+}

package/src/ui/output.js

@@ -52,11 +52,11 @@ export function printInfo(message) {
 export function printProgress(state) {
   const progress = PROGRESS_MAP[state] || PROGRESS_MAP.INIT;
 
-  const bar = `  ${progress.intake} INTAKE  ${progress.blueprint} BLUEPRINT  ${progress.contract} CONTRACT  ${progress.build} BUILD  ${progress.ship} SHIP`;
+  const bar = `  ${progress.intake} INTAKE  ${progress.blueprint} BLUEPRINT  ${progress.contract} CONTRACT  ${progress.plan} PLAN  ${progress.build} BUILD  ${progress.review} REVIEW  ${progress.ship} SHIP`;
 
-  console.log(chalk.gray('┌─ Progress ─────────────────────────────────────────────────────────┐'));
+  console.log(chalk.gray('┌─ Progress ───────────────────────────────────────────────────────────────────────────┐'));
   console.log(chalk.white(bar));
-  console.log(chalk.gray('└────────────────────────────────────────────────────────────────────┘'));
+  console.log(chalk.gray('└──────────────────────────────────────────────────────────────────────────────────────┘'));
 }
 
 /**