@nclamvn/vibecode-cli 1.8.0 → 1.8.1

package/SESSION_NOTES.md

@@ -0,0 +1,119 @@
+# VIBECODE CLI - SESSION NOTES
+> Cập nhật: 2025-12-22
+
+---
+
+## 📍 TRẠNG THÁI HIỆN TẠI
+
+### ✅ ĐÃ HOÀN THÀNH
+
+1. **Landing Page** - Port design Notion + Anthropic style
+   - File: `docs-site/src/pages/index.tsx`
+   - Style: WHITE background (#FAFAFA), Be Vietnam Pro font
+   - Sections: Hero, Terminal, Process, Features, Philosophy, CTA
+
+2. **i18n Vietnamese** - Đa ngôn ngữ EN/VI
+   - Translations: `docs-site/i18n/vi/`
+   - Docs tiếng Việt đầy đủ 26 commands
+
+3. **GitHub Repos** (Private)
+   - CLI: https://github.com/nclamvn/vibecode-cli
+   - Docs: https://github.com/nclamvn/vibecode-docs
+
+4. **NPM Package** - Deprecated (beta warning)
+   - Package: @nclamvn/vibecode-cli
+   - Status: Deprecated với message cảnh báo beta
+
+5. **UI Fixes**
+   - Loại bỏ logo khủng long
+   - Footer màu đen đồng nhất (#0A0A0A)
+   - Theme toggle icon thu nhỏ 60%
+   - Default: Light mode
+
+---
+
+## 🚧 ĐANG LÀM
+
+### Deploy Render
+- Repo: nclamvn/vibecode-docs
+- File: render.yaml đã có
+- **BƯỚC TIẾP THEO**: Điền `build` vào Publish Directory rồi click Deploy
+
+---
+
+## 📁 CẤU TRÚC PROJECT
+
+```
+/Users/mac/vibecode-cli/
+├── src/                    # CLI source (26 commands)
+├── bin/vibecode.js         # Entry point
+├── package.json            # v1.8.0
+├── docs-site/              # Docusaurus site (separate git repo)
+│   ├── src/pages/index.tsx # Landing page
+│   ├── docs/               # English docs
+│   ├── i18n/vi/            # Vietnamese docs
+│   └── render.yaml         # Render deploy config
+└── SESSION_NOTES.md        # File này
+```
+
+---
+
+## 🔧 COMMANDS THƯỜNG DÙNG
+
+```bash
+# Dev server
+cd /Users/mac/vibecode-cli/docs-site
+npm start
+
+# Build
+npm run build
+
+# Push docs
+cd /Users/mac/vibecode-cli/docs-site
+git add . && git commit -m "message" && git push
+
+# Push CLI
+cd /Users/mac/vibecode-cli
+git add . && git commit -m "message" && git push
+
+# Bỏ deprecate npm khi sẵn sàng
+npm deprecate @nclamvn/vibecode-cli ""
+```
+
+---
+
+## 📊 THỐNG KÊ
+
+| Metric | Value |
+|--------|-------|
+| CLI Commands | 26 |
+| Lines of Code | 18,612 |
+| JS Files | 167 |
+| Docs Pages | 40+ (EN + VI) |
+
+---
+
+## 🎯 VIỆC CẦN LÀM TIẾP
+
+1. [ ] Hoàn thành deploy Render
+2. [ ] Test site trên production URL
+3. [ ] Phase L: Unit Tests & TypeScript (optional)
+4. [ ] Khi sẵn sàng: Bỏ deprecate npm package
+
+---
+
+## 🔗 LINKS
+
+- Landing EN: http://localhost:3000/
+- Landing VI: http://localhost:3000/vi/
+- GitHub CLI: https://github.com/nclamvn/vibecode-cli
+- GitHub Docs: https://github.com/nclamvn/vibecode-docs
+- NPM: https://www.npmjs.com/package/@nclamvn/vibecode-cli
+
+---
+
+## 💬 ĐỂ TIẾP TỤC
+
+Chỉ cần nói: **"tiếp tục"** hoặc **"continue"**
+
+Claude sẽ đọc file này và biết cần làm gì tiếp.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nclamvn/vibecode-cli",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "Build software with discipline - AI coding with guardrails",
   "main": "src/index.js",
   "type": "module",

package/src/config/constants.js

@@ -3,7 +3,11 @@
 // Spec Hash: 0fe43335f5a325e3279a079ce616c052
 // ═══════════════════════════════════════════════════════════════════════════════
 
-export const VERSION = '1.0.1';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+
+export const VERSION = pkg.version;
 export const SPEC_HASH = '0fe43335f5a325e3279a079ce616c052';
 
 // ─────────────────────────────────────────────────────────────────────────────

package/docs-site/README.md

@@ -1,41 +0,0 @@
-# Website
-
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
-
-## Installation
-
-```bash
-yarn
-```
-
-## Local Development
-
-```bash
-yarn start
-```
-
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
-
-## Build
-
-```bash
-yarn build
-```
-
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
-
-## Deployment
-
-Using SSH:
-
-```bash
-USE_SSH=true yarn deploy
-```
-
-Not using SSH:
-
-```bash
-GIT_USER=<Your GitHub username> yarn deploy
-```
-
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

package/docs-site/blog/2019-05-28-first-blog-post.md

@@ -1,12 +0,0 @@
----
-slug: first-blog-post
-title: First Blog Post
-authors: [slorber, yangshun]
-tags: [hola, docusaurus]
----
-
-Lorem ipsum dolor sit amet...
-
-<!-- truncate -->
-
-...consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

package/docs-site/blog/2019-05-29-long-blog-post.md

@@ -1,44 +0,0 @@
----
-slug: long-blog-post
-title: Long Blog Post
-authors: yangshun
-tags: [hello, docusaurus]
----
-
-This is the summary of a very long blog post,
-
-Use a `<!--` `truncate` `-->` comment to limit blog post size in the list view.
-
-<!-- truncate -->
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

package/docs-site/blog/2021-08-01-mdx-blog-post.mdx

@@ -1,24 +0,0 @@
----
-slug: mdx-blog-post
-title: MDX Blog Post
-authors: [slorber]
-tags: [docusaurus]
----
-
-Blog posts support [Docusaurus Markdown features](https://docusaurus.io/docs/markdown-features), such as [MDX](https://mdxjs.com/).
-
-:::tip
-
-Use the power of React to create interactive blog posts.
-
-:::
-
-{/* truncate */}
-
-For example, use JSX to create an interactive button:
-
-```js
-<button onClick={() => alert('button clicked!')}>Click me!</button>
-```
-
-<button onClick={() => alert('button clicked!')}>Click me!</button>

package/docs-site/blog/2021-08-26-welcome/index.md

@@ -1,29 +0,0 @@
----
-slug: welcome
-title: Welcome
-authors: [slorber, yangshun]
-tags: [facebook, hello, docusaurus]
----
-
-[Docusaurus blogging features](https://docusaurus.io/docs/blog) are powered by the [blog plugin](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-blog).
-
-Here are a few tips you might find useful.
-
-<!-- truncate -->
-
-Simply add Markdown files (or folders) to the `blog` directory.
-
-Regular blog authors can be added to `authors.yml`.
-
-The blog post date can be extracted from filenames, such as:
-
-- `2019-05-30-welcome.md`
-- `2019-05-30-welcome/index.md`
-
-A blog post folder can be convenient to co-locate blog post images:
-
-![Docusaurus Plushie](./docusaurus-plushie-banner.jpeg)
-
-The blog supports tags as well!
-
-**And if you don't want a blog**: just delete this directory, and use `blog: false` in your Docusaurus config.

package/docs-site/blog/authors.yml

@@ -1,25 +0,0 @@
-yangshun:
-  name: Yangshun Tay
-  title: Ex-Meta Staff Engineer, Co-founder GreatFrontEnd
-  url: https://linkedin.com/in/yangshun
-  image_url: https://github.com/yangshun.png
-  page: true
-  socials:
-    x: yangshunz
-    linkedin: yangshun
-    github: yangshun
-    newsletter: https://www.greatfrontend.com
-
-slorber:
-  name: Sébastien Lorber
-  title: Docusaurus maintainer
-  url: https://sebastienlorber.com
-  image_url: https://github.com/slorber.png
-  page:
-    # customize the url of the author page at /blog/authors/<permalink>
-    permalink: '/all-sebastien-lorber-articles'
-  socials:
-    x: sebastienlorber
-    linkedin: sebastienlorber
-    github: slorber
-    newsletter: https://thisweekinreact.com

package/docs-site/blog/tags.yml

@@ -1,19 +0,0 @@
-facebook:
-  label: Facebook
-  permalink: /facebook
-  description: Facebook tag description
-
-hello:
-  label: Hello
-  permalink: /hello
-  description: Hello tag description
-
-docusaurus:
-  label: Docusaurus
-  permalink: /docusaurus
-  description: Docusaurus tag description
-
-hola:
-  label: Hola
-  permalink: /hola
-  description: Hola tag description

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

@@ -1,162 +0,0 @@
----
-sidebar_position: 12
----
-
-# vibecode agent
-
-**Agent Mode** - Autonomous multi-module builder with self-healing.
-
-## Synopsis
-
-```bash
-vibecode agent <description> [options]
-```
-
-## Description
-
-The `agent` command is designed for complex projects with multiple modules. It decomposes your project into independent modules, builds them sequentially, and uses self-healing to recover from errors.
-
-## Arguments
-
-| Argument | Description |
-|----------|-------------|
-| `description` | Description of the project to build |
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `-n, --new` | Create new project directory |
-| `-v, --verbose` | Show detailed progress |
-| `--analyze` | Analyze project without building |
-| `--status` | Show agent status and memory |
-| `--report` | Export memory report |
-| `--clear` | Clear agent memory |
-| `--force` | Force operation |
-| `--json` | Output as JSON |
-| `--max-retries <n>` | Max retries per module (default: 3) |
-| `--skip-tests` | Skip tests after each module |
-| `--continue` | Continue on module failure |
-
-## Examples
-
-### Build Complex Project
-
-```bash
-vibecode agent "E-commerce platform with user auth, product catalog, shopping cart, and checkout"
-```
-
-### Create New Project
-
-```bash
-vibecode agent "Blog platform with CMS" --new
-```
-
-### Analyze Without Building
-
-```bash
-vibecode agent "My project" --analyze
-```
-
-### Check Agent Status
-
-```bash
-vibecode agent --status
-```
-
-### Export Report
-
-```bash
-vibecode agent --report
-```
-
-## How It Works
-
-### 1. Decomposition
-
-The agent analyzes your description and breaks it into modules:
-
-```
-📦 Project: E-commerce Platform
-├── 🔐 auth          (User authentication)
-├── 📦 products      (Product catalog)
-├── 🛒 cart          (Shopping cart)
-├── 💳 checkout      (Payment processing)
-└── 📊 admin         (Admin dashboard)
-```
-
-### 2. Sequential Building
-
-Each module is built in dependency order with its own:
-- Requirements capture
-- Code generation
-- Test execution
-- Verification
-
-### 3. Self-Healing
-
-If a module fails:
-1. Analyze the error
-2. Generate fix
-3. Retry build
-4. Max 3 attempts per module
-
-### 4. Memory System
-
-The agent remembers:
-- Successful patterns
-- Common errors
-- Fix strategies
-
-## Progress Dashboard
-
-```
-╭────────────────────────────────────────────────────────────╮
-│  🤖 VIBECODE AGENT                                         │
-│                                                            │
-│  Project: e-commerce-platform                              │
-│  Mode: build                                               │
-│                                                            │
-│  [████████████████░░░░░░░░░░░░░░░░░░░░░░]  40%             │
-│                                                            │
-│  ✓ auth                                                    │
-│  ✓ products                                                │
-│  ◐ cart (building...)                                      │
-│  ○ checkout                                                │
-│  ○ admin                                                   │
-│                                                            │
-│  Elapsed: 5m 32s     │  ETA: ~8m remaining                 │
-│                                                            │
-╰────────────────────────────────────────────────────────────╯
-```
-
-## Memory Report
-
-```bash
-vibecode agent --report
-```
-
-Output:
-```markdown
-# Vibecode Agent Memory Report
-
-## Statistics
-- Total builds: 15
-- Success rate: 87%
-- Modules built: 42
-
-## Common Patterns
-- Next.js App Router: 8 times
-- Prisma + PostgreSQL: 5 times
-- Tailwind CSS: 12 times
-
-## Learned Fixes
-- TypeScript strict mode: 3 applications
-- ESLint config: 2 applications
-```
-
-## See Also
-
-- [Agent Mode Guide](../guides/agent-mode) - In-depth guide
-- [go](./go) - For simpler single-module projects
-- [debug](./debug) - For fixing issues

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

@@ -1,71 +0,0 @@
----
-sidebar_position: 14
----
-
-# vibecode assist
-
-**Expert Mode** - Direct Claude Code access with project context.
-
-## Synopsis
-
-```bash
-vibecode assist [prompt...] [options]
-```
-
-## Alias
-
-```bash
-vibecode expert [prompt...]
-```
-
-## Description
-
-The `assist` command provides direct access to Claude Code with full project context injected. Use it for quick questions, code explanations, or custom tasks.
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--no-context` | Skip context injection |
-
-## Examples
-
-### Ask a Question
-
-```bash
-vibecode assist "How do I add authentication to this app?"
-```
-
-### Code Explanation
-
-```bash
-vibecode assist "Explain the user service module"
-```
-
-### Custom Task
-
-```bash
-vibecode assist "Add error handling to all API routes"
-```
-
-### Without Context
-
-```bash
-vibecode assist "What is the best way to handle state in React?" --no-context
-```
-
-## Context Injection
-
-By default, `assist` injects project context including:
-
-- Current state and session info
-- Contract and blueprint (if available)
-- Recent build history
-- Error patterns
-
-This helps Claude Code provide more relevant responses.
-
-## See Also
-
-- [debug](./debug) - For bug fixing
-- [go](./go) - For building new features

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

@@ -1,53 +0,0 @@
----
-sidebar_position: 7
----
-
-# vibecode build
-
-Manage build process and capture evidence.
-
-## Synopsis
-
-```bash
-vibecode build [options]
-```
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `-s, --start` | Start build process |
-| `-c, --complete` | Mark build complete |
-| `-e, --evidence` | Capture evidence snapshot |
-| `-a, --auto` | Auto-build with Claude Code |
-| `-i, --iterate` | Build-test-fix loop |
-| `-m, --max <n>` | Max iterations |
-| `--strict` | Exit with error if tests fail |
-| `--provider <name>` | Provider (default: claude-code) |
-
-## Examples
-
-### Manual Build
-
-```bash
-vibecode build --start
-# ... do work ...
-vibecode build --complete
-```
-
-### Auto Build
-
-```bash
-vibecode build --auto
-```
-
-### Iterative Build
-
-```bash
-vibecode build --iterate --max 5
-```
-
-## See Also
-
-- [plan](./plan) - Create plan first
-- [review](./review) - Review after build

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

@@ -1,30 +0,0 @@
----
-sidebar_position: 10
----
-
-# vibecode config
-
-Manage Vibecode configuration.
-
-## Synopsis
-
-```bash
-vibecode config [options]
-```
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--show` | Show current configuration |
-| `--provider <name>` | Set default AI provider |
-
-## Examples
-
-```bash
-# Show config
-vibecode config --show
-
-# Set provider
-vibecode config --provider claude-code
-```