viepilot 1.9.9 → 1.9.11

package/CHANGELOG.md

@@ -11,6 +11,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - None.
 
+## [1.9.11] - 2026-04-02
+
+### Fixed
+
+- **BUG-007**: `vp-tools info` crash "Could not locate viepilot package root" khi CWD không phải viepilot source repo. Fix: `buildInstallPlan()` claude-code block nay copy `package.json` → `~/.claude/viepilot/package.json`, cho phép `resolveViepilotPackageRoot()` tìm thấy root ngay cả khi install từ `~/.claude/viepilot/`. (+2 tests, 319 total pass)
+
+## [1.9.10] - 2026-04-02
+
+### Fixed
+
+- **BUG-006**: Tất cả install targets (`cursor-ide`, `cursor-agent`, `claude-code`) thiếu 3 lib files trong `buildInstallPlan()`. Fix: cả 2 blocks (cursor `viepilotDir` và claude-code `claudeViepilotDir`) nay copy đủ 4 files: `cli-shared.cjs`, `viepilot-info.cjs`, `viepilot-update.cjs`, `viepilot-install.cjs`. Ngăn crash khi chạy `vp-tools info` / `vp-tools update` trên môi trường đã install. (+3 tests, 317 total pass)
+
 ### Added
 
 - None yet.

package/docs/brainstorm/session-2026-04-02.md

@@ -0,0 +1,145 @@
+# Brainstorm Session: Multi-Agent Support Expansion
+
+**Date:** 2026-04-02  
+**Status:** In Progress  
+**Topic:** Mở rộng hỗ trợ các coding agent ngoài Codex
+
+---
+
+## Objective
+
+Nghiên cứu và lên kế hoạch để ViePilot hỗ trợ thêm các coding agent phổ biến ngoài OpenAI Codex hiện tại.
+
+---
+
+## Research: Coding Agents Landscape 2025-2026
+
+### Tier 1 — CLI-native / Có thể tích hợp trực tiếp
+
+| Agent | Maker | CLI | API/SDK | ACP | MCP | Notes |
+|-------|-------|-----|---------|-----|-----|-------|
+| **Codex CLI** | OpenAI | ✓ | ✓ | ✓ | ✓ | Đang hỗ trợ |
+| **Claude Code** | Anthropic | ✓ | ✓ | ✓ | ✓ | CLI `claude`, SDK @anthropic-ai/claude-agent-sdk |
+| **Aider** | OSS | ✓ | ✓ | ✗ | ✓ | CLI `aider`, Python-based, Git-native |
+| **Goose** | Block/LF | ✓ | ✓ | ✓ | ✓ | CLI + desktop, 25+ LLM providers |
+| **OpenCode** | OSS | ✓ | ✓ | ✓ | ✓ | 75+ models, terminal-native |
+| **Kimi Code** | Moonshot AI | ✓ | ✓ | ✓ | ✓ | 1T param MoE, 256K context |
+| **GitHub Copilot CLI** | GitHub/MS | ✓ | ✓ | Planned | ✓ | `gh copilot` command |
+
+### Tier 2 — IDE-primary (CLI hạn chế)
+
+| Agent | Maker | CLI | Notes |
+|-------|-------|-----|-------|
+| **Cursor** | Cursor | ✗ | IDE-only, không có CLI programmatic |
+| **Windsurf** | Cognition | ✗ | IDE-only |
+| **Continue.dev** | OSS | ✗ | VS Code / JetBrains extension |
+| **Cline** | OSS | ✗ | VS Code extension, MCP support |
+| **Gemini Code Assist** | Google | Limited | IDE plugin chính |
+| **Amazon Q Dev** | AWS | Limited | IDE plugin, `q` CLI |
+| **Devin** | Cognition | Limited | Web app + API |
+
+### Tier 3 — Web-only / Specialized
+
+- **v0 by Vercel** — full-stack web generation
+- **Bolt.new** — in-browser WebContainers
+- **Tabnine** — IDE plugin + Jira integration
+- **Cody (Sourcegraph)** — multi-repo search agent
+
+---
+
+## Integration Protocols
+
+### Model Context Protocol (MCP)
+- Chuẩn hóa cách agent truy cập tools bên ngoài
+- Adopted by: OpenAI, Google, Microsoft, Anthropic
+- Rủi ro security: prompt injection (April 2025 report)
+
+### Agent Client Protocol (ACP)
+- JSON RPC over stdio — standardized editor ↔ agent communication
+- Created by: JetBrains & Zed (Aug 2025)
+- Supported agents: Claude Code, Codex CLI, Gemini, Goose
+- Supported editors: Zed, Neovim, Marimo
+
+---
+
+## Open Questions
+
+1. ViePilot hiện tại hỗ trợ Codex theo cơ chế nào? (CLI wrapper, API, hay file convention?)
+2. Agent nào nên ưu tiên hỗ trợ trước? (Claude Code, Aider, hay GitHub Copilot?)
+3. Mô hình integration: ViePilot gọi agent như thế nào — cùng CLI pattern hay adapter layer?
+4. Có cần abstraction layer (agent-agnostic interface) không?
+5. Phạm vi support: code generation only, hay cả agentic execution (file edit, terminal)?
+
+---
+
+## Product Horizon
+
+### MVP
+- Hỗ trợ **Claude Code** (Anthropic CLI) — CLI pattern tương tự Codex (MVP)
+- Hỗ trợ **Aider** — CLI-native, OSS, Git-native (MVP)
+- Abstraction: config-based agent selection (MVP)
+
+### Post-MVP
+- Hỗ trợ **GitHub Copilot CLI** — `gh copilot` (Post-MVP)
+- Hỗ trợ **Goose** (Block) — MCP-compatible (Post-MVP)
+- Hỗ trợ **OpenCode** (Post-MVP)
+
+### Future
+- ACP-based integration cho IDE agents (Future)
+- MCP server để expose ViePilot tools sang các agent (Future)
+- Agent routing: tự động chọn agent phù hợp theo task type (Future)
+
+### Non-goals (MVP)
+- Không hỗ trợ IDE-only agents (Cursor, Windsurf) ở MVP
+- Không hỗ trợ web-only agents (v0, Bolt.new)
+- Không build MCP server ở MVP
+
+---
+
+## Research Notes
+
+### Candidates Được Đề Xuất Theo Priority
+
+**Priority 1: Claude Code**
+- `claude` CLI — tương tự pattern của `codex`
+- SDK: `@anthropic-ai/claude-agent-sdk`
+- Supports: file editing, terminal, MCP, remote sessions
+- Pricing: subscription (user đã có nếu dùng Claude Code)
+
+**Priority 2: Aider**
+- `aider` CLI — Python, OSS, Apache 2.0
+- Git-native: tự commit sau mỗi change
+- Multi-LLM: Claude, OpenAI, local models
+- Strong community: 100K+ GitHub stars
+
+**Priority 3: GitHub Copilot CLI**
+- `gh copilot` — requires GitHub Copilot subscription
+- GA: Feb 2026
+- Custom agents support
+- MCP integration
+
+**Key Insight:** Tất cả Tier 1 agents đều có CLI interface và hỗ trợ MCP — ViePilot có thể build một adapter layer chung dựa trên:
+1. CLI command pattern
+2. Config file location
+3. Prompt/task passing convention
+
+---
+
+## Action Items
+
+- [ ] Xem lại cơ chế hiện tại ViePilot gọi Codex (source code)
+- [ ] Quyết định: adapter pattern hay agent-specific skills
+- [ ] Prototype integration với Claude Code trước (priority 1)
+- [ ] Tạo `docs/dev/agents.md` — agent support matrix
+
+---
+
+## Session Notes
+
+Research conducted 2026-04-02. Landscape nhanh thay đổi — re-verify agent CLI APIs trước khi implement.
+
+---
+
+## Project meta intake (FEAT-009)
+
+_Chưa hoàn tất — cần binding profile trước khi close session._

package/lib/viepilot-install.cjs

@@ -187,11 +187,12 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
       for (const f of ['vp-tools.cjs', 'viepilot.cjs']) {
         steps.push({ kind: 'copy_file', from: path.join(root, 'bin', f), to: path.join(claudeViepilotDir, 'bin', f) });
       }
-      steps.push({
-        kind: 'copy_file',
-        from: path.join(root, 'lib', 'cli-shared.cjs'),
-        to: path.join(claudeViepilotDir, 'lib', 'cli-shared.cjs'),
-      });
+      for (const f of ['cli-shared.cjs', 'viepilot-info.cjs', 'viepilot-update.cjs', 'viepilot-install.cjs']) {
+        steps.push({ kind: 'copy_file', from: path.join(root, 'lib', f), to: path.join(claudeViepilotDir, 'lib', f) });
+      }
+      // BUG-007: copy package.json so resolveViepilotPackageRoot() finds the root
+      // when vp-tools runs from ~/.claude/viepilot/ (CWD ≠ viepilot source repo)
+      steps.push({ kind: 'copy_file', from: path.join(root, 'package.json'), to: path.join(claudeViepilotDir, 'package.json') });
 
       // Rewrite execution_context paths in mirrored skill files
       steps.push({
@@ -255,11 +256,9 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
       to: path.join(viepilotDir, 'bin', f),
     });
   }
-  steps.push({
-    kind: 'copy_file',
-    from: path.join(root, 'lib', 'cli-shared.cjs'),
-    to: path.join(viepilotDir, 'lib', 'cli-shared.cjs'),
-  });
+  for (const f of ['cli-shared.cjs', 'viepilot-info.cjs', 'viepilot-update.cjs', 'viepilot-install.cjs']) {
+    steps.push({ kind: 'copy_file', from: path.join(root, 'lib', f), to: path.join(viepilotDir, 'lib', f) });
+  }
 
   for (const f of binFiles) {
     steps.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "1.9.9",
+  "version": "1.9.11",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {