viepilot 1.9.11 → 2.1.0

package/skills/vp-request/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vp-request
-description: "Tạo request mới: feature, bug fix, enhancement, hoặc brainstorm tiếp"
+description: "Create new request: feature, bug fix, enhancement, or brainstorm continuation"
 version: 0.2.0
 ---
 
@@ -10,7 +10,7 @@ version: 0.2.0
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
 
 ## B. User Prompting
-Prompt user conversationally với numbered list options.
+Prompt user conversationally with numbered list options.
 
 ## C. Tool Usage
 Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
@@ -25,27 +25,27 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 <implementation_routing_guard>
 ## Implementation routing guard (ENH-021)
 
-- Skill này chỉ **tạo request**, **backlog**, **triage** (`.viepilot/requests/*`, `TRACKER`, đôi khi gợi ý ROADMAP) — **không** implement mã shipping mặc định (`lib/`, `tests/`, `bin/`, `workflows/`, `skills/` của repo, v.v.).
-- **Sau request:** **`/vp-evolve`** (ROADMAP + phase + tasks + plan) → **`/vp-auto`** (thực thi). Xem `workflows/request.md`.
-- **Ngoại lệ:** User **explicit** (*hotfix ngay*, *sửa trong chat này*, *bypass planning*) — phải **nêu rõ** bypass trong chat.
-- **Không** đề xuất *“Start working now”* như implement trực tiếp trong thread này; thay bằng evolve → auto.
+- This skill only **creates requests**, **backlog**, **triage** (`.viepilot/requests/*`, `TRACKER`, sometimes suggests ROADMAP) — does **not** implement default shipping code (`lib/`, `tests/`, `bin/`, `workflows/`, `skills/` of the repo, etc.).
+- **After request:** **`/vp-evolve`** (ROADMAP + phase + tasks + plan) → **`/vp-auto`** (execute). See `workflows/request.md`.
+- **Exception:** User **explicit** (*hotfix now*, *fix in this chat*, *bypass planning*) — must **state clearly** the bypass in chat.
+- **Do not** suggest *”Start working now”* as direct implementation in this thread; use evolve → auto instead.
 </implementation_routing_guard>
 
 
 <objective>
-Tạo và quản lý requests cho dự án đang phát triển:
-- Bug report và fix
+Create and manage requests for the project under development:
+- Bug report and fix
 - Feature request
 - Enhancement/Improvement
 - Technical debt
-- Brainstorm tiếp cho ý tưởng mới
+- Brainstorm continuation for new ideas
 
 **Creates/Updates:**
 - `.viepilot/requests/{TYPE}-{NUMBER}.md`
-- `.viepilot/TRACKER.md` (thêm vào backlog)
-- `.viepilot/ROADMAP.md` (nếu approved)
+- `.viepilot/TRACKER.md` (add to backlog)
+- `.viepilot/ROADMAP.md` (if approved)
 
-**Routes to:** `/vp-auto` hoặc `/vp-evolve` tùy loại request
+**Routes to:** `/vp-auto` or `/vp-evolve` depending on request type
 </objective>
 
 <execution_context>

package/skills/vp-resume/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vp-resume
-description: "Resume work từ previous session với full context restoration"
+description: "Resume work from previous session with full context restoration"
 version: 0.1.1
 ---
 
@@ -10,7 +10,7 @@ version: 0.1.1
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
 
 ## B. User Prompting
-Prompt user conversationally với options.
+Prompt user conversationally with options.
 
 ## C. Tool Usage
 Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
@@ -25,12 +25,12 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 <implementation_routing_guard>
 ## Implementation routing guard (ENH-021)
 
-- **Khôi phục context** — không implement shipping mặc định; tiếp tục **`/vp-auto`** khi có task plan. Xem `workflows/request.md`.
+- **Restore context** — does not implement default shipping; continue with **`/vp-auto`** when a task plan exists. See `workflows/request.md`.
 </implementation_routing_guard>
 
 
 <objective>
-Restore complete project context và resume work seamlessly.
+Restore complete project context and resume work seamlessly.
 
 **Reads:**
 - `.viepilot/HANDOFF.json`

package/skills/vp-rollback/SKILL.md

@@ -25,14 +25,14 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 <implementation_routing_guard>
 ## Implementation routing guard (ENH-021)
 
-- **Checkpoint / revert** — không thay **`/vp-auto`** cho work mới; sau rollback dùng **`/vp-evolve`** / **`/vp-auto`** theo quy trình. Xem `workflows/request.md`.
+- **Checkpoint / revert** — does not replace **`/vp-auto`** for new work; after rollback use **`/vp-evolve`** / **`/vp-auto`** per workflow. See `workflows/request.md`.
 </implementation_routing_guard>
 
 
 <objective>
-Rollback đến bất kỳ checkpoint nào một cách an toàn, với backup và state preservation.
+Rollback to any checkpoint safely, with backup and state preservation.
 
-**Checkpoints:** Git tags với prefix `vp-`
+**Checkpoints:** Git tags with prefix `vp-`
 - `vp-p{N}-t{M}` - Start of task M in phase N
 - `vp-p{N}-t{M}-done` - Task M complete
 - `vp-p{N}-complete` - Phase N complete

package/skills/vp-status/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vp-status
-description: "Hiển thị progress dashboard và actionable insights"
+description: "Display progress dashboard and actionable insights"
 version: 0.1.1
 ---
 
@@ -22,12 +22,12 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 <implementation_routing_guard>
 ## Implementation routing guard (ENH-021)
 
-- **Read-only / dashboard** — không implement shipping; **`/vp-evolve`** → **`/vp-auto`**. Xem `workflows/request.md`.
+- **Read-only / dashboard** — does not implement shipping; **`/vp-evolve`** → **`/vp-auto`**. See `workflows/request.md`.
 </implementation_routing_guard>
 
 
 <objective>
-Hiển thị visual progress dashboard với actionable insights.
+Display a visual progress dashboard with actionable insights.
 
 **Reads:**
 - `.viepilot/TRACKER.md`
@@ -35,7 +35,7 @@ Hiển thị visual progress dashboard với actionable insights.
 - `.viepilot/phases/*/PHASE-STATE.md`
 - `CHANGELOG.md`
 
-**Output:** Dashboard display với next action suggestions.
+**Output:** Dashboard display with next action suggestions.
 </objective>
 
 <process>

package/skills/vp-task/SKILL.md

@@ -22,12 +22,12 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 <implementation_routing_guard>
 ## Implementation routing guard (ENH-021)
 
-- Skill này **chỉ** quản lý **state/tag/task** trong `.viepilot/` — **không** thay **`/vp-auto`** để implement shipping code. Implement: **`/vp-auto`** hoặc user **explicit** override. Chuỗi plan: **`/vp-evolve`** trước. Xem `workflows/request.md`.
+- This skill **only** manages **state/tag/task** in `.viepilot/` — does **not** replace **`/vp-auto`** for implementing shipping code. To implement: use **`/vp-auto`** or user **explicit** override. Plan chain: **`/vp-evolve`** first. See `workflows/request.md`.
 </implementation_routing_guard>
 
 
 <objective>
-Manual control over tasks khi cần fine-grained management.
+Manual control over tasks when fine-grained management is needed.
 
 **Commands:**
 - `list` - List tasks in current phase
@@ -50,7 +50,7 @@ Commands:
 - /vp-task show 3
 - /vp-task start 3
 - /vp-task done 3
-- /vp-task skip 3 --reason "Not needed for MVP"
+- /vp-task skip 3 --reason "Not needed for Phase 1"
 - /vp-task retry 3
 - /vp-task rollback 3
 ```

package/skills/vp-ui-components/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vp-ui-components
-description: "Quản lý workflow sưu tầm và tái sử dụng UI components"
+description: "Manage workflow for collecting and reusing UI components"
 version: 0.1.1
 ---
 
@@ -10,7 +10,7 @@ version: 0.1.1
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
 
 ## B. User Prompting
-Prompt user conversationally với numbered list options.
+Prompt user conversationally with numbered list options.
 
 ## C. Tool Usage
 Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
@@ -25,23 +25,23 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 <implementation_routing_guard>
 ## Implementation routing guard (ENH-021)
 
-- **Curation** `ui-components/` + metadata — không implement toàn bộ feature app / framework shipping mặc định; thay đổi lớn **`/vp-evolve`** → **`/vp-auto`**. Xem `workflows/request.md`.
+- **Curation** `ui-components/` + metadata — does not implement full app feature / default framework shipping; large changes go through **`/vp-evolve`** → **`/vp-auto`**. See `workflows/request.md`.
 </implementation_routing_guard>
 
 
 <objective>
-Thu thập, phân loại, và lưu trữ UI components để tái sử dụng:
+Collect, classify, and store UI components for reuse:
 - Global library: `~/.viepilot/ui-components/`
 - Project library: `.viepilot/ui-components/`
 
-Nguồn có thể đến từ prompt/link/snippet (đặc biệt 21st.dev), sau đó chuẩn hóa thành artifacts có metadata.
+Sources can come from prompt/link/snippet (especially 21st.dev), then normalized into artifacts with metadata.
 
 **Creates/Updates:**
 - `~/.viepilot/ui-components/{category}/{component-id}/...`
 - `.viepilot/ui-components/{category}/{component-id}/...`
-- `INDEX.md` cho global + local store
+- `INDEX.md` for global + local store
 
-**After:** Component có thể dùng lại cho `/vp-brainstorm --ui` và `/vp-crystallize`.
+**After:** Component is reusable for `/vp-brainstorm --ui` and `/vp-crystallize`.
 </objective>
 
 <execution_context>
@@ -50,11 +50,11 @@ Nguồn có thể đến từ prompt/link/snippet (đặc biệt 21st.dev), sau
 
 <context>
 Optional flags:
-- `--add` : Add/capture component mới
-- `--list` : Liệt kê component theo category
-- `--sync` : Đồng bộ global ↔ local index
-- `--from-21st` : Ưu tiên flow ingest từ 21st.dev references
-- `--approve` : Mark component status thành approved
+- `--add` : Add/capture new component
+- `--list` : List components by category
+- `--sync` : Sync global ↔ local index
+- `--from-21st` : Prioritize ingest flow from 21st.dev references
+- `--approve` : Mark component status as approved
 </context>
 
 <process>

package/skills/vp-update/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vp-update
-description: "Nâng cấp package viepilot qua npm (dry-run, --yes, --global) qua vp-tools"
+description: "Upgrade viepilot package via npm (dry-run, --yes, --global) via vp-tools"
 version: 0.1.1
 ---
 
@@ -22,18 +22,18 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 <implementation_routing_guard>
 ## Implementation routing guard (ENH-021)
 
-- **Nâng cấp ViePilot package** (npm) — không implement feature product trong repo đang làm việc mặc định; feature code qua **`/vp-auto`**. Xem `workflows/request.md`.
+- **Upgrade ViePilot package** (npm) — does not implement product features in the working repo by default; feature code goes through **`/vp-auto`**. See `workflows/request.md`.
 </implementation_routing_guard>
 
 
 <objective>
-Chạy **`vp-tools update`** để lên kế hoạch và (khi được xác nhận) thực thi `npm` nâng cấp `viepilot`.
+Run **`vp-tools update`** to plan and (when confirmed) execute the `npm` upgrade of `viepilot`.
 
-**Ràng buộc an toàn:**
-- **Non-interactive** (CI, agent không TTY): bắt buộc **`--dry-run`** hoặc **`--yes`**; nếu không sẽ exit lỗi.
-- Luôn ưu tiên **`--dry-run`** trước khi apply, trừ khi user đã yêu cầu rõ apply.
+**Safety constraints:**
+- **Non-interactive** (CI, agent without TTY): **`--dry-run`** or **`--yes`** is required; otherwise exits with an error.
+- Always prefer **`--dry-run`** before applying, unless the user has explicitly requested to apply.
 
-**Phân biệt target:** trong repo **không phải** ViePilot nhưng có `node_modules/viepilot`, lệnh có thể cập nhật **local dependency**. Muốn chỉ nâng **global**, thêm **`--global`**.
+**Target distinction:** in a repo that is **not** ViePilot but has `node_modules/viepilot`, the command may update the **local dependency**. To upgrade only the **global** install, add **`--global`**.
 </objective>
 
 <execution_context>
@@ -42,31 +42,31 @@ Chạy **`vp-tools update`** để lên kế hoạch và (khi được xác nh
 
 <process>
 
-### Step 1: Dry run (mặc định khi tự động)
+### Step 1: Dry run (default when automated)
 ```bash
 vp-tools update --dry-run
 ```
-Đọc output: planned npm command, phiên bản hiện tại vs latest, cảnh báo ambiguous/global.
+Read output: planned npm command, current version vs latest, ambiguous/global warnings.
 
-### Step 2: Apply (sau khi user đồng ý hoặc đã yêu cầu rõ)
+### Step 2: Apply (after user confirms or explicitly requests it)
 ```bash
 vp-tools update --yes
 ```
-Hoặc ép global:
+Or force global:
 ```bash
 vp-tools update --global --dry-run
 vp-tools update --global --yes
 ```
 
 ### Step 3: Interactive
-Nếu terminal tương tác và **không** có `--yes`, CLI có thể hỏi xác nhận trước khi chạy npm.
+If the terminal is interactive and **no** `--yes` flag is present, the CLI may prompt for confirmation before running npm.
 
-### Step 4: Rollback gợi ý
-Output dry-run/update thường gợi ý `npm install -g viepilot@<previous>` — giữ phiên bản cũ từ `vp-tools info` nếu cần hoàn tác.
+### Step 4: Suggested rollback
+Dry-run/update output typically suggests `npm install -g viepilot@<previous>` — keep the previous version from `vp-tools info` in case a rollback is needed.
 </process>
 
 <success_criteria>
-- [ ] Không chạy apply trong non-interactive mà thiếu `--yes`
-- [ ] Nêu rõ target (local vs global) khi user đang ở project lạ
-- [ ] Ghi nhận khi đã `already up to date` (no-op thành công)
+- [ ] Do not run apply in non-interactive mode without `--yes`
+- [ ] Clearly state target (local vs global) when user is in an external project
+- [ ] Acknowledge when `already up to date` (successful no-op)
 </success_criteria>

package/templates/architect/apis.html

@@ -0,0 +1,159 @@
+<!DOCTYPE html>
+<html lang="vi">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>APIs — {project}</title>
+  <link rel="stylesheet" href="style.css" />
+</head>
+<body data-arch-slug="apis">
+  <nav class="nav-sidebar">
+    <div class="logo">
+      <span>ViePilot Architect Mode</span>
+      <strong>{project}</strong>
+    </div>
+    <ul>
+      <li><a href="index.html">🏠 Hub</a></li>
+      <li><a href="architecture.html">🏗️ Architecture</a></li>
+      <li><a href="sequence-diagram.html">🎬 Sequence</a></li>
+      <li><a href="data-flow.html">🔄 Data Flow</a></li>
+      <li><a href="decisions.html">📋 Decisions (ADR)</a></li>
+      <li><a href="tech-stack.html">🛠️ Tech Stack</a></li>
+      <li><a href="tech-notes.html">📝 Tech Notes</a></li>
+      <li><a href="feature-map.html">🗺️ Feature Map</a></li>
+      <li><a href="erd.html">🗄️ ERD</a></li>
+      <li><a href="user-use-cases.html">👤 Use Cases</a></li>
+      <li><a href="deployment.html">🚀 Deployment</a></li>
+      <li><a href="apis.html" class="active">🔌 APIs</a></li>
+    </ul>
+  </nav>
+
+  <main class="main-content">
+    <div class="page-header">
+      <div>
+        <h1>🔌 APIs</h1>
+        <p>Service API listing and design decisions</p>
+      </div>
+      <button id="theme-toggle" onclick="toggleTheme()">☀️ Light</button>
+    </div>
+
+    <div class="card">
+      <h2>{Service 1} API</h2>
+      <table>
+        <thead>
+          <tr>
+            <th>Method</th>
+            <th>Path</th>
+            <th>Auth?</th>
+            <th>Request Body</th>
+            <th>Response</th>
+            <th>Status codes</th>
+            <th>Notes</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr data-arch-id="A1">
+            <td><span class="badge method-get">GET</span></td>
+            <td>/api/resource</td>
+            <td>Yes</td>
+            <td>—</td>
+            <td>{ data: [...] }</td>
+            <td>200, 401, 500</td>
+            <td>{Notes}</td>
+          </tr>
+          <tr data-arch-id="A2">
+            <td><span class="badge method-post">POST</span></td>
+            <td>/api/resource</td>
+            <td>Yes</td>
+            <td>{ name, ... }</td>
+            <td>{ id, name, ... }</td>
+            <td>201, 400, 401</td>
+            <td>{Notes}</td>
+          </tr>
+          <tr data-arch-id="A3">
+            <td><span class="badge method-put">PUT</span></td>
+            <td>/api/resource/:id</td>
+            <td>Yes</td>
+            <td>{ name, ... }</td>
+            <td>{ id, name, ... }</td>
+            <td>200, 400, 404</td>
+            <td>{Notes}</td>
+          </tr>
+          <tr data-arch-id="A4">
+            <td><span class="badge method-delete">DELETE</span></td>
+            <td>/api/resource/:id</td>
+            <td>Yes</td>
+            <td>—</td>
+            <td>{ success: true }</td>
+            <td>200, 404</td>
+            <td>{Notes}</td>
+          </tr>
+          <tr data-arch-id="A5">
+            <td><span class="badge method-patch">PATCH</span></td>
+            <td>/api/resource/:id</td>
+            <td>Yes</td>
+            <td>{ field: value }</td>
+            <td>{ id, field, ... }</td>
+            <td>200, 400, 404</td>
+            <td>{Notes}</td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+
+    <div class="card">
+      <h2>API Design Decisions</h2>
+      <table>
+        <thead>
+          <tr>
+            <th>Decision</th>
+            <th>Choice</th>
+            <th>Rationale</th>
+            <th>Notes</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr data-arch-id="A6">
+            <td>API Style</td>
+            <td>
+              <span class="badge method-get">REST</span>
+              <span class="badge" style="background:#8b5cf620;color:#c4b5fd;">GraphQL</span>
+              <span class="badge" style="background:#0ea5e920;color:#38bdf8;">gRPC</span>
+              <span class="badge" style="background:#f59e0b20;color:#fbbf24;">WebSocket</span>
+            </td>
+            <td>{Rationale}</td>
+            <td>{Notes}</td>
+          </tr>
+          <tr data-arch-id="A7">
+            <td>Authentication</td>
+            <td>{JWT / Session / OAuth2 / API Key}</td>
+            <td>{Rationale}</td>
+            <td>{Notes}</td>
+          </tr>
+          <tr data-arch-id="A8">
+            <td>Versioning</td>
+            <td>{URL path / Header / None}</td>
+            <td>{Rationale}</td>
+            <td>{Notes}</td>
+          </tr>
+          <tr data-arch-id="A9">
+            <td>Rate limiting</td>
+            <td>{Strategy}</td>
+            <td>{Rationale}</td>
+            <td>{Notes}</td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+  </main>
+
+  <script>
+    function toggleTheme() {
+      const html = document.documentElement;
+      const isLight = html.classList.toggle('light');
+      document.getElementById('theme-toggle').textContent = isLight ? '🌙 Dark' : '☀️ Light';
+    }
+  </script>
+    <script src="architect-actions.js"></script>
+</body>
+</html>