@nclamvn/vibecode-cli 1.6.0 → 1.8.0

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

@@ -0,0 +1,173 @@
+---
+sidebar_position: 13
+---
+
+# vibecode debug
+
+**Debug Mode** - Intelligent 9-step bug fixing.
+
+## Synopsis
+
+```bash
+vibecode debug [description...] [options]
+```
+
+## Description
+
+The `debug` command uses a systematic 9-step protocol to identify, fix, and prevent bugs. It combines error analysis, AI-powered fixing, and automated verification.
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `description` | Description of the error (optional) |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-i, --interactive` | Interactive debug session |
+| `-a, --auto` | Auto-scan and fix errors |
+| `-l, --log <text>` | Provide error log directly |
+| `--image <path>` | Provide error screenshot |
+| `--attempts <n>` | Max fix attempts (default: 3) |
+| `-v, --verbose` | Show detailed output |
+| `-q, --quiet` | Minimal output |
+
+## Examples
+
+### Interactive Mode
+
+```bash
+vibecode debug
+```
+
+### With Error Description
+
+```bash
+vibecode debug "TypeError: Cannot read properties of undefined"
+```
+
+### Auto-Scan Mode
+
+```bash
+vibecode debug --auto
+```
+
+### From Error Log
+
+```bash
+vibecode debug --log "Error: ENOENT: no such file or directory"
+```
+
+### With Screenshot
+
+```bash
+vibecode debug --image ./error-screenshot.png
+```
+
+## The 9-Step Protocol
+
+### 1. EVIDENCE
+Gather error information from logs, description, or screenshots.
+
+### 2. REPRODUCE
+Confirm the error exists by running relevant commands.
+
+### 3. ANALYZE
+Identify root cause using pattern matching and AI analysis.
+
+### 4. HYPOTHESIZE
+Generate fix hypotheses ranked by confidence.
+
+### 5. TEST
+Prepare fix prompt and validate approach.
+
+### 6. FIX
+Apply fix via Claude Code.
+
+### 7. VERIFY
+Confirm the fix works by re-running tests.
+
+### 8. DOCUMENT
+Log the fix for future reference.
+
+### 9. PREVENT
+Add prevention rules to CLAUDE.md.
+
+## Error Translation
+
+Vibecode translates technical errors to human-friendly Vietnamese:
+
+```
+❌ TypeError: Cannot read properties of undefined (reading 'map')
+
+Translates to:
+
+╭────────────────────────────────────────────────────────────╮
+│  ❌ LỖI: Biến chưa được định nghĩa                         │
+│                                                            │
+│  Vấn đề: Code đang cố truy cập thuộc tính 'map'           │
+│           của một biến undefined                           │
+│                                                            │
+│  💡 Gợi ý:                                                 │
+│  • Kiểm tra biến có được khởi tạo trước khi sử dụng       │
+│  • Thêm optional chaining (?.) khi truy cập thuộc tính    │
+│  • Kiểm tra null/undefined với if statement               │
+│                                                            │
+╰────────────────────────────────────────────────────────────╯
+```
+
+## Output
+
+```
+🔍 VIBECODE DEBUG - Intelligent Bug Fixing
+
+[1/9 EVIDENCE] Gathering error information...
+  Type: TypeError
+  Category: RUNTIME
+  Error: Biến chưa được định nghĩa
+  → Code đang cố truy cập thuộc tính 'map' của một biến undefined
+
+[2/9 REPRODUCE] Confirming error exists...
+  ✓ Error confirmed
+
+[3/9 ANALYZE] Analyzing root cause...
+  Root cause: Missing null check
+  Confidence: 85%
+
+[4/9 HYPOTHESIZE] Generating fix hypotheses...
+  Generated 2 hypothesis(es):
+  - Add optional chaining... (90%)
+  - Add null check... (85%)
+
+[5/9 TEST] Preparing fix...
+[6/9 FIX] Applying fix via Claude Code...
+[7/9 VERIFY] Verifying fix...
+  ✓ Fix verified successfully!
+
+[8/9 DOCUMENT] Documenting fix...
+[9/9 PREVENT] Adding prevention rules...
+
+✅ Bug fixed and documented!
+```
+
+## Learning Integration
+
+After each fix, Vibecode asks for feedback:
+
+```
+? Fix này có đúng không?
+  ✅ Đúng, hoạt động tốt
+  ❌ Không đúng
+  🔄 Đúng một phần
+  ⏭️  Bỏ qua
+```
+
+Your feedback helps improve future suggestions.
+
+## See Also
+
+- [Debug Mode Guide](../guides/debug-mode) - In-depth guide
+- [learn](./learn) - View learning statistics
+- [assist](./assist) - Direct AI assistance

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

@@ -0,0 +1,34 @@
+---
+sidebar_position: 5
+---
+
+# vibecode doctor
+
+Check configuration and diagnose issues.
+
+## Synopsis
+
+```bash
+vibecode doctor
+```
+
+## Description
+
+Runs diagnostic checks:
+- Node.js version
+- Claude Code availability
+- Workspace integrity
+- Configuration validity
+
+## Example Output
+
+```
+🔍 Vibecode Doctor
+
+✓ Node.js 20.10.0
+✓ Claude Code installed
+✓ Workspace valid
+✓ Configuration OK
+
+All checks passed!
+```

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

@@ -0,0 +1,128 @@
+---
+sidebar_position: 11
+---
+
+# vibecode go
+
+**Magic Mode** - Build an entire project with one command.
+
+## Synopsis
+
+```bash
+vibecode go <description> [options]
+```
+
+## Description
+
+The `go` command is Vibecode's "magic mode" - it takes a natural language description and builds a complete project automatically. It combines all workflow steps into one seamless experience.
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `description` | Natural language description of what to build |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-t, --template <name>` | Use template (landing, saas, cli, api) |
+| `-i, --iterate` | Enable iterative build mode |
+| `-m, --max <n>` | Max iterations for iterative mode |
+| `-o, --open` | Auto-open result when done |
+
+## Examples
+
+### Basic Usage
+
+```bash
+vibecode go "A landing page for my SaaS startup"
+```
+
+### With Template
+
+```bash
+vibecode go "Portfolio website" --template landing
+```
+
+### Iterative Mode
+
+Build, test, and fix until tests pass:
+
+```bash
+vibecode go "React todo app with tests" --iterate --max 5
+```
+
+### Auto-Open Result
+
+```bash
+vibecode go "Simple blog" --open
+```
+
+## What Happens
+
+When you run `go`, Vibecode automatically:
+
+1. **INIT** - Creates project directory
+2. **INTAKE** - Captures requirements from description
+3. **BLUEPRINT** - Designs architecture
+4. **CONTRACT** - Generates contract
+5. **LOCK** - Locks contract with spec hash
+6. **PLAN** - Creates execution plan
+7. **BUILD** - Generates code with Claude Code
+8. **REVIEW** - Runs tests and validates
+
+## Progress Display
+
+```
+╭────────────────────────────────────────────────────────────╮
+│   🚀 VIBECODE MAGIC MODE                                   │
+│                                                            │
+│   "Landing page for my startup"                            │
+│   → startup-landing                                        │
+│                                                            │
+╰────────────────────────────────────────────────────────────╯
+
+[████████████████████░░░░░░░░░░░░░░░░░░░░]  45%
+
+✓ INIT
+✓ INTAKE
+✓ BLUEPRINT
+✓ CONTRACT
+✓ LOCK
+◐ PLAN (in progress)
+○ BUILD
+○ REVIEW
+```
+
+## Output
+
+On success:
+
+```
+╭────────────────────────────────────────────────────────────╮
+│  🎉 BUILD COMPLETE!                                        │
+│                                                            │
+│  📁 Project:  startup-landing                              │
+│  📂 Location: /Users/you/startup-landing                   │
+│  🔐 Spec:     abc123...                                    │
+│  📄 Files:    12 created                                   │
+│  🧪 Tests:    8/8 passed                                   │
+│  ⏱️  Duration: 2.5 minutes                                 │
+│                                                            │
+│  💡 Next: cd startup-landing                               │
+│                                                            │
+╰────────────────────────────────────────────────────────────╯
+```
+
+## Tips
+
+- **Be specific**: More detail = better results
+- **Mention tech stack**: "React app with Tailwind" vs just "website"
+- **Include features**: "with auth, dashboard, and API"
+
+## See Also
+
+- [Magic Mode Guide](../guides/magic-mode) - In-depth guide
+- [agent](./agent) - For complex multi-module projects
+- [build](./build) - For step-by-step control

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

@@ -0,0 +1,79 @@
+---
+sidebar_position: 1
+---
+
+# Commands Overview
+
+Vibecode CLI provides 16 commands organized into four categories.
+
+## Quick Reference
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `go` | Magic mode - one command build | `vibecode go "todo app"` |
+| `agent` | Multi-module autonomous build | `vibecode agent "e-commerce"` |
+| `debug` | Intelligent bug fixing | `vibecode debug "TypeError..."` |
+| `assist` | Direct AI assistance | `vibecode assist "how to..."` |
+
+## Categories
+
+### Workflow Commands
+
+Setup and state management:
+
+| Command | Description |
+|---------|-------------|
+| [`init`](./init) | Initialize Vibecode workspace |
+| [`start`](./start) | Start guided session |
+| [`status`](./status) | Display current state |
+| [`lock`](./lock) | Lock contract and generate spec hash |
+| [`doctor`](./doctor) | Check configuration |
+
+### Build Commands
+
+Code generation and review:
+
+| Command | Description |
+|---------|-------------|
+| [`plan`](./plan) | Create execution plan |
+| [`build`](./build) | Build with AI |
+| [`review`](./review) | Review against criteria |
+| [`snapshot`](./snapshot) | Create release snapshot |
+| [`config`](./config) | Manage configuration |
+
+### Power Features
+
+Advanced AI capabilities:
+
+| Command | Description |
+|---------|-------------|
+| [`go`](./go) | Magic mode - full automated build |
+| [`agent`](./agent) | Multi-module autonomous builder |
+| [`debug`](./debug) | 9-step intelligent debugging |
+| [`assist`](./assist) | Direct Claude Code access |
+
+### Polish Features
+
+UX improvements:
+
+| Command | Description |
+|---------|-------------|
+| [`undo`](./undo) | Rollback to previous state |
+| [`learn`](./learn) | View AI learning stats |
+
+## Global Options
+
+All commands support:
+
+```bash
+--help, -h     Show help
+--version, -V  Show version
+```
+
+## Interactive Mode
+
+Run `vibecode` with no arguments for interactive wizard:
+
+```bash
+vibecode
+```

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

@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# vibecode init
+
+Initialize a Vibecode workspace in the current directory.
+
+## Synopsis
+
+```bash
+vibecode init [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-f, --force` | Overwrite existing workspace |
+| `-q, --quiet` | Minimal output |
+
+## Examples
+
+```bash
+# Basic initialization
+vibecode init
+
+# Force overwrite existing
+vibecode init --force
+```
+
+## What It Does
+
+1. Creates `.vibecode/` directory
+2. Initializes `state.json`
+3. Creates session structure
+4. Sets initial state to `initialized`
+
+## See Also
+
+- [start](./start) - Start guided session
+- [status](./status) - Check current state

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

@@ -0,0 +1,82 @@
+---
+sidebar_position: 16
+---
+
+# vibecode learn
+
+View and manage AI learnings from feedback.
+
+## Synopsis
+
+```bash
+vibecode learn [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-s, --stats` | Show learning statistics |
+| `-c, --clear` | Clear all learnings |
+| `-e, --export` | Export learnings to file |
+| `-f, --force` | Skip confirmation |
+
+## Examples
+
+### View Statistics
+
+```bash
+vibecode learn --stats
+```
+
+Output:
+```
+╭────────────────────────────────────────────────────────────╮
+│  📊 LEARNING STATISTICS                                    │
+╰────────────────────────────────────────────────────────────╯
+
+  📁 Project Learnings
+     Tổng fixes: 15
+     Thành công: 12 (80%)
+
+  🌍 Global Learnings
+     Tổng fixes: 45
+     Thành công: 38 (84.4%)
+
+  📂 Theo Error Category
+     RUNTIME      ██████████ 5/5 (100%)
+     SYNTAX       ████████░░ 4/5 (80%)
+     MODULE       ██████░░░░ 3/5 (60%)
+
+  ⚙️  Preferences đã lưu: 3
+  📅 Learning gần nhất: 10 phút trước
+```
+
+### Export Learnings
+
+```bash
+vibecode learn --export
+```
+
+### Clear Learnings
+
+```bash
+vibecode learn --clear --force
+```
+
+## How Learning Works
+
+1. After each successful fix, Vibecode asks for feedback
+2. Feedback is stored locally and globally (anonymized)
+3. Future suggestions use past successes
+4. Higher confidence for patterns with good track record
+
+## Storage
+
+- Local: `.vibecode/learning/`
+- Global: `~/.vibecode/learning/`
+
+## See Also
+
+- [debug](./debug) - Generates learnings
+- [assist](./assist) - Uses learnings

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

@@ -0,0 +1,33 @@
+---
+sidebar_position: 4
+---
+
+# vibecode lock
+
+Lock contract and generate spec hash.
+
+## Synopsis
+
+```bash
+vibecode lock [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-d, --dry-run` | Validate without locking |
+| `-f, --force` | Lock even with warnings |
+
+## Description
+
+Locking a contract:
+1. Validates contract completeness
+2. Generates unique spec hash
+3. Prevents further contract changes
+4. Enables build phase
+
+## See Also
+
+- [start](./start) - Create contract
+- [build](./build) - Build from locked contract

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

@@ -0,0 +1,29 @@
+---
+sidebar_position: 6
+---
+
+# vibecode plan
+
+Create execution plan from locked contract.
+
+## Synopsis
+
+```bash
+vibecode plan
+```
+
+## Description
+
+Generates:
+1. Step-by-step execution plan
+2. Coder pack for Claude Code
+3. File structure preview
+
+## Prerequisites
+
+- Contract must be locked (`vibecode lock`)
+
+## See Also
+
+- [lock](./lock) - Lock contract first
+- [build](./build) - Execute the plan

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

@@ -0,0 +1,31 @@
+---
+sidebar_position: 8
+---
+
+# vibecode review
+
+Review build against acceptance criteria.
+
+## Synopsis
+
+```bash
+vibecode review [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--skip-manual` | Skip manual verification |
+
+## Description
+
+Runs:
+1. Automated tests
+2. Acceptance criteria check
+3. Manual verification prompts (optional)
+
+## See Also
+
+- [build](./build) - Build first
+- [snapshot](./snapshot) - Create release

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

@@ -0,0 +1,34 @@
+---
+sidebar_position: 9
+---
+
+# vibecode snapshot
+
+Create release snapshot with version bump.
+
+## Synopsis
+
+```bash
+vibecode snapshot [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--patch` | Patch version (default) |
+| `--minor` | Minor version |
+| `--major` | Major version |
+
+## Examples
+
+```bash
+# Patch release (1.0.0 -> 1.0.1)
+vibecode snapshot
+
+# Minor release (1.0.0 -> 1.1.0)
+vibecode snapshot --minor
+
+# Major release (1.0.0 -> 2.0.0)
+vibecode snapshot --major
+```

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

@@ -0,0 +1,32 @@
+---
+sidebar_position: 2
+---
+
+# vibecode start
+
+Start a guided Vibecode session.
+
+## Synopsis
+
+```bash
+vibecode start [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-r, --resume` | Resume existing session |
+
+## Description
+
+Launches an interactive session that guides you through:
+1. Requirements capture (intake)
+2. Architecture design (blueprint)
+3. Contract creation
+4. Contract locking
+
+## See Also
+
+- [init](./init) - Initialize workspace
+- [lock](./lock) - Lock contract