@nclamvn/vibecode-cli 1.8.0 → 1.8.1

package/docs-site/docs/commands/status.md

@@ -1,37 +0,0 @@
----
-sidebar_position: 3
----
-
-# vibecode status
-
-Display current state and progress.
-
-## Synopsis
-
-```bash
-vibecode status [options]
-```
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--json` | Output as JSON |
-| `-v, --verbose` | Show detailed info |
-
-## Examples
-
-```bash
-# Basic status
-vibecode status
-
-# JSON output
-vibecode status --json
-
-# Detailed info
-vibecode status --verbose
-```
-
-## See Also
-
-- [doctor](./doctor) - Check configuration

package/docs-site/docs/commands/undo.md

@@ -1,83 +0,0 @@
----
-sidebar_position: 15
----
-
-# vibecode undo
-
-Undo/rollback to previous state.
-
-## Synopsis
-
-```bash
-vibecode undo [options]
-```
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `-l, --list` | List available backups |
-| `-s, --step <n>` | Restore to N steps ago |
-| `-c, --clear` | Clear all backups |
-| `-f, --force` | Skip confirmation |
-
-## Examples
-
-### List Backups
-
-```bash
-vibecode undo --list
-```
-
-Output:
-```
-╭────────────────────────────────────────────────────────────╮
-│  📦 BACKUP HISTORY                                         │
-╰────────────────────────────────────────────────────────────╯
-
-   1. build-auto
-      5 phút trước · 12 files
-
-   2. agent-build
-      1 giờ trước · 8 files
-
-  Chạy vibecode undo để restore
-```
-
-### Interactive Restore
-
-```bash
-vibecode undo
-```
-
-### Restore Specific Step
-
-```bash
-vibecode undo --step 2
-```
-
-### Force Restore
-
-```bash
-vibecode undo --step 1 --force
-```
-
-## How Backups Work
-
-Backups are created automatically before:
-- `vibecode build --auto`
-- `vibecode agent`
-- `vibecode go`
-
-Stored in `.vibecode/backups/` with:
-- File content snapshots
-- MD5 hash verification
-- Manifest for restore
-
-Last 10 backups are kept.
-
-## See Also
-
-- [build](./build) - Triggers backup
-- [agent](./agent) - Triggers backup
-- [go](./go) - Triggers backup

package/docs-site/docs/configuration.md

@@ -1,72 +0,0 @@
----
-sidebar_position: 7
----
-
-# Configuration
-
-Customize Vibecode behavior to fit your workflow.
-
-## Configuration Files
-
-### `.vibecode/state.json`
-
-Project-level state:
-
-```json
-{
-  "currentState": "initialized",
-  "projectName": "my-project",
-  "spec_hash": "abc123...",
-  "created": "2024-01-01T00:00:00Z"
-}
-```
-
-### `~/.vibecode/config.json`
-
-Global configuration:
-
-```json
-{
-  "defaultProvider": "claude-code",
-  "preferredLanguage": "vi",
-  "autoBackup": true
-}
-```
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `ANTHROPIC_API_KEY` | API key for Claude |
-| `VIBECODE_PROVIDER` | Override default provider |
-| `VIBECODE_DEBUG` | Enable debug logging |
-
-## Provider Configuration
-
-```bash
-# Set default provider
-vibecode config --provider claude-code
-
-# View current config
-vibecode config --show
-```
-
-## Backup Settings
-
-Backups are created automatically before:
-- Auto builds
-- Agent builds
-- Magic mode
-
-Stored in `.vibecode/backups/` (last 10 kept).
-
-## Learning Settings
-
-Learnings stored in:
-- Local: `.vibecode/learning/`
-- Global: `~/.vibecode/learning/`
-
-Clear with:
-```bash
-vibecode learn --clear
-```

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.