viepilot 1.3.1 → 1.8.0

package/docs/dev/cli-reference.md

@@ -5,10 +5,12 @@
 ## Installation
 
 ```bash
-# Sau khi install ViePilot
+# Sau khi install ViePilot (global: npm i -g viepilot — có `vp-tools` trên PATH)
 vp-tools help
 ```
 
+Sau `npm i -g viepilot`, lệnh `vp-tools` (cùng bundle với `npx viepilot`) có sẵn để gọi `info` / `update` mà không cần clone repo.
+
 ---
 
 ## Commands
@@ -291,6 +293,73 @@ vp-tools help version
 
 ---
 
+### `info [--json]`
+
+Hiển thị metadata bundle ViePilot: thư mục gốc package đã resolve, version đã cài, (nếu có mạng) version mới nhất trên npm, optional `git HEAD`, danh sách **skills** và **workflows** kèm semver trong frontmatter (skills).
+
+**Không cần** project có `.viepilot/` — CLI resolve gói `viepilot` từ vị trí `vp-tools.cjs` hoặc từ `process.cwd()`.
+
+```bash
+vp-tools info
+vp-tools info --json
+```
+
+**Flags**:
+
+| Flag | Description |
+|------|-------------|
+| `--json` | In một object JSON duy nhất (parse-friendly) |
+
+**JSON shape** (`vp-tools info --json`, rút gọn):
+
+```json
+{
+  "packageRoot": "/path/to/viepilot",
+  "packageName": "viepilot",
+  "installedVersion": "1.5.1",
+  "latestNpm": { "ok": true, "version": "1.5.1" },
+  "gitHead": "abc1234…",
+  "skills": [
+    { "id": "vp-auto", "version": "0.1.0", "relativePath": "skills/vp-auto/SKILL.md" }
+  ],
+  "workflows": [
+    { "id": "autonomous", "relativePath": "workflows/autonomous.md", "semverInFile": null, "note": "no semver in workflow markdown" }
+  ]
+}
+```
+
+**Errors**:
+- `Could not locate viepilot package root` — Cài global, thêm dependency `viepilot`, hoặc chạy `node path/to/viepilot/bin/vp-tools.cjs info` từ clone.
+
+---
+
+### `update [--dry-run] [--yes] [--global]`
+
+Nâng cấp package `viepilot` qua **npm** (local `node_modules`, global install, hoặc ép global).
+
+```bash
+vp-tools update --dry-run
+vp-tools update --yes
+vp-tools update --global --dry-run
+vp-tools update --global --yes
+```
+
+**Flags**:
+
+| Flag | Description |
+|------|-------------|
+| `--dry-run` | Chỉ in lệnh npm dự kiến và hướng dẫn rollback, **không** chạy npm |
+| `--yes` | Bỏ qua prompt; **bắt buộc** trong môi trường non-interactive khi thực sự apply |
+| `--global` | Ép `npm install -g viepilot@latest` |
+
+**Lưu ý**:
+- Trong repo **ứng dụng** có `node_modules/viepilot`, bản mặc định có thể cập nhật **dependency local** — dùng `--global` nếu chỉ muốn nâng bản global.
+- Non-interactive: dùng `vp-tools update --dry-run` trước, sau đó `vp-tools update --yes` (hoặc `--global --yes`).
+
+**Success**: Thông báo `npm update completed` hoặc `already up to date` (no-op).
+
+---
+
 ## Exit Codes
 
 | Code | Meaning |

package/docs/dev/contributing.md

@@ -14,6 +14,10 @@ Hướng dẫn đóng góp cho ViePilot framework.
    ```bash
    ./dev-install.sh
    ```
+   Để **symlink** toàn bộ `skills/vp-*` về repo (sửa skill là Cursor thấy ngay), dùng:
+   ```bash
+   VIEPILOT_SYMLINK_SKILLS=1 ./dev-install.sh
+   ```
 4. Tạo branch cho feature/fix:
    ```bash
    git checkout -b feat/my-new-skill

package/docs/dev/deployment.md

@@ -24,11 +24,10 @@ cd viepilot
 ./install.sh
 ```
 
-`install.sh` copies:
+`install.sh` is a thin **bash** wrapper: optional **cloc** / **PATH** prompts, then **`node bin/viepilot.cjs install`** (same **Node** engine as `npx viepilot install`). It installs to:
 - `skills/vp-*/` → `~/.cursor/skills/`
-- `workflows/` → `~/.cursor/viepilot/workflows/`
-- `templates/` → `~/.cursor/viepilot/templates/`
-- `bin/vp-tools.cjs` → `~/.local/bin/vp-tools`
+- `workflows/`, `templates/`, `bin/`, `lib/` → `~/.cursor/viepilot/…`
+- Optional PATH symlinks (Unix) via `VIEPILOT_ADD_PATH=1`
 
 ### Method 3: Development Mode
 

package/docs/skills-reference.md

@@ -26,6 +26,8 @@ Complete reference for all ViePilot skills.
 
 ### Output
 - `docs/brainstorm/session-{YYYY-MM-DD}.md`
+- **Product horizon:** session file giữ **`## Product horizon`** (MVP / Post-MVP / Future tags, deferred capabilities, hoặc single-release statement) để `/vp-crystallize` không bỏ sót post-MVP — xem `workflows/brainstorm.md`.
+- UI Direction (optional): `.viepilot/ui-direction/{session-id}/` — legacy (`index.html`) hoặc multi-page (`pages/*.html` + hub + `## Pages inventory` trong `notes.md`). Chi tiết: [UI Direction](user/features/ui-direction.md).
 
 ---
 
@@ -33,6 +35,14 @@ Complete reference for all ViePilot skills.
 
 **Purpose**: Chuyển đổi brainstorm thành executable artifacts
 
+### UI direction intake
+- Nếu có `.viepilot/ui-direction/{session-id}/` với `pages/*.html`: đọc `notes.md` (**Pages inventory**), từng file page, và hub `index.html` để architecture UI không bỏ sót màn hình.
+
+### Product horizon (brainstorm → ROADMAP / context)
+- Step 1: trích **`## Product horizon`** từ mọi session; **horizon inventory** + cổng single-release / thiếu section — `workflows/crystallize.md`.
+- `ROADMAP.md`: luôn có block **Post-MVP / Product horizon** (hoặc ghi rõ single-release); `PROJECT-CONTEXT.md`: khối **`<product_vision>`** từ `templates/project/PROJECT-CONTEXT.md`.
+- Hướng dẫn user tổng quan: [product-horizon.md](user/features/product-horizon.md). Thứ tự load cho AI: `templates/project/AI-GUIDE.md` (bản crystallize copy vào `.viepilot/AI-GUIDE.md`).
+
 ### Metadata Collection
 - Project name, description
 - Organization name, website
@@ -190,6 +200,23 @@ AI pauses for user input when:
 
 ---
 
+## /vp-info
+
+**Purpose**: Xem metadata bundle ViePilot — version đã cài, npm latest, danh sách skills/workflows (FEAT-008).
+
+### CLI
+| Invocation | Description |
+|------------|-------------|
+| `vp-tools info` | Bảng human-readable |
+| `vp-tools info --json` | JSON parse được: `packageRoot`, `packageName`, `installedVersion`, `latestNpm`, `gitHead`, `skills[]`, `workflows[]` |
+| `node node_modules/viepilot/bin/vp-tools.cjs info` | Từ project có dependency `viepilot` |
+
+### JSON fields (tóm tắt)
+- **`skills[]`**: `id`, `version`, `relativePath`
+- **`workflows[]`**: `id`, `relativePath`, `semverInFile`, `note`
+
+---
+
 ## /vp-docs
 
 **Purpose**: Generate documentation
@@ -399,3 +426,20 @@ CHANGELOG.md (updated)
 | `skip N --reason "..."` | Skip task N |
 | `retry N` | Retry failed task N |
 | `rollback N` | Rollback task N changes |
+
+---
+
+## /vp-update
+
+**Purpose**: Nâng cấp package `viepilot` qua npm — có dry-run và xác nhận non-interactive (FEAT-008).
+
+### Flags
+| Flag | Description |
+|------|-------------|
+| `--dry-run` | In planned npm command, không chạy |
+| `--yes` | Bỏ qua prompt; **bắt buộc** trong non-interactive khi apply |
+| `--global` | Ép `npm install -g viepilot@latest` |
+
+### Lưu ý
+- Trong repo **application** có `node_modules/viepilot`, update mặc định có thể target **local** — dùng **`--global`** nếu chỉ muốn global.
+- Luồng an toàn: `vp-tools update --dry-run` → sau đó `vp-tools update --yes` (hoặc `--global --yes`).

package/docs/troubleshooting.md

@@ -68,6 +68,43 @@ chmod +x install.sh
 
 ---
 
+### `npx viepilot install` vs dev clone — upgrade / cài lại có “conflict” không?
+
+**Không có** giao diện merge từng file. Hành vi phụ thuộc **script nào** chạy:
+
+| Cách cài | Script | Trước khi ghi file mới |
+|----------|--------|-------------------------|
+| **`npx viepilot install`** (mọi `--target`) | **`bin/viepilot.cjs`** + `lib/viepilot-install.cjs` (Node, **không** bash) | **Không** xóa `~/.cursor/skills/vp-*` hay `~/.cursor/viepilot`; copy đè tương đương **`cp -r`**. File cùng tên bị ghi đè; file **chỉ còn ở bản cũ** có thể **vẫn nằm lại** (orphan). |
+| **`./install.sh`** từ clone / tarball | Thin **bash** wrapper → gọi `node bin/viepilot.cjs install` | Cùng engine Node như NPX; bash chỉ còn prompt (cloc, PATH) khi không `VIEPILOT_AUTO_YES=1`. |
+| **`./dev-install.sh`** từ clone repo | `dev-install.sh` | **Có** xóa sạch `vp-*` skills + **`rm -rf ~/.cursor/viepilot`** rồi cài lại → gần như cài mới hoàn toàn. |
+
+`npx viepilot install` chạy **trực tiếp** Node installer — **không** spawn `bash install.sh`. `install.sh` dùng khi bạn chạy tay từ repo và muốn prompt cloc/PATH giống trước.
+
+**Muốn cài sạch sau bản cũ** (tránh sót file):
+
+```bash
+npx viepilot uninstall --yes
+npx viepilot install --target cursor-agent --yes
+```
+
+(Chọn lại `--target` đúng profile bạn dùng.)
+
+---
+
+### Windows / đa OS: `install.sh` và `npx viepilot install` chạy thế nào?
+
+**`npx viepilot install`** dùng **Node** (`lib/viepilot-install.cjs`) — **không** cần Bash. **`./install.sh`** là wrapper Bash (prompt cloc/PATH) rồi gọi `node bin/viepilot.cjs install …`. **`dev-install.sh`** vẫn là Bash đầy đủ (xóa + copy).
+
+| OS | `npx viepilot install` | `./install.sh` |
+|----|------------------------|----------------|
+| **macOS**, **Linux** | Chỉ cần Node trên PATH | Bash → Node (cùng engine với NPX) |
+| **Windows (CMD/PowerShell)** | Chạy được với Node | Cần Git Bash / WSL cho file `.sh`, hoặc: `node bin\viepilot.cjs install --target cursor-agent --yes` |
+| **PATH `/usr/local/bin`** | Tùy chọn trong installer (Unix); Windows bỏ qua / PATH thủ công | |
+
+Với ViePilot **Node-native install**, lỗi **`bash: command not found`** khi chạy **`npx viepilot install`** không còn điển hình — nếu vẫn gặp trên bản cũ, hãy nâng ViePilot hoặc dùng `node bin/viepilot.cjs install …` từ source.
+
+---
+
 ### `vp-tools: command not found`
 
 **Cause**: ViePilot bin not in PATH.

package/docs/user/features/brainstorm.md

@@ -0,0 +1,28 @@
+# Brainstorm sessions — product horizon (MVP / Post-MVP / Future)
+
+ViePilot brainstorm lưu session tại `docs/brainstorm/session-*.md`. Để **không mất** ý tưởng sau MVP khi chạy `/vp-crystallize`, mỗi session nên có section **`## Product horizon`** (workflow tự gợi ý cấu trúc khi lưu).
+
+## Tag trên từng bullet
+
+| Tag | Ý nghĩa |
+|-----|---------|
+| `(MVP)` | Ship trong bản đầu tiên |
+| `(Post-MVP)` | Đã thống nhất nhưng sau release đầu |
+| `(Future)` | Hướng thử nghiệm / chưa cam kết |
+
+## Các subsection khuyến nghị
+
+- **Non-goals for MVP** — Cố tình không làm ở bản đầu (tránh bị hiểu là “quên”).
+- **Deferred capabilities** — Tính năng rõ ràng bị lùi khỏi MVP để crystallize map vào roadmap horizon.
+
+## Single-release (không có post-MVP)
+
+Ghi một dòng explicit trong `## Product horizon`, ví dụ: **Single-release product — no separate horizon epics.**
+
+## Tiếp tục session cũ
+
+Khi **Continue** session, giữ và cập nhật `## Product horizon`; không xóa section này trừ khi bạn chủ động đổi scope.
+
+## Bước tiếp
+
+Sau brainstorm: `/vp-crystallize` — horizon trong session được dùng để bổ sung roadmap và project context (xem workflow crystallize). Tổng quan end-to-end: [Product horizon](product-horizon.md).

package/docs/user/features/product-horizon.md

@@ -0,0 +1,18 @@
+# Product horizon — từ brainstorm tới roadmap (không để post-MVP “chết” trong session)
+
+Ý tưởng **sau MVP** dễ chỉ nằm trong file brainstorm rồi bị AI bỏ qua khi code. ViePilot chuẩn hóa **horizon** để mọi người (và AI) luôn thấy nó ở chỗ đúng.
+
+## Quy tắc ngắn
+
+1. Trong brainstorm: luôn có section **`## Product horizon`** với tag `(MVP)` / `(Post-MVP)` / `(Future)` — xem [Brainstorm & product horizon](brainstorm.md).
+2. Sau **`/vp-crystallize`**: horizon phải xuất hiện trong **`ROADMAP.md`** (Post-MVP / Future) và **vision theo pha** trong **`PROJECT-CONTEXT.md`** — không được “chỉ để trong `docs/brainstorm/`”.
+3. Khi AI bắt đầu task implementation sâu: đọc **vision + horizon trước**, rồi mới khóa kiến trúc chi tiết — xem thứ tự trong `AI-GUIDE.md` (file được crystallize tạo dưới `.viepilot/AI-GUIDE.md`).
+
+## Single-release
+
+Nếu không có lộ trình sau MVP, ghi rõ một dòng trong horizon (ví dụ *Single-release — no separate horizon epics*) để crystallize không bịa thêm epic.
+
+## Liên kết
+
+- Workflow brainstorm: `workflows/brainstorm.md` (trong repo ViePilot).
+- Workflow crystallize: `workflows/crystallize.md` — bước trích horizon và gate “không được lặng lẽ bỏ sót”.

package/docs/user/features/ui-direction.md

@@ -5,25 +5,76 @@
 ## Mục tiêu
 - Chốt hướng UI/UX sớm bằng prototype định hướng
 - Ghi quyết định thiết kế cùng ngữ cảnh nghiệp vụ
-- Tạo đầu vào rõ ràng cho `/vp-crystallize`
+- Tạo đầu vào rõ ràng cho `/vp-crystallize`, kể cả khi sản phẩm có **nhiều page** (FEAT-007)
 
-## Artifacts
-Mỗi session UI tạo/cập nhật:
+## Hai layout được hỗ trợ
+
+### A) Legacy — một file chính (FEAT-002)
+Dùng khi chỉ có một màn hình / một luồng prototype đơn.
 
 ```text
 .viepilot/ui-direction/{session-id}/
-  index.html
+  index.html    # toàn bộ direction
   style.css
-  notes.md
+  notes.md      # rationale, assumptions, references
+```
+
+### B) Multi-page — mỗi page một HTML (khuyến nghị khi ≥2 màn)
+Dễ diff, dễ review, dễ map sang routing thật sau này.
+
+```text
+.viepilot/ui-direction/{session-id}/
+  index.html           # hub: liên kết tới mọi page (nav / danh sách)
+  style.css            # shared styles (tránh copy lớn giữa các file)
+  pages/
+    landing.html
+    dashboard.html
+    ...
+  notes.md             # rationale + bảng inventory (bắt buộc khi có pages/)
 ```
 
-`notes.md` là nguồn sự thật cho:
-- rationale
-- assumptions
-- references (bao gồm 21st.dev links/prompts)
+- **`index.html`**: không bắt buộc trùng nội dung với một page cụ thể; nên là **mục lục + link** tới `pages/*.html` để mở nhanh từng màn.
+- **`pages/{slug}.html`**: một file cho một page/screen; đặt `slug` ổn định (trùng tên route dự kiến nếu đã biết).
+
+## `notes.md` — nguồn sự thật
+
+Luôn ghi:
+- rationale, assumptions, references (21st.dev, v.v.)
+
+### Hook bắt buộc khi thư mục `pages/` tồn tại
+
+Sau **mỗi** lần thêm / đổi tên / xóa file trong `pages/`, assistant **phải** cập nhật:
+
+1. Liên kết trong `index.html` (hub).
+2. Section **`## Pages inventory`** trong `notes.md` (bảng đầy đủ mọi page hiện có).
+
+Mẫu bảng (copy-paste và điền):
+
+```markdown
+## Pages inventory
+
+| Slug | File | Title | Purpose | Key sections | Nav to |
+|------|------|-------|---------|--------------|--------|
+| landing | pages/landing.html | Marketing home | Acquire signups | hero, features, CTA | signup, login |
+| dashboard | pages/dashboard.html | App shell | Overview metrics | sidebar, charts, alerts | settings |
+```
+
+- **Slug**: định danh ngắn, ổn định.
+- **File**: đường dẫn tương đối từ thư mục session.
+- **Nav to**: slug hoặc tên page đích (comma-separated).
+
+Nếu **không** có thư mục `pages/`, không cần section `## Pages inventory` (layout legacy).
 
 ## Flow khuyến nghị
 1. `/vp-brainstorm --ui`
-2. Cập nhật yêu cầu/điều chỉnh layout trong chat
-3. Assistant cập nhật artifacts theo từng quyết định
-4. `/vp-crystallize` đọc artifacts để map sang tech stack thật
+2. Chọn legacy hoặc multi-page theo số màn hình.
+3. Mỗi thay đổi page → cập nhật HTML + **hub + `## Pages inventory`** trong cùng một lượt.
+4. `/vp-crystallize` đọc `notes.md` trước, sau đó `index.html`, `style.css`, và **từng** `pages/*.html` (nếu có) để lên kiến trúc UI đủ page.
+
+## Kiểm tra nhanh (optional)
+
+```bash
+node scripts/verify-ui-direction-pages.cjs
+```
+
+Script báo lỗi nếu có session có `pages/*.html` nhưng thiếu `## Pages inventory` hoặc thiếu tên file page trong `notes.md`.

package/docs/user/quick-start.md

@@ -54,6 +54,25 @@ npm run readme:sync
 # refresh README Total LOC metrics via cloc
 ```
 
+### Version check & update
+
+Sau khi có `vp-tools` trên PATH (ví dụ `npm i -g viepilot` hoặc cài qua `npx viepilot install` copy bundle):
+
+```bash
+vp-tools info
+vp-tools info --json
+```
+
+Cập nhật ViePilot qua npm — nên xem trước bằng dry-run; trong script/CI thêm `--yes` khi apply:
+
+```bash
+vp-tools update --dry-run
+vp-tools update --yes
+vp-tools update --global --yes
+```
+
+Trong project có dependency `viepilot`, có thể chạy: `node node_modules/viepilot/bin/vp-tools.cjs info`.
+
 ---
 
 ## Step 2: Create a New Project
@@ -103,6 +122,9 @@ ViePilot tạo `.viepilot/` directory với:
 - `TRACKER.md` — Progress tracking
 - `ARCHITECTURE.md` — System design
 - `SYSTEM-RULES.md` — Coding standards
+- `AI-GUIDE.md` — Thứ tự đọc context (kể cả **vision / horizon** trước khi khóa kiến trúc sâu)
+
+**Post-MVP không chỉ nằm trong brainstorm:** sau crystallize, horizon phải vào `ROADMAP.md` + vision theo pha trong `PROJECT-CONTEXT.md`. Tóm tắt cho user: [Product horizon end-to-end](features/product-horizon.md).
 
 ---
 

package/install.sh

@@ -1,21 +1,22 @@
 #!/bin/bash
 
-# ViePilot Installation Script
-# Installs ViePilot skills and tools to Cursor/Claude environment
+# ViePilot installation — thin wrapper around the Node installer (bin/viepilot.cjs).
+# Implements prompts + optional cloc install here; file copy/symlink/chmod/path is in lib/viepilot-install.cjs.
+#
+# Optional: VIEPILOT_SYMLINK_SKILLS=1 — passed through to Node (symlink skills into ~/.cursor/skills/)
+# Optional: VIEPILOT_INSTALL_DRY_RUN=1 — runs `viepilot install --dry-run` (for CI/tests)
 
 set -e
 
-# Colors for output
 RED='\033[0;31m'
 GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
 BLUE='\033[0;34m'
-NC='\033[0m' # No Color
+NC='\033[0m'
 
-# Get script directory
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR" || exit 1
 
-# Default installation paths
 CURSOR_SKILLS_DIR="$HOME/.cursor/skills"
 VIEPILOT_DIR="$HOME/.cursor/viepilot"
 AUTO_YES="${VIEPILOT_AUTO_YES:-0}"
@@ -28,7 +29,6 @@ echo " VIEPILOT INSTALLER"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo -e "${NC}"
 
-# Check if running from viepilot directory
 if [ ! -f "$SCRIPT_DIR/README.md" ] || [ ! -d "$SCRIPT_DIR/skills" ]; then
     echo -e "${RED}Error: Please run this script from the viepilot directory${NC}"
     exit 1
@@ -38,6 +38,7 @@ echo -e "${YELLOW}Installation paths:${NC}"
 echo "  Skills: $CURSOR_SKILLS_DIR"
 echo "  ViePilot: $VIEPILOT_DIR"
 echo "  Profile: $INSTALL_PROFILE"
+echo "  Engine: Node (bin/viepilot.cjs) — no bash copy logic"
 echo ""
 
 install_cloc_best_effort() {
@@ -84,7 +85,6 @@ install_cloc_best_effort() {
     fi
 }
 
-# Confirm installation
 if [ "$AUTO_YES" != "1" ]; then
     read -p "Continue with installation? (y/n) " -n 1 -r
     echo
@@ -97,95 +97,29 @@ else
 fi
 
 echo ""
-echo -e "${BLUE}Installing...${NC}"
-
-# Create directories
-echo "  Creating directories..."
-mkdir -p "$CURSOR_SKILLS_DIR"
-mkdir -p "$VIEPILOT_DIR/workflows"
-mkdir -p "$VIEPILOT_DIR/templates/project"
-mkdir -p "$VIEPILOT_DIR/templates/phase"
-mkdir -p "$VIEPILOT_DIR/bin"
-mkdir -p "$VIEPILOT_DIR/lib"
-mkdir -p "$VIEPILOT_DIR/ui-components"
-
-# Install skills
-echo "  Installing skills..."
-for skill_dir in "$SCRIPT_DIR/skills"/*; do
-    if [ -d "$skill_dir" ]; then
-        skill_name=$(basename "$skill_dir")
-        cp -r "$skill_dir" "$CURSOR_SKILLS_DIR/"
-        echo "    ✓ $skill_name"
-    fi
-done
-
-# Install workflows
-echo "  Installing workflows..."
-cp -r "$SCRIPT_DIR/workflows"/* "$VIEPILOT_DIR/workflows/"
-echo "    ✓ workflows"
-
-# Install templates
-echo "  Installing templates..."
-cp -r "$SCRIPT_DIR/templates/project"/* "$VIEPILOT_DIR/templates/project/"
-cp -r "$SCRIPT_DIR/templates/phase"/* "$VIEPILOT_DIR/templates/phase/"
-echo "    ✓ templates"
-
-# Install stock UI components
-echo "  Installing stock UI components..."
-if [ -d "$SCRIPT_DIR/ui-components" ]; then
-    cp -r "$SCRIPT_DIR/ui-components"/* "$VIEPILOT_DIR/ui-components/"
-    echo "    ✓ ui-components"
-fi
-
-# Install CLI tools
-echo "  Installing CLI tools..."
-cp "$SCRIPT_DIR/bin/vp-tools.cjs" "$VIEPILOT_DIR/bin/"
-cp "$SCRIPT_DIR/bin/viepilot.cjs" "$VIEPILOT_DIR/bin/"
-cp "$SCRIPT_DIR/lib/cli-shared.cjs" "$VIEPILOT_DIR/lib/"
-chmod +x "$VIEPILOT_DIR/bin/vp-tools.cjs"
-chmod +x "$VIEPILOT_DIR/bin/viepilot.cjs"
-echo "    ✓ vp-tools.cjs + viepilot.cjs + lib/cli-shared.cjs"
-
-echo "  Checking optional dependency for README metric sync..."
+echo -e "${BLUE}Preparing Node installer...${NC}"
 install_cloc_best_effort
 
-# Create symlink in PATH (optional)
 echo ""
 if [ "$AUTO_YES" != "1" ]; then
-    read -p "Add vp-tools + viepilot to PATH? (creates symlink in /usr/local/bin) (y/n) " -n 1 -r
+    read -p "Add vp-tools + viepilot to PATH? (symlinks via Node installer, often /usr/local/bin) (y/n) " -n 1 -r
     echo
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        export VIEPILOT_ADD_PATH=1
+    fi
 else
-    REPLY=$([ "$ADD_PATH_CHOICE" = "1" ] && echo "y" || echo "n")
-fi
-if [[ $REPLY =~ ^[Yy]$ ]]; then
-    if [ -w "/usr/local/bin" ]; then
-        ln -sf "$VIEPILOT_DIR/bin/vp-tools.cjs" "/usr/local/bin/vp-tools"
-        ln -sf "$VIEPILOT_DIR/bin/viepilot.cjs" "/usr/local/bin/viepilot"
-        echo "    ✓ vp-tools + viepilot added to PATH"
-    else
-        echo -e "${YELLOW}    Note: Need sudo to create symlink${NC}"
-        sudo ln -sf "$VIEPILOT_DIR/bin/vp-tools.cjs" "/usr/local/bin/vp-tools"
-        sudo ln -sf "$VIEPILOT_DIR/bin/viepilot.cjs" "/usr/local/bin/viepilot"
-        echo "    ✓ vp-tools + viepilot added to PATH"
+    if [ "$ADD_PATH_CHOICE" = "1" ]; then
+        export VIEPILOT_ADD_PATH=1
     fi
 fi
 
+export VIEPILOT_AUTO_YES=1
+
+NODE_ARGS=(install --target "$INSTALL_PROFILE" --yes)
+if [ "${VIEPILOT_INSTALL_DRY_RUN:-0}" = "1" ]; then
+    NODE_ARGS+=(--dry-run)
+fi
+
 echo ""
-echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo -e "${GREEN} INSTALLATION COMPLETE ✓${NC}"
-echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo ""
-echo "Installed:"
-echo "  - Skills: $CURSOR_SKILLS_DIR/vp-*"
-echo "  - Workflows: $VIEPILOT_DIR/workflows/"
-echo "  - Templates: $VIEPILOT_DIR/templates/"
-echo "  - CLI: $VIEPILOT_DIR/bin/vp-tools.cjs"
-echo ""
-echo "Quick Start:"
-echo "  1. Open your project in Cursor"
-echo "  2. Run: /vp-brainstorm"
-echo "  3. After brainstorm: /vp-crystallize"
-echo "  4. Start coding: /vp-auto"
-echo ""
-echo "Documentation: $SCRIPT_DIR/docs/getting-started.md"
-echo ""
+echo -e "${BLUE}Running: node bin/viepilot.cjs ${NODE_ARGS[*]}${NC}"
+exec node "$SCRIPT_DIR/bin/viepilot.cjs" "${NODE_ARGS[@]}"