@nclamvn/vibecode-cli 1.7.0 → 1.8.1

package/docs-site/docs/faq.md

@@ -1,83 +0,0 @@
----
-sidebar_position: 8
----
-
-# FAQ
-
-Frequently asked questions about Vibecode CLI.
-
-## General
-
-### What is Vibecode?
-
-Vibecode is a CLI tool for AI-assisted software development with built-in discipline and guardrails.
-
-### Is it free?
-
-Yes, Vibecode CLI is open source and free. However, you need an Anthropic API key for Claude Code.
-
-### What models does it use?
-
-Vibecode uses Claude Code CLI which uses Claude 3.5 Sonnet by default.
-
-## Installation
-
-### Why do I need Claude Code?
-
-Claude Code provides the AI capabilities for code generation, debugging, and assistance.
-
-### Node.js version error?
-
-Upgrade to Node.js 18 or higher:
-```bash
-nvm install 20
-nvm use 20
-```
-
-## Usage
-
-### Magic Mode vs Agent Mode?
-
-- **Magic Mode** (`go`): Single-module projects, quick prototypes
-- **Agent Mode** (`agent`): Complex multi-module systems
-
-### How do I undo changes?
-
-```bash
-vibecode undo --list  # See available backups
-vibecode undo         # Interactive restore
-```
-
-### How does learning work?
-
-After each fix, Vibecode asks for feedback. This helps improve future suggestions.
-
-## Troubleshooting
-
-### Build failed?
-
-1. Check logs: `cat .vibecode/sessions/*/evidence/build.log`
-2. Try iterative mode: `vibecode go "desc" --iterate`
-3. Use debug: `vibecode debug --auto`
-
-### Tests failing?
-
-Run with strict mode to see issues:
-```bash
-vibecode build --iterate --strict
-```
-
-### Claude Code not found?
-
-```bash
-npm install -g @anthropic-ai/claude-code
-```
-
-## Contributing
-
-### How can I contribute?
-
-- Report issues on GitHub
-- Submit pull requests
-- Improve documentation
-- Share feedback

package/docs-site/docs/getting-started.md

@@ -1,119 +0,0 @@
----
-sidebar_position: 2
----
-
-# Getting Started
-
-Get up and running with Vibecode CLI in minutes.
-
-## Prerequisites
-
-Before installing Vibecode, ensure you have:
-
-1. **Node.js 18+**
-   ```bash
-   node --version  # Should be v18.0.0 or higher
-   ```
-
-2. **Claude Code CLI** (for AI features)
-   ```bash
-   npm install -g @anthropic-ai/claude-code
-   ```
-
-## Installation
-
-Install Vibecode globally:
-
-```bash
-npm install -g @nclamvn/vibecode-cli
-```
-
-Verify installation:
-
-```bash
-vibecode --version
-# Output: 1.6.0
-```
-
-## Your First Project
-
-### Option 1: Interactive Wizard
-
-Simply run `vibecode` with no arguments:
-
-```bash
-vibecode
-```
-
-You'll see an interactive menu:
-
-```
-? Bạn muốn làm gì hôm nay?
-  🚀 Tạo project mới nhanh (go)
-  🤖 Build project phức tạp (agent)
-  🔧 Debug lỗi (debug)
-  💬 Hỏi AI (assist)
-  📊 Xem trạng thái
-```
-
-### Option 2: Magic Mode
-
-Build a complete project with one command:
-
-```bash
-vibecode go "A todo app with React and local storage"
-```
-
-Vibecode will:
-1. Create project directory
-2. Capture requirements
-3. Design architecture
-4. Generate code
-5. Run tests
-6. Show results
-
-### Option 3: Step-by-Step Workflow
-
-For more control, use the guided workflow:
-
-```bash
-# Initialize workspace
-vibecode init
-
-# Start guided session
-vibecode start
-
-# ... follow prompts ...
-
-# Build with AI
-vibecode build --auto
-
-# Review results
-vibecode review
-```
-
-## Project Structure
-
-After running `vibecode init`, your project will have:
-
-```
-your-project/
-├── .vibecode/
-│   ├── state.json         # Current state
-│   ├── sessions/          # Session data
-│   │   └── [session-id]/
-│   │       ├── intake.md      # Requirements
-│   │       ├── blueprint.md   # Architecture
-│   │       ├── contract.md    # Locked spec
-│   │       ├── plan.md        # Execution plan
-│   │       └── evidence/      # Build logs
-│   ├── backups/           # Auto-backups
-│   └── learning/          # AI learnings
-└── ... your code files
-```
-
-## Next Steps
-
-- [Commands Overview](./commands) - Learn all available commands
-- [Magic Mode Guide](./guides/magic-mode) - Deep dive into `vibecode go`
-- [Configuration](./configuration) - Customize Vibecode behavior

package/docs-site/docs/guides/agent-mode.md

@@ -1,94 +0,0 @@
----
-sidebar_position: 2
----
-
-# Agent Mode Guide
-
-Build complex multi-module projects with autonomous agents.
-
-## Overview
-
-Agent Mode decomposes large projects into modules, builds each sequentially, and uses self-healing to recover from errors.
-
-## When to Use Agent Mode
-
-✅ **Good for:**
-- Complex full-stack applications
-- Projects with multiple features
-- Systems with many integrations
-- Production-grade builds
-
-## Architecture
-
-```
-┌─────────────────────────────────────────┐
-│            Orchestrator                 │
-├─────────────────────────────────────────┤
-│  ┌─────────┐ ┌─────────┐ ┌─────────┐   │
-│  │Decompose│→│ Build   │→│ Verify  │   │
-│  └─────────┘ └─────────┘ └─────────┘   │
-│        ↓          ↓          ↓         │
-│  ┌─────────────────────────────────┐   │
-│  │         Memory Engine           │   │
-│  └─────────────────────────────────┘   │
-│        ↓                               │
-│  ┌─────────────────────────────────┐   │
-│  │       Self-Healing Engine       │   │
-│  └─────────────────────────────────┘   │
-└─────────────────────────────────────────┘
-```
-
-## Module Types
-
-Agent Mode recognizes common module patterns:
-
-- **auth** - Authentication/authorization
-- **api** - REST/GraphQL endpoints
-- **database** - Schema and models
-- **ui** - Frontend components
-- **admin** - Admin dashboard
-- **integration** - Third-party services
-
-## Example: E-commerce
-
-```bash
-vibecode agent "E-commerce platform with:
-- User authentication (email, OAuth)
-- Product catalog with categories
-- Shopping cart with sessions
-- Checkout with Stripe
-- Admin dashboard
-- Order management"
-```
-
-Agent decomposes into:
-1. `auth` - User system
-2. `products` - Catalog
-3. `cart` - Shopping cart
-4. `checkout` - Payment
-5. `admin` - Dashboard
-6. `orders` - Management
-
-## Self-Healing
-
-When a module fails:
-
-1. **Analyze** - Identify error pattern
-2. **Hypothesize** - Generate fix
-3. **Apply** - Make changes
-4. **Verify** - Re-test
-5. **Learn** - Store pattern
-
-Max 3 retries per module by default.
-
-## Memory System
-
-Agent remembers:
-- Successful build patterns
-- Common error fixes
-- Technology preferences
-
-View with:
-```bash
-vibecode agent --status
-```

package/docs-site/docs/guides/debug-mode.md

@@ -1,83 +0,0 @@
----
-sidebar_position: 3
----
-
-# Debug Mode Guide
-
-Master the 9-step intelligent debugging protocol.
-
-## Overview
-
-Debug Mode uses a systematic approach to identify, fix, and prevent bugs.
-
-## The 9 Steps
-
-### Step 1: Evidence
-Collect information about the error from:
-- Error logs
-- Stack traces
-- User descriptions
-- Screenshots
-
-### Step 2: Reproduce
-Confirm the error exists by running:
-- Type checking
-- Build commands
-- Test suites
-
-### Step 3: Analyze
-Identify root cause:
-- Pattern matching
-- AI analysis
-- Category detection
-
-### Step 4: Hypothesize
-Generate fix hypotheses:
-- Ranked by confidence
-- Based on past successes
-- Multiple approaches
-
-### Step 5: Test
-Validate the approach:
-- Generate fix prompt
-- Prepare changes
-
-### Step 6: Fix
-Apply fix via Claude Code:
-- Make changes
-- Log evidence
-
-### Step 7: Verify
-Confirm fix works:
-- Re-run tests
-- Check functionality
-
-### Step 8: Document
-Log for future:
-- Store fix pattern
-- Update history
-
-### Step 9: Prevent
-Add prevention rules:
-- Update CLAUDE.md
-- Add warnings
-
-## Error Categories
-
-| Category | Examples |
-|----------|----------|
-| RUNTIME | undefined, null, type errors |
-| SYNTAX | Unexpected tokens |
-| MODULE | Missing imports |
-| FILE | ENOENT |
-| NETWORK | ECONNREFUSED |
-| NPM | Dependency issues |
-| DATABASE | Connection, query errors |
-| TYPESCRIPT | Type mismatches |
-
-## Tips
-
-1. **Be specific** - Include full error message
-2. **Use auto mode** - Let AI scan for all errors
-3. **Provide context** - Mention what you were doing
-4. **Give feedback** - Help AI learn from fixes

package/docs-site/docs/guides/magic-mode.md

@@ -1,107 +0,0 @@
----
-sidebar_position: 1
----
-
-# Magic Mode Guide
-
-A comprehensive guide to using `vibecode go` for one-command project building.
-
-## Overview
-
-Magic Mode is Vibecode's flagship feature - describe what you want, and it builds the entire project automatically.
-
-## When to Use Magic Mode
-
-✅ **Good for:**
-- Prototypes and MVPs
-- Landing pages
-- Simple full-stack apps
-- Learning projects
-
-❌ **Consider Agent Mode for:**
-- Complex multi-module systems
-- Enterprise applications
-- Projects with many integrations
-
-## Best Practices
-
-### 1. Be Specific
-
-```bash
-# ❌ Too vague
-vibecode go "a website"
-
-# ✅ Specific
-vibecode go "Landing page for a SaaS product with hero, features, pricing, and contact sections using React and Tailwind"
-```
-
-### 2. Mention Tech Stack
-
-```bash
-vibecode go "Todo app with React, TypeScript, and local storage"
-```
-
-### 3. Include Key Features
-
-```bash
-vibecode go "Blog platform with markdown support, categories, search, and dark mode"
-```
-
-### 4. Use Templates
-
-```bash
-vibecode go "My startup landing" --template landing
-```
-
-## Understanding the Process
-
-### Phase 1: Initialization (5%)
-- Creates project directory
-- Sets up workspace structure
-
-### Phase 2: Requirements (10%)
-- Parses your description
-- Generates intake document
-
-### Phase 3: Architecture (15%)
-- Designs system blueprint
-- Identifies components
-
-### Phase 4: Contract (20%)
-- Creates acceptance criteria
-- Defines deliverables
-
-### Phase 5: Planning (25%)
-- Generates execution plan
-- Prepares coder pack
-
-### Phase 6: Building (85%)
-- Claude Code generates files
-- Implements features
-
-### Phase 7: Testing (95%)
-- Runs automated tests
-- Validates functionality
-
-## Troubleshooting
-
-### Build Failed
-
-```bash
-# Check logs
-cat .vibecode/sessions/*/evidence/build.log
-
-# Try iterative mode
-vibecode go "your description" --iterate
-```
-
-### Tests Failing
-
-```bash
-# Use strict mode to see issues
-vibecode go "your description" --iterate --strict
-```
-
-### Missing Features
-
-Be more explicit in your description or use `vibecode assist` to add features after initial build.

package/docs-site/docs/installation.md

@@ -1,98 +0,0 @@
----
-sidebar_position: 3
----
-
-# Installation
-
-Complete guide to installing Vibecode CLI.
-
-## System Requirements
-
-| Requirement | Minimum | Recommended |
-|-------------|---------|-------------|
-| Node.js | 18.0.0 | 20.x LTS |
-| npm | 9.0.0 | Latest |
-| OS | macOS, Linux, Windows | macOS, Linux |
-| RAM | 4 GB | 8 GB+ |
-
-## Install via npm
-
-```bash
-npm install -g @nclamvn/vibecode-cli
-```
-
-## Install Claude Code (Required for AI features)
-
-Vibecode uses Claude Code CLI for AI-powered features:
-
-```bash
-npm install -g @anthropic-ai/claude-code
-```
-
-Set up your Anthropic API key:
-```bash
-export ANTHROPIC_API_KEY="your-api-key"
-```
-
-## Verify Installation
-
-```bash
-# Check Vibecode version
-vibecode --version
-
-# Check Claude Code
-claude --version
-
-# Run doctor to verify setup
-vibecode doctor
-```
-
-## Updating
-
-```bash
-npm update -g @nclamvn/vibecode-cli
-```
-
-## Uninstalling
-
-```bash
-npm uninstall -g @nclamvn/vibecode-cli
-```
-
-## Troubleshooting
-
-### Permission Errors
-
-If you get `EACCES` errors:
-
-```bash
-# Option 1: Use npx
-npx @nclamvn/vibecode-cli
-
-# Option 2: Fix npm permissions
-mkdir ~/.npm-global
-npm config set prefix '~/.npm-global'
-echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
-source ~/.bashrc
-```
-
-### Node.js Version Issues
-
-```bash
-# Check version
-node --version
-
-# Use nvm to install correct version
-nvm install 20
-nvm use 20
-```
-
-### Claude Code Not Found
-
-```bash
-# Verify installation
-which claude
-
-# Reinstall if needed
-npm install -g @anthropic-ai/claude-code
-```

package/docs-site/docs/intro.md

@@ -1,67 +0,0 @@
----
-sidebar_position: 1
----
-
-# Introduction
-
-**Vibecode CLI** is a command-line tool that helps you build software with AI assistance while maintaining discipline and control.
-
-## What is Vibecode?
-
-Vibecode provides a structured workflow for AI-assisted software development:
-
-- **Guided Process**: From requirements capture to deployment
-- **AI Integration**: Powered by Claude Code for intelligent code generation
-- **Quality Guardrails**: Built-in testing, review, and rollback capabilities
-- **Learning System**: AI improves from your feedback over time
-
-## Key Features
-
-### Magic Mode (`vibecode go`)
-One command to build an entire project:
-```bash
-vibecode go "Landing page for my SaaS startup"
-```
-
-### Agent Mode (`vibecode agent`)
-Multi-module autonomous building with self-healing:
-```bash
-vibecode agent "E-commerce platform with auth, products, and checkout"
-```
-
-### Debug Mode (`vibecode debug`)
-Intelligent 9-step bug fixing:
-```bash
-vibecode debug "TypeError in user authentication"
-```
-
-### Undo & Learn
-Auto-backup with rollback, and AI that learns from your feedback:
-```bash
-vibecode undo --list
-vibecode learn --stats
-```
-
-## Quick Start
-
-```bash
-# Install globally
-npm install -g @nclamvn/vibecode-cli
-
-# Run interactive wizard
-vibecode
-
-# Or start with Magic Mode
-vibecode go "Your project description"
-```
-
-## Requirements
-
-- Node.js 18.0.0 or higher
-- Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)
-
-## Next Steps
-
-- [Getting Started](./getting-started) - First steps with Vibecode
-- [Installation](./installation) - Detailed installation guide
-- [Commands](./commands) - All available commands