@nclamvn/vibecode-cli 1.0.0

package/src/commands/start.js

@@ -0,0 +1,222 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Start Command
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import chalk from 'chalk';
+import ora from 'ora';
+import path from 'path';
+import {
+  workspaceExists,
+  loadState,
+  getProjectName
+} from '../core/workspace.js';
+import {
+  createSession,
+  getCurrentSessionId,
+  getCurrentSessionPath,
+  createIntake,
+  createBlueprint,
+  createContract,
+  getSessionFilesStatus
+} from '../core/session.js';
+import { getCurrentState, transitionTo } from '../core/state-machine.js';
+import { STATES } from '../config/constants.js';
+import {
+  printBox,
+  printError,
+  printSuccess,
+  printProgress,
+  printStatus,
+  printNextStep
+} from '../ui/output.js';
+import { printWelcome, printDivider } from '../ui/branding.js';
+import { askSimpleDescription, askNextAction, confirmAction } from '../ui/prompts.js';
+
+export async function startCommand(options = {}) {
+  try {
+    // Check workspace
+    if (!await workspaceExists()) {
+      printError('No Vibecode workspace found.');
+      console.log('Run `vibecode init` first.');
+      process.exit(1);
+    }
+
+    // Load current state
+    const currentState = await getCurrentState();
+    const projectName = await getProjectName();
+    let sessionId = await getCurrentSessionId();
+
+    // Print welcome
+    printWelcome();
+    printDivider();
+    printStatus(projectName, currentState, sessionId);
+    printProgress(currentState);
+    printDivider();
+
+    // Handle based on state
+    switch (currentState) {
+      case STATES.INIT:
+        await handleInit(projectName);
+        break;
+
+      case STATES.INTAKE_CAPTURED:
+        await handleIntakeCaptured(projectName);
+        break;
+
+      case STATES.BLUEPRINT_DRAFTED:
+        await handleBlueprintDrafted(projectName);
+        break;
+
+      case STATES.CONTRACT_DRAFTED:
+        await handleContractDrafted(projectName);
+        break;
+
+      case STATES.CONTRACT_LOCKED:
+        await handleContractLocked(projectName);
+        break;
+
+      default:
+        console.log(chalk.yellow(`State ${currentState} not fully handled in MVP.`));
+        console.log('This will be implemented in Phase B.');
+    }
+
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+}
+
+async function handleInit(projectName) {
+  console.log();
+  console.log(chalk.cyan('🏗️  Bắt đầu dự án mới!\n'));
+
+  // Get project description
+  const description = await askSimpleDescription();
+
+  if (!description || description.trim().length < 10) {
+    printError('Mô tả quá ngắn. Vui lòng thử lại.');
+    return;
+  }
+
+  const spinner = ora('Creating session...').start();
+
+  // Create session
+  const sessionId = await createSession(projectName);
+  spinner.text = 'Capturing intake...';
+
+  // Create intake
+  await createIntake(projectName, description, sessionId);
+
+  // Transition state
+  await transitionTo(STATES.INTAKE_CAPTURED, 'intake_captured');
+
+  spinner.succeed('Intake captured!');
+
+  const sessionPath = await getCurrentSessionPath();
+  console.log();
+  printSuccess(`Intake saved to: ${chalk.gray(path.join(sessionPath, 'intake.md'))}`);
+  printNextStep('Review intake.md then run `vibecode start` to continue');
+}
+
+async function handleIntakeCaptured(projectName) {
+  console.log();
+  console.log(chalk.cyan('📋 Intake đã được capture. Sẵn sàng tạo Blueprint.\n'));
+
+  const action = await askNextAction(STATES.INTAKE_CAPTURED);
+
+  if (action === 'blueprint') {
+    const spinner = ora('Creating blueprint...').start();
+    const sessionId = await getCurrentSessionId();
+
+    await createBlueprint(projectName, sessionId);
+    await transitionTo(STATES.BLUEPRINT_DRAFTED, 'blueprint_created');
+
+    spinner.succeed('Blueprint created!');
+
+    const sessionPath = await getCurrentSessionPath();
+    printSuccess(`Blueprint saved to: ${chalk.gray(path.join(sessionPath, 'blueprint.md'))}`);
+    printNextStep('Edit blueprint.md then run `vibecode start` to continue');
+
+  } else if (action === 'view_intake') {
+    const sessionPath = await getCurrentSessionPath();
+    console.log(chalk.gray(`\nIntake file: ${path.join(sessionPath, 'intake.md')}`));
+
+  } else {
+    console.log('Goodbye!');
+  }
+}
+
+async function handleBlueprintDrafted(projectName) {
+  console.log();
+  console.log(chalk.cyan('📘 Blueprint đã sẵn sàng. Tạo Contract?\n'));
+
+  const action = await askNextAction(STATES.BLUEPRINT_DRAFTED);
+
+  if (action === 'contract') {
+    const spinner = ora('Creating contract...').start();
+    const sessionId = await getCurrentSessionId();
+
+    await createContract(projectName, sessionId);
+    await transitionTo(STATES.CONTRACT_DRAFTED, 'contract_created');
+
+    spinner.succeed('Contract created!');
+
+    const sessionPath = await getCurrentSessionPath();
+    printSuccess(`Contract saved to: ${chalk.gray(path.join(sessionPath, 'contract.md'))}`);
+    printNextStep('Edit contract.md then run `vibecode lock` to finalize');
+
+  } else if (action === 'edit_blueprint') {
+    const sessionPath = await getCurrentSessionPath();
+    console.log(chalk.gray(`\nBlueprint file: ${path.join(sessionPath, 'blueprint.md')}`));
+
+  } else {
+    console.log('Goodbye!');
+  }
+}
+
+async function handleContractDrafted(projectName) {
+  console.log();
+  console.log(chalk.cyan('📜 Contract đã được tạo. Sẵn sàng lock?\n'));
+
+  const sessionPath = await getCurrentSessionPath();
+  console.log(chalk.gray(`Contract file: ${path.join(sessionPath, 'contract.md')}`));
+  console.log();
+
+  const action = await askNextAction(STATES.CONTRACT_DRAFTED);
+
+  if (action === 'lock') {
+    console.log(chalk.yellow('\nRun `vibecode lock` to lock the contract.'));
+
+  } else if (action === 'edit_contract') {
+    console.log(chalk.gray(`\nEdit: ${path.join(sessionPath, 'contract.md')}`));
+
+  } else {
+    console.log('Goodbye!');
+  }
+}
+
+async function handleContractLocked(projectName) {
+  console.log();
+
+  const content = `🎉 Contract is LOCKED!
+
+Your project is ready for build.
+
+In Phase B, you will be able to:
+• Run \`vibecode build\` to start building
+• Run \`vibecode review\` for QA checks
+
+For now, you can:
+• Transfer the contract to Claude Code
+• Use Vibecode Kit prompts for building`;
+
+  printBox(content, { borderColor: 'green' });
+
+  const sessionPath = await getCurrentSessionPath();
+  console.log();
+  console.log(chalk.cyan('📁 Your files:'));
+  console.log(chalk.gray(`   ${sessionPath}/`));
+  console.log(chalk.gray('   ├── intake.md'));
+  console.log(chalk.gray('   ├── blueprint.md'));
+  console.log(chalk.gray('   └── contract.md 🔒'));
+}

package/src/commands/status.js

@@ -0,0 +1,80 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Status Command
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import chalk from 'chalk';
+import {
+  workspaceExists,
+  loadState,
+  getProjectName
+} from '../core/workspace.js';
+import { getCurrentSessionId, getSessionFilesStatus } from '../core/session.js';
+import { getSpecHash } from '../core/contract.js';
+import {
+  printBox,
+  printError,
+  printProgress,
+  printStatus,
+  printNextStep
+} from '../ui/output.js';
+import { STATES } from '../config/constants.js';
+
+export async function statusCommand(options = {}) {
+  try {
+    // Check workspace exists
+    if (!await workspaceExists()) {
+      printError('No Vibecode workspace found.');
+      console.log('Run `vibecode init` first.');
+      process.exit(1);
+    }
+
+    // Load data
+    const stateData = await loadState();
+    const projectName = await getProjectName();
+    const sessionId = await getCurrentSessionId();
+    const specHash = await getSpecHash();
+    const filesStatus = await getSessionFilesStatus();
+
+    // Output
+    if (options.json) {
+      console.log(JSON.stringify({
+        project: projectName,
+        state: stateData.current_state,
+        session: sessionId,
+        specHash: specHash,
+        files: filesStatus
+      }, null, 2));
+      return;
+    }
+
+    // Visual output
+    console.log();
+    printStatus(projectName, stateData.current_state, sessionId, specHash);
+    printProgress(stateData.current_state);
+
+    // Files status
+    if (filesStatus) {
+      console.log();
+      console.log(chalk.cyan('📁 Session Files:'));
+      console.log(chalk.gray(`   ├── intake.md ${filesStatus.intake ? '✅' : '⬜'}`));
+      console.log(chalk.gray(`   ├── blueprint.md ${filesStatus.blueprint ? '✅' : '⬜'}`));
+      console.log(chalk.gray(`   └── contract.md ${filesStatus.contract ? (specHash ? '🔒' : '📝') : '⬜'}`));
+    }
+
+    // Next step hint
+    const hints = {
+      [STATES.INIT]: 'Run `vibecode start` to capture requirements',
+      [STATES.INTAKE_CAPTURED]: 'Create blueprint for your project',
+      [STATES.BLUEPRINT_DRAFTED]: 'Create contract with deliverables',
+      [STATES.CONTRACT_DRAFTED]: 'Run `vibecode lock` to finalize contract',
+      [STATES.CONTRACT_LOCKED]: 'Contract locked! Ready for build (Phase B)',
+    };
+
+    printNextStep(hints[stateData.current_state] || 'Continue with your workflow');
+    console.log();
+
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+}

package/src/config/constants.js

@@ -0,0 +1,89 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Constants & Configuration
+// Spec Hash: 0fe43335f5a325e3279a079ce616c052
+// ═══════════════════════════════════════════════════════════════════════════════
+
+export const VERSION = '1.0.0';
+export const SPEC_HASH = '0fe43335f5a325e3279a079ce616c052';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// State Machine
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const STATES = {
+  INIT: 'INIT',
+  INTAKE_CAPTURED: 'INTAKE_CAPTURED',
+  BLUEPRINT_DRAFTED: 'BLUEPRINT_DRAFTED',
+  CONTRACT_DRAFTED: 'CONTRACT_DRAFTED',
+  CONTRACT_LOCKED: 'CONTRACT_LOCKED',
+  BUILD_IN_PROGRESS: 'BUILD_IN_PROGRESS',
+  BUILD_DONE: 'BUILD_DONE',
+  REVIEW_PASSED: 'REVIEW_PASSED',
+  REVIEW_FAILED: 'REVIEW_FAILED'
+};
+
+export const 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],
+  [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]
+};
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Progress Display Mapping
+// ─────────────────────────────────────────────────────────────────────────────
+
+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: '⬜' }
+};
+
+// ─────────────────────────────────────────────────────────────────────────────
+// File & Folder Names
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const WORKSPACE_DIR = '.vibecode';
+export const CONFIG_FILE = 'vibecode.yaml';
+export const STATE_FILE = 'state.json';
+export const SESSIONS_DIR = 'sessions';
+export const LIBRARY_DIR = 'library';
+export const LOGS_DIR = 'logs';
+export const AUDIT_LOG = 'audit.log';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Contract Validation
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const CONTRACT_REQUIRED_SECTIONS = [
+  { key: 'goal', name: 'Goal', pattern: /##\s*🎯\s*Goal/i },
+  { key: 'inscope', name: 'In-Scope', pattern: /##\s*✅\s*In-Scope/i },
+  { key: 'outscope', name: 'Out-of-Scope', pattern: /##\s*❌\s*Out-of-Scope/i },
+  { key: 'deliverables', name: 'Deliverables', pattern: /##\s*📦\s*Deliverables/i },
+  { key: 'acceptance', name: 'Acceptance Criteria', pattern: /##\s*✔️\s*Acceptance Criteria/i }
+];
+
+// ─────────────────────────────────────────────────────────────────────────────
+// UI Colors
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const COLORS = {
+  primary: 'cyan',
+  success: 'green',
+  warning: 'yellow',
+  error: 'red',
+  muted: 'gray',
+  highlight: 'magenta',
+  info: 'blue'
+};

package/src/config/templates.js

@@ -0,0 +1,194 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Template Generators
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Get intake template with values filled
+ */
+export function getIntakeTemplate(projectName, description, sessionId) {
+  const timestamp = new Date().toISOString();
+
+  return `# 📥 INTAKE: ${projectName}
+
+## Captured: ${timestamp}
+## Session: ${sessionId}
+
+---
+
+## 🎯 Mô tả dự án
+
+${description}
+
+---
+
+## 📋 Parsed Information
+
+### Project Type
+[To be detected by AI]
+
+### Key Requirements
+- [To be extracted from description]
+
+### Target Users
+[To be identified]
+
+### Constraints
+[To be noted]
+
+---
+
+## ✅ Status
+
+- [x] Intake captured
+- [ ] Ready for Blueprint
+
+---
+
+*Generated by Vibecode CLI v1.0*
+`;
+}
+
+/**
+ * Get blueprint template
+ */
+export function getBlueprintTemplate(projectName, sessionId) {
+  const timestamp = new Date().toISOString();
+
+  return `# 📘 BLUEPRINT: ${projectName}
+
+## Session: ${sessionId}
+## Created: ${timestamp}
+
+---
+
+## 🎯 Project Overview
+
+| Field | Value |
+|-------|-------|
+| Type | [Fill in] |
+| Name | ${projectName} |
+| Goal | [Fill in] |
+
+---
+
+## 📐 Architecture
+
+[Describe your architecture here]
+
+---
+
+## 🎨 Design System
+
+### Colors
+- Primary: #3B82F6
+- Secondary: #10B981
+- Accent: #F59E0B
+
+### Typography
+- Headings: Inter
+- Body: Inter
+
+---
+
+## 💻 Tech Stack
+
+- Framework: Next.js 14
+- Styling: Tailwind CSS
+- Database: [If needed]
+- Auth: [If needed]
+
+---
+
+## 📁 File Structure
+
+\`\`\`
+src/
+├── app/
+├── components/
+├── lib/
+└── styles/
+\`\`\`
+
+---
+
+## ✅ Checkpoint
+
+- [ ] Structure approved
+- [ ] Design approved
+- [ ] Tech stack approved
+
+---
+
+*Generated by Vibecode CLI v1.0*
+`;
+}
+
+/**
+ * Get contract template
+ */
+export function getContractTemplate(projectName, sessionId) {
+  const timestamp = new Date().toISOString();
+
+  return `# 📜 CONTRACT: ${projectName}
+
+## Session: ${sessionId}
+## Created: ${timestamp}
+## Status: DRAFT
+## Spec Hash: [hash when locked]
+
+---
+
+## 🎯 Goal
+
+[Define your clear, specific goal here]
+
+---
+
+## ✅ In-Scope
+
+- [ ] [Deliverable 1]
+- [ ] [Deliverable 2]
+- [ ] [Deliverable 3]
+
+---
+
+## ❌ Out-of-Scope
+
+- [What is NOT included]
+- [Explicitly excluded items]
+
+---
+
+## 📦 Deliverables
+
+| # | Item | Description | Status |
+|---|------|-------------|--------|
+| 1 | [Item] | [Description] | ⬜ |
+
+---
+
+## ✔️ Acceptance Criteria
+
+- [ ] [Criterion 1]
+- [ ] [Criterion 2]
+
+---
+
+## ⚠️ Risks & Mitigations
+
+| Risk | Mitigation |
+|------|------------|
+| [Risk] | [Mitigation] |
+
+---
+
+## 🔙 Rollback Plan
+
+[Define rollback strategy]
+
+---
+
+*Generated by Vibecode CLI v1.0*
+*Lock this contract with \`vibecode lock\` when ready*
+`;
+}

package/src/core/contract.js

@@ -0,0 +1,103 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Contract Validation & Locking
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import { CONTRACT_REQUIRED_SECTIONS } from '../config/constants.js';
+import { readSessionFile, writeSessionFile, sessionFileExists } from './session.js';
+import { loadState, saveState } from './workspace.js';
+import { generateSpecHash } from '../utils/hash.js';
+import { logAudit } from './state-machine.js';
+
+/**
+ * Validate contract content
+ */
+export function validateContract(content) {
+  const errors = [];
+  const warnings = [];
+
+  for (const section of CONTRACT_REQUIRED_SECTIONS) {
+    if (!section.pattern.test(content)) {
+      errors.push(`Missing required section: ${section.name}`);
+    } else {
+      // Check if section has content (not just header)
+      const sectionMatch = content.match(new RegExp(`${section.pattern.source}[\\s\\S]*?(?=##|$)`, 'i'));
+      if (sectionMatch) {
+        const sectionContent = sectionMatch[0].replace(section.pattern, '').trim();
+        if (sectionContent.length < 10) {
+          warnings.push(`Section "${section.name}" appears to be empty or too short`);
+        }
+      }
+    }
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+
+/**
+ * Lock contract and generate spec hash
+ */
+export async function lockContract() {
+  // Check contract exists
+  if (!await sessionFileExists('contract.md')) {
+    throw new Error('Contract file not found. Create contract first.');
+  }
+
+  // Read contract
+  const content = await readSessionFile('contract.md');
+
+  // Validate
+  const validation = validateContract(content);
+  if (!validation.valid) {
+    return {
+      success: false,
+      errors: validation.errors,
+      warnings: validation.warnings
+    };
+  }
+
+  // Generate spec hash
+  const timestamp = new Date().toISOString();
+  const specHash = generateSpecHash(content, timestamp);
+
+  // Update contract with spec hash and locked status
+  const updatedContent = content
+    .replace(/## Status: DRAFT/i, '## Status: LOCKED')
+    .replace(/## Spec Hash: \[hash when locked\]/i, `## Spec Hash: ${specHash}`);
+
+  await writeSessionFile('contract.md', updatedContent);
+
+  // Update state
+  const stateData = await loadState();
+  stateData.spec_hash = specHash;
+  await saveState(stateData);
+
+  // Log
+  await logAudit(`Contract locked with spec hash: ${specHash}`);
+
+  return {
+    success: true,
+    specHash,
+    timestamp,
+    warnings: validation.warnings
+  };
+}
+
+/**
+ * Get current spec hash
+ */
+export async function getSpecHash() {
+  const stateData = await loadState();
+  return stateData.spec_hash;
+}
+
+/**
+ * Check if contract is locked
+ */
+export async function isContractLocked() {
+  const specHash = await getSpecHash();
+  return specHash !== null;
+}