viepilot 2.1.0 → 2.4.0

package/CHANGELOG.md

@@ -7,6 +7,99 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.4.0] - 2026-04-10
+
+### Added (FEAT-015 — Phase 62)
+- **Codex adapter**: `lib/adapters/codex.cjs` — OpenAI Codex CLI is now a first-class install target; skills install to `~/.codex/skills/`, viepilot bundle to `~/.codex/viepilot/`
+- `lib/adapters/index.cjs`: `codex` registered; `listAdapters()` now returns 4 unique adapters
+- `bin/viepilot.cjs`: Codex added to interactive installer TARGETS list and help text
+- `docs/user/features/adapters.md`: Codex row added; `$skill-name` invocation note; removed stale `dev-install.sh` reference
+
+### Notes
+- Codex uses `$vp-status` syntax (not `/vp-status`) — SKILL.md format is fully compatible, invocation prefix differs
+
+### Tests
+- Added `tests/unit/vp-adapter-codex.test.js` (11 tests)
+- Updated `tests/unit/vp-adapter-antigravity.test.js`: `listAdapters()` now expects 4
+- Updated `tests/unit/viepilot-adapters.test.js`: count 3 → 4
+- Updated `tests/unit/guided-installer.test.js`: `normalizeTargets('all')` includes codex
+- Total: 607 tests (was 596)
+
+## [2.3.2] - 2026-04-10
+
+### Changed (ENH-037 — Phase 61)
+- Post-install "Next actions" block is now adapter-driven: each adapter carries a `postInstallHint` string; CLI prints one hint per unique installed target — Antigravity now appears when installed
+- `lib/adapters/claude-code.cjs`, `cursor.cjs`, `antigravity.cjs`: added `postInstallHint` field
+
+## [2.3.1] - 2026-04-10
+
+### Removed (ENH-036 — Phase 60)
+- `install.sh` — bash wrapper was redundant; `bin/viepilot.cjs install` covers all install functionality
+- `dev-install.sh` — bash adapter routing duplicated `lib/adapters/`; `bin/viepilot.cjs install --target <adapter>` is the canonical path
+- Removed 5 tests that only verified shell script content (viepilot-install.test.js, viepilot-adapters.test.js, vp-adapter-antigravity.test.js)
+
+## [2.3.0] - 2026-04-10
+
+### Added (FEAT-014 — Phase 59)
+- **Antigravity adapter**: `lib/adapters/antigravity.cjs` — Google Antigravity IDE is now a first-class install target; skills install to `~/.antigravity/skills/`, viepilot bundle to `~/.antigravity/viepilot/`
+- `lib/adapters/index.cjs`: `antigravity` registered; `listAdapters()` now returns 3 unique adapters
+- `dev-install.sh`: `VIEPILOT_ADAPTER=antigravity` supported
+- `bin/viepilot.cjs`: Antigravity added to interactive installer TARGETS list and help text
+- `docs/user/features/adapters.md`: new doc — supported platforms table, install examples, guide for adding new adapters
+
+### Tests
+- Added `tests/unit/vp-adapter-antigravity.test.js` (12 tests)
+- Updated `tests/unit/viepilot-adapters.test.js`: `listAdapters()` now expects 3
+- Updated `tests/unit/guided-installer.test.js`: `normalizeTargets('all')` includes antigravity
+- Total: 600 tests (was 588)
+
+## [2.2.0] - 2026-04-10
+
+### Changed (ENH-035 — Phase 58)
+- **{envToolDir} template variable**: all 14 `skills/*/SKILL.md` source files now use `$HOME/{envToolDir}/` instead of hardcoded `$HOME/.cursor/viepilot/` — skill sources are platform-neutral
+- **`lib/viepilot-install.cjs`**: path substitution now unconditionally replaces `{envToolDir}` → `adapter.executionContextBase` for every adapter (Cursor → `.cursor/viepilot`, Claude Code → `.claude/viepilot`, future adapters just set `executionContextBase`)
+- **`lib/adapters/claude-code.cjs`**: removed `pathRewrite` field — no longer needed
+- **`lib/adapters/cursor.cjs`**: removed `pathRewrite: null` field — no longer needed
+- Adding a new adapter now requires only `executionContextBase` — no `pathRewrite` definition
+
+### Tests
+- Updated `tests/unit/viepilot-adapters.test.js`: removed `pathRewrite` assertion; rewrite step tests now check `from: '{envToolDir}'`; added cursor-target substitution test
+- Updated `tests/unit/viepilot-install.test.js`: 2 tests updated for ENH-035 behavior
+- Total: 588 tests (was 587)
+
+## [2.1.3] - 2026-04-10
+
+### Fixed (BUG-011 — Phase 55)
+- **brainstorm.md dialogue path**: confirmation option 1 now shows `.viepilot/ui-direction/{session-id}/notes.md` instead of bare `ui-direction/notes.md` — eliminates ambiguity with user-managed `{root}/ui-direction/` folders
+- **crystallize.md PATH GUARD**: `consume_ui_direction` step now opens with `⛔ PATH GUARD (BUG-011)` — explicitly instructs LLM to ignore any `{root}/ui-direction/` folder and read only from `.viepilot/ui-direction/`
+
+### Tests
+- Added `tests/unit/vp-bug011-ui-direction-path-guard.test.js` (3 tests)
+- Total: 587 tests (was 584)
+
+## [2.1.2] - 2026-04-10
+
+### Fixed (BUG-013 — Phase 57)
+- **Untrack .viepilot/ from git**: `git rm -r --cached .viepilot/` — removes all 27 previously-tracked internal state files from the git index; `.viepilot/` now correctly treated as gitignored on disk only, never staged or pushed
+- **GITIGNORE-AWARE STAGING RULE**: `workflows/autonomous.md` commit block now has `⛔ GITIGNORE-AWARE STAGING RULE (BUG-013)` — instructs vp-auto to check `git check-ignore -q` before staging, and explicitly forbids `git add .viepilot/`
+- **Git persistence gate note**: porcelain check section clarified — `??` (untracked-only) lines are CLEAN, not dirty state; prevents false gate failures after BUG-013 fix
+
+### Tests
+- Added `tests/unit/vp-bug013-gitignore-staging-rule.test.js` (3 tests)
+- Total: 584 tests (was 581)
+- **ui-direction path disambiguation**: `workflows/brainstorm.md` confirmation dialogue option 1 now shows full unambiguous path `.viepilot/ui-direction/{session-id}/notes.md` (was bare `ui-direction/notes.md`)
+- **crystallize PATH GUARD**: `workflows/crystallize.md` `consume_ui_direction` step now opens with `⛔ PATH GUARD (BUG-011)` — explicitly instructs LLM to ignore any `{root}/ui-direction/` folder and read only from `.viepilot/ui-direction/`
+
+## [2.1.1] - 2026-04-10
+
+### Fixed (BUG-012 — Phase 56)
+- **PATH RESOLUTION RULE**: `workflows/autonomous.md` now has `⛔ PATH RESOLUTION RULE (BUG-012)` block — explicitly states all file reads/edits during task execution resolve from `{cwd}` (repo root), never from `~/.claude/` or `~/.cursor/` install directories
+- **evolve.md cwd note**: `workflows/evolve.md` TASK PATH RULE section now includes BUG-012 cwd-resolution clarification: repo-relative paths always anchor to `{cwd}`, not install paths
+
+### Tests
+- Added `tests/unit/vp-bug012-path-resolution-rule.test.js` (3 tests)
+- Total: 581 tests (was 578)
+
 ## [2.1.0] - 2026-04-08
 
 ### Added (FEAT-012 — Phase 54)

package/README.md

@@ -2,15 +2,15 @@
 
 **Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**
 
-[![Version](https://img.shields.io/badge/version-1.16.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.4.0-blue.svg)](CHANGELOG.md)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![Skills](https://img.shields.io/badge/skills-16-purple.svg)](#skills-reference)
 [![Workflows](https://img.shields.io/badge/workflows-12-orange.svg)](#workflows)
 [![Templates](https://img.shields.io/badge/templates-17-cyan.svg)](#templates)
-[![Tests](https://img.shields.io/badge/tests-448%20passing-brightgreen.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-607%20passing-brightgreen.svg)](tests/)
 [![GitHub](https://img.shields.io/github/stars/0-CODE/viepilot?style=social)](https://github.com/0-CODE/viepilot)
 
-**Versioning:** Shield **1.9.5** is the **ViePilot framework SemVer** tracked in `.viepilot/TRACKER.md` and `CHANGELOG.md`. The npm `package.json` field `version` (**1.9.5**) is the Node package identifier for this repo; use the framework version for milestone releases and docs.
+**Versioning:** Shield **2.4.0** is the **ViePilot framework SemVer** tracked in `.viepilot/TRACKER.md` and `CHANGELOG.md`. The npm `package.json` field `version` (**2.4.0**) is the Node package identifier for this repo; use the framework version for milestone releases and docs.
 
 ViePilot là bộ skill framework cho phép AI assistant (Claude, GPT, etc.) phát triển dự án một cách **tự động**, **có kiểm soát**, và **có thể khôi phục**. Thiết kế theo các tiêu chuẩn chuyên nghiệp: Semantic Versioning, Conventional Commits, Keep a Changelog.
 
@@ -28,13 +28,13 @@ Nếu ViePilot giúp ích cho bạn, bạn có thể ủng hộ một ly cafe:
 
 | Chỉ số / Metric | Giá trị / Value |
 |-----------------|-----------------|
-| Total LOC | **~34,308+** (`.md`, `.js`, `.cjs`, `.yml`, `.json`, `.sh`; không gồm `node_modules`) |
+| Total LOC | **~39,668+** (`.md`, `.js`, `.cjs`, `.yml`, `.json`, `.sh`; không gồm `node_modules`) |
 | Skills | **16** |
 | Workflows | **12** |
 | Templates | **17** (Project: 12, Phase: 5) |
 | CLI Commands | **18** (`vp-tools` 17 subcommands + `viepilot` installer) |
-| Tests | **308** (16 suites: unit + integration + AI compat + README metrics + UI direction + ENH contracts + scope policy + FEAT-009 + FEAT-010 + ENH-021 routing + FEAT-001 Claude Code + ENH-022 crystallize architecture files + viepilot-info/update/install) |
-| ViePilot phases (local `.viepilot`) | **34** phase cycles — **M1.29** FEAT-001 (**v1.9.3** doc); patch **v1.9.4** (Claude installer); **M1.28** FEAT-010 (**v1.9.1**); **v1.9.2** (ENH-019~021); **M1.27** (**v1.9.0** FEAT-009); xem `CHANGELOG.md` |
+| Tests | **607** (34 suites: unit + integration + AI compat + README metrics + UI direction + ENH contracts + scope policy + FEAT-009/010/011/012/013/015 + ENH-021~037 routing/language/architect/adapter + BUG-009~013 guards + viepilot-info/update/install/adapters) |
+| ViePilot phases (local `.viepilot`) | **62** phase cycles — **v2.4.0** FEAT-015 Codex adapter; **v2.3.x** ENH-036~037 installer cleanup; **v2.0.0** FEAT-013 dynamic adapters; **v1.x** M1.29 (FEAT-001~013); xem `CHANGELOG.md` |
 | Standards | 5 (SemVer, Commits, Changelog, Comments, Contributors) |
 
 > Metric `Total LOC` có thể được refresh tự động bằng `npm run readme:sync` (dùng `cloc`; nếu thiếu `cloc` script sẽ fallback an toàn).
@@ -48,14 +48,14 @@ Nếu ViePilot giúp ích cho bạn, bạn có thể ủng hộ một ly cafe:
 | Project Templates | 12 | AI-GUIDE, ARCHITECTURE, VIEPILOT-META, README, SYSTEM-RULES, etc. |
 | Phase Templates | 5 | SPEC, PHASE-STATE, TASK, VERIFICATION, SUMMARY |
 | CLI Tools | 2 | vp-tools.cjs (**17** subcommands) + viepilot.cjs (guided installer) |
-| Test Files | 15 | Jest: 14 unit + 1 integration (contracts, installer + Claude paths, info/update, FEAT-009, FEAT-010, FEAT-001, ENH-021, scope policy, …) |
+| Test Files | 34 | Jest: 33 unit + 1 integration (contracts, installer + Claude paths, info/update, FEAT-009/010/011~015, ENH-021~037, BUG-009~013 guards, adapter tests, scope policy, …) |
 
 ---
 
 ## Độ hoàn thiện / Completion Status
 
 ```
-Tổng thể / Overall:  ████████████████████  ~98% ✅ Latest **v1.9.4** (Claude Code **installer** ~/.claude/skills); **v1.9.3** FEAT-001 doc; **v1.9.2** (ENH-019~021); **v1.9.1** FEAT-010; **v1.9.0** FEAT-009
+Tổng thể / Overall:  ████████████████████  ~99% ✅ Latest **v2.4.0** FEAT-015 Codex adapter; **v2.3.x** ENH-036~037 installer cleanup; **v2.1.x** BUG-009~013; **v2.0.0** FEAT-013 dynamic adapters
 ```
 
 | Lĩnh vực / Area | Trạng thái | Chi tiết |
@@ -65,11 +65,11 @@ Tổng thể / Overall:  ██████████████████
 | Project Templates (12) | ✅ Hoàn thiện | Placeholders cho customization (+ `VIEPILOT-META` FEAT-009) |
 | Phase Templates (5) | ✅ Hoàn thiện | Task tracking, verification, summary |
 | CLI Tools (18) | ✅ Hoàn thiện | vp-tools 17 subcommands + viepilot installer; bundle `info` / `update` |
-| Tests (304) | ✅ Hoàn thiện | Unit, integration, AI compat, workflow contracts, installer, scope policy, FEAT-009/010/001, ENH-021, info/update |
+| Tests (607) | ✅ Hoàn thiện | Unit, integration, AI compat, workflow contracts, installer, scope policy, FEAT-009~015, ENH-021~037, BUG-009~013, adapter tests, info/update |
 | CI/CD | ✅ Hoàn thiện | GitHub Actions, Node 18/20/22 matrix, coverage >80% |
 | Documentation | ✅ Hoàn thiện | dev/, user/, api/, videos/, examples/, troubleshooting |
 | Standards | ✅ Hoàn thiện | SemVer, Conventional Commits, Keep a Changelog |
-| Installation | ✅ Hoàn thiện | install.sh + dev-install.sh |
+| Installation | ✅ Hoàn thiện | `bin/viepilot.cjs install` (Node-based, all adapters) |
 
 ---
 
@@ -205,10 +205,13 @@ Chọn target profile trong wizard (phím mũi tên + space + enter):
 - Claude Code
 - Cursor Agent
 - Cursor IDE
+- Antigravity
+- Codex
 
 Non-interactive:
 ```bash
 npx viepilot install --target cursor-agent --yes
+npx viepilot install --target codex --yes
 ```
 
 Gỡ cài đặt:
@@ -353,7 +356,7 @@ viepilot/
 │   ├── vp-rollback/               # Checkpoint recovery
 │   └── vp-audit/                  # Documentation sync
 │
-├── workflows/                     # 11 Workflow definitions
+├── workflows/                     # 12 Workflow definitions
 │   ├── brainstorm.md              # Brainstorm session flow
 │   ├── crystallize.md             # Artifact generation flow
 │   ├── autonomous.md              # Execution loop
@@ -388,17 +391,25 @@ viepilot/
 │       └── SUMMARY.md
 │
 ├── lib/                           # Shared CLI logic (coverage target for Jest)
-│   └── cli-shared.cjs             # Validators, project root, Levenshtein helpers
+│   ├── cli-shared.cjs             # Validators, project root, Levenshtein helpers
+│   └── adapters/                  # Dynamic adapter system (FEAT-013)
+│       ├── index.cjs              # Registry: listAdapters(), getAdapter()
+│       ├── claude-code.cjs        # Claude Code adapter (~/.claude/)
+│       ├── cursor.cjs             # Cursor adapter (~/.cursor/)
+│       ├── antigravity.cjs        # Antigravity adapter (~/.antigravity/)
+│       └── codex.cjs              # Codex CLI adapter (~/.codex/)
 │
 ├── bin/                           # CLI tools
 │   └── vp-tools.cjs               # 17 subcommands; uses ../lib/cli-shared.cjs, viepilot-info/update.cjs
 │
-├── tests/                         # Test suite (308 tests)
-│   ├── unit/                      # Unit tests
+├── tests/                         # Test suite (607 tests, 34 suites)
+│   ├── unit/                      # 33 unit test files
 │   │   ├── validators.test.js     # CLI subprocess + in-process coverage tests
-│   │   └── ai-provider-compat.test.js  # 142 AI compat tests
+│   │   ├── ai-provider-compat.test.js  # AI compat tests
+│   │   ├── viepilot-adapters.test.js   # Adapter registry tests
+│   │   └── vp-adapter-codex.test.js    # Codex adapter tests
 │   └── integration/               # Integration tests
-│       └── workflow.test.js       # 22 E2E tests
+│       └── workflow.test.js       # E2E tests
 │
 ├── .github/workflows/             # CI/CD
 │   └── ci.yml                     # Node 18/20/22 matrix
@@ -419,7 +430,6 @@ viepilot/
 │   ├── api-service/               # Express + JWT example
 │   └── cli-tool/                  # Node.js CLI example
 │
-├── install.sh                     # Installation script
 ├── Makefile                       # Developer commands
 ├── CHANGELOG.md                   # Version history
 ├── CONTRIBUTING.md                # Contribution guide

package/bin/viepilot.cjs

@@ -21,6 +21,8 @@ const TARGETS = [
   { id: 'claude-code',  label: adapterMap['claude-code'].name + ' (default)' },
   { id: 'cursor-agent', label: 'Cursor Agent' },
   { id: 'cursor-ide',   label: 'Cursor IDE' },
+  { id: 'antigravity',  label: adapterMap['antigravity'].name },
+  { id: 'codex',        label: adapterMap['codex'].name },
 ];
 
 function printHelp() {
@@ -34,14 +36,14 @@ Usage:
   viepilot --list-targets
 
 Install options:
-  --target <id|id,id|all>   Target profile(s): claude-code (mirrors vp-* to ~/.claude/skills), cursor-agent, cursor-ide
+  --target <id|id,id|all>   Target profile(s): claude-code (mirrors vp-* to ~/.claude/skills), cursor-agent, cursor-ide, antigravity, codex
   --yes                      Non-interactive mode (skip confirmations)
   --dry-run                  Print actions only (Node installer; no bash)
   --list-targets             Print supported targets and exit
   --help                     Show help
 
 Uninstall options:
-  --target <id|id,id|all>   Remove assets (claude-code: ~/.claude/skills/vp-*; cursor-*: ~/.cursor/skills/vp-*; shared: ~/.cursor/viepilot)
+  --target <id|id,id|all>   Remove assets (claude-code: ~/.claude/skills/vp-*; cursor-*: ~/.cursor/skills/vp-*; antigravity: ~/.antigravity/skills/vp-*; codex: ~/.codex/skills/vp-*)
   --yes                     Non-interactive mode (skip confirmations)
   --dry-run                 Print actions only, do not remove files
 `);
@@ -337,8 +339,14 @@ async function installCommand(rawArgs) {
     else console.log(`- ${r.target}: failed (exit ${r.code})`);
   }
   console.log('\nNext actions:');
-  console.log('- Cursor: open project and run /vp-status');
-  console.log('- Claude Code: restart session if needed so ~/.claude/skills/vp-* is picked up; then /vp-status');
+  const seenAdapters = new Set();
+  for (const target of selectedTargets) {
+    const a = adapterMap[target];
+    if (a && !seenAdapters.has(a.id)) {
+      seenAdapters.add(a.id);
+      console.log(`- ${a.name}: ${a.postInstallHint || 'run /vp-status'}`);
+    }
+  }
   console.log('- If needed, run /vp-brainstorm then /vp-crystallize');
 
   return failed.length === 0 ? 0 : 1;

package/docs/user/features/adapters.md

@@ -0,0 +1,74 @@
+# Supported Adapters
+
+ViePilot supports multiple AI coding platforms via its adapter system (FEAT-013). Each adapter defines where skills and workflows are installed on your machine.
+
+## Supported Platforms
+
+| Adapter ID | Platform | Skills dir | ViePilot dir | Hooks | Skill syntax |
+|------------|----------|------------|--------------|-------|--------------|
+| `claude-code` | Claude Code *(default)* | `~/.claude/skills/` | `~/.claude/viepilot/` | ✅ Stop, PreToolUse, … | `/vp-status` |
+| `cursor-agent` / `cursor-ide` | Cursor | `~/.cursor/skills/` | `~/.cursor/viepilot/` | — | `/vp-status` |
+| `antigravity` | Google Antigravity | `~/.antigravity/skills/` | `~/.antigravity/viepilot/` | — | `/vp-status` |
+| `codex` | OpenAI Codex CLI | `~/.codex/skills/` | `~/.codex/viepilot/` | — | `$vp-status` |
+
+> **Note — Codex invocation syntax:** OpenAI Codex CLI uses `$skill-name` to invoke skills (e.g. `$vp-status`, `$vp-brainstorm`). The `/command` prefix is reserved for Codex built-in controls (`/plan`, `/clear`, `/diff`, etc.). SKILL.md file format is fully compatible — no changes needed to skill content.
+
+## Install for a specific platform
+
+```bash
+# Claude Code (default)
+viepilot install
+
+# Cursor Agent
+viepilot install --target cursor-agent
+
+# Google Antigravity
+viepilot install --target antigravity
+
+# OpenAI Codex CLI
+viepilot install --target codex
+
+# Multiple targets at once
+viepilot install --target claude-code,antigravity
+```
+
+## How path resolution works (ENH-035)
+
+Skill source files use the neutral placeholder `{envToolDir}` in `execution_context` blocks:
+
+```
+@$HOME/{envToolDir}/workflows/autonomous.md
+```
+
+At install time, `{envToolDir}` is replaced with each adapter's `executionContextBase`:
+- `claude-code` → `.claude/viepilot`
+- `cursor` → `.cursor/viepilot`
+- `antigravity` → `.antigravity/viepilot`
+- `codex` → `.codex/viepilot`
+
+## Adding a new adapter
+
+Create `lib/adapters/{name}.cjs`:
+
+```js
+module.exports = {
+  id: 'myplatform',
+  name: 'My Platform',
+  skillsDir:   (home) => path.join(home, '.myplatform', 'skills'),
+  viepilotDir: (home) => path.join(home, '.myplatform', 'viepilot'),
+  executionContextBase: '.myplatform/viepilot',  // {envToolDir} resolves to this
+  postInstallHint: 'Open project and run /vp-status',  // or $vp-status if platform uses $ prefix
+  hooks: { configFile: null, schema: 'myplatform', supportedEvents: [] },
+  installSubdirs: ['workflows', 'templates/project', 'templates/phase',
+                   'templates/architect', 'bin', 'lib', 'ui-components'],
+  isAvailable: (home) => fs.existsSync(path.join(home, '.myplatform'))
+};
+```
+
+Register in `lib/adapters/index.cjs`:
+
+```js
+'myplatform': require('./myplatform.cjs'),
+```
+
+No `pathRewrite` field needed — `{envToolDir}` substitution is handled automatically.

package/lib/adapters/antigravity.cjs

@@ -0,0 +1,33 @@
+'use strict';
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  id: 'antigravity',
+  name: 'Antigravity',
+  skillsDir:   (home) => path.join(home, '.antigravity', 'skills'),
+  viepilotDir: (home) => path.join(home, '.antigravity', 'viepilot'),
+  // {envToolDir} in SKILL.md files resolves to this value at install time (ENH-035)
+  executionContextBase: '.antigravity/viepilot',
+  // Post-install hint shown in "Next actions" after viepilot install
+  postInstallHint: 'Open project and run /vp-status',
+  hooks: {
+    configFile: null,       // Antigravity has no programmatic hooks system
+    schema: 'antigravity',
+    supportedEvents: []
+  },
+  installSubdirs: [
+    'workflows',
+    path.join('templates', 'project'),
+    path.join('templates', 'phase'),
+    path.join('templates', 'architect'),
+    'bin',
+    'lib',
+    'ui-components'
+  ],
+  isAvailable: (home) => {
+    const h = home || os.homedir();
+    return fs.existsSync(path.join(h, '.antigravity'));
+  }
+};

package/lib/adapters/claude-code.cjs

@@ -11,8 +11,8 @@ module.exports = {
   viepilotDir: (home) => path.join(home, '.claude', 'viepilot'),
   // execution_context base for skill .md files
   executionContextBase: '.claude/viepilot',
-  // Path rewrite rule: when mirroring skills, rewrite from → to in *.md files
-  pathRewrite: { from: '.cursor/viepilot', to: '.claude/viepilot' },
+  // Post-install hint shown in "Next actions" after viepilot install
+  postInstallHint: 'Restart session so ~/.claude/skills/vp-* is picked up; then /vp-status',
   // Hooks configuration (Claude Code settings.json)
   hooks: {
     configFile: (home) => path.join(home, '.claude', 'settings.json'),

package/lib/adapters/codex.cjs

@@ -0,0 +1,34 @@
+'use strict';
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  id: 'codex',
+  name: 'Codex',
+  skillsDir:   (home) => path.join(home, '.codex', 'skills'),
+  viepilotDir: (home) => path.join(home, '.codex', 'viepilot'),
+  // {envToolDir} in SKILL.md files resolves to this value at install time (ENH-035)
+  executionContextBase: '.codex/viepilot',
+  // NOTE: Codex uses $skill-name syntax (not /skill-name like other adapters)
+  // Codex reserves /command for built-in system controls (/plan, /clear, /diff, etc.)
+  postInstallHint: 'Open project and type $vp-status to get started',
+  hooks: {
+    configFile: null,       // Codex uses AGENTS.md convention, not programmatic hooks
+    schema: 'codex',
+    supportedEvents: []
+  },
+  installSubdirs: [
+    'workflows',
+    path.join('templates', 'project'),
+    path.join('templates', 'phase'),
+    path.join('templates', 'architect'),
+    'bin',
+    'lib',
+    'ui-components'
+  ],
+  isAvailable: (home) => {
+    const h = home || os.homedir();
+    return fs.existsSync(path.join(h, '.codex'));
+  }
+};

package/lib/adapters/cursor.cjs

@@ -9,7 +9,8 @@ module.exports = {
   skillsDir:   (home) => path.join(home, '.cursor', 'skills'),
   viepilotDir: (home) => path.join(home, '.cursor', 'viepilot'),
   executionContextBase: '.cursor/viepilot',
-  pathRewrite: null,     // no rewrite needed (source is cursor-first)
+  // Post-install hint shown in "Next actions" after viepilot install
+  postInstallHint: 'Open project and run /vp-status',
   hooks: {
     configFile: null,    // Cursor uses .cursorrules/MDC, not settings.json hooks
     schema: 'cursor',

package/lib/adapters/index.cjs

@@ -2,8 +2,10 @@
 const adapters = {
   'claude-code':  require('./claude-code.cjs'),
   'cursor':       require('./cursor.cjs'),
-  'cursor-agent': require('./cursor.cjs'),  // alias
-  'cursor-ide':   require('./cursor.cjs'),  // alias
+  'cursor-agent': require('./cursor.cjs'),      // alias
+  'cursor-ide':   require('./cursor.cjs'),      // alias
+  'antigravity':  require('./antigravity.cjs'),
+  'codex':        require('./codex.cjs'),
 };
 
 /**

package/lib/viepilot-install.cjs

@@ -199,16 +199,14 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
       steps.push({ kind: 'chmod', path: path.join(vpDir, 'bin', f), mode: 0o755 });
     }
 
-    // path rewrite in skills (if adapter requires it — e.g. claude-code rewrites .cursor → .claude)
-    if (adapter.pathRewrite) {
-      steps.push({
-        kind: 'rewrite_paths_in_dir',
-        dir: skillsDir,
-        glob: '**/*.md',
-        from: adapter.pathRewrite.from,
-        to: adapter.pathRewrite.to,
-      });
-    }
+    // resolve {envToolDir} placeholder → adapter's actual install base (ENH-035)
+    steps.push({
+      kind: 'rewrite_paths_in_dir',
+      dir: skillsDir,
+      glob: '**/*.md',
+      from: '{envToolDir}',
+      to: adapter.executionContextBase,
+    });
   }
 
   steps.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "2.1.0",
+  "version": "2.4.0",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {
@@ -44,8 +44,6 @@
     "workflows/",
     "templates/",
     "ui-components/",
-    "install.sh",
-    "dev-install.sh",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",

package/skills/vp-audit/SKILL.md

@@ -72,7 +72,7 @@ Auto-detects if running inside the viepilot framework repo to enable framework-s
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/audit.md
+@$HOME/{envToolDir}/workflows/audit.md
 </execution_context>
 
 <context>
@@ -89,7 +89,7 @@ Optional flags:
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/audit.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/audit.md`
 
 ### Quick Summary
 

package/skills/vp-auto/SKILL.md

@@ -96,7 +96,7 @@ If required task details are missing, do not implement until task contract is re
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/autonomous.md
+@$HOME/{envToolDir}/workflows/autonomous.md
 </execution_context>
 
 <context>
@@ -119,7 +119,7 @@ See preflight check in `workflows/autonomous.md` → “Preflight: Task Paths Va
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/autonomous.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/autonomous.md`
 
 ### 1. Initialize
 ```bash

package/skills/vp-brainstorm/SKILL.md

@@ -61,7 +61,7 @@ Supports:
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/brainstorm.md
+@$HOME/{envToolDir}/workflows/brainstorm.md
 </execution_context>
 
 <context>
@@ -75,7 +75,7 @@ Optional flags:
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/brainstorm.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/brainstorm.md`
 
 Key steps:
 1. Detect existing sessions

package/skills/vp-crystallize/SKILL.md

@@ -80,12 +80,12 @@ Convert brainstorm sessions into structured artifacts for autonomous AI executio
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/crystallize.md
-@$HOME/.cursor/viepilot/templates/project/
+@$HOME/{envToolDir}/workflows/crystallize.md
+@$HOME/{envToolDir}/templates/project/
 </execution_context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/crystallize.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/crystallize.md`
 
 Key steps:
 

package/skills/vp-debug/SKILL.md

@@ -50,7 +50,7 @@ Systematic debugging with persistent state tracking. Helps track issues across m
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/debug.md
+@$HOME/{envToolDir}/workflows/debug.md
 </execution_context>
 
 <context>
@@ -63,7 +63,7 @@ Optional flags:
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/debug.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/debug.md`
 
 ### Debug Session Structure
 ```json

package/skills/vp-docs/SKILL.md

@@ -64,7 +64,7 @@ CHANGELOG.md (updated)
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/documentation.md
+@$HOME/{envToolDir}/workflows/documentation.md
 </execution_context>
 
 <context>

package/skills/vp-evolve/SKILL.md

@@ -51,7 +51,7 @@ Upgrade or expand the project after completing a milestone or when new features
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/evolve.md
+@$HOME/{envToolDir}/workflows/evolve.md
 </execution_context>
 
 <context>

package/skills/vp-info/SKILL.md

@@ -40,7 +40,7 @@ Use **`vp-tools info --json`** when parsing or comparing versions in scripts.
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/bin/vp-tools.cjs
+@$HOME/{envToolDir}/bin/vp-tools.cjs
 </execution_context>
 
 <process>

package/skills/vp-pause/SKILL.md

@@ -41,11 +41,11 @@ Save complete work state so it can be resumed from any context.
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/pause-work.md
+@$HOME/{envToolDir}/workflows/pause-work.md
 </execution_context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/pause-work.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/pause-work.md`
 
 ### Step 1: Detect Current Position
 ```bash

package/skills/vp-request/SKILL.md

@@ -49,7 +49,7 @@ Create and manage requests for the project under development:
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/request.md
+@$HOME/{envToolDir}/workflows/request.md
 </execution_context>
 
 <context>
@@ -64,7 +64,7 @@ Optional flags:
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/request.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/request.md`
 
 ### Step 1: Detect Request Type
 

package/skills/vp-resume/SKILL.md

@@ -41,11 +41,11 @@ Restore complete project context and resume work seamlessly.
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/resume-work.md
+@$HOME/{envToolDir}/workflows/resume-work.md
 </execution_context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/resume-work.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/resume-work.md`
 
 ### Step 1: Check Project Exists
 ```bash

package/skills/vp-rollback/SKILL.md

@@ -44,7 +44,7 @@ Rollback to any checkpoint safely, with backup and state preservation.
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/rollback.md
+@$HOME/{envToolDir}/workflows/rollback.md
 </execution_context>
 
 <context>

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

@@ -45,7 +45,7 @@ Sources can come from prompt/link/snippet (especially 21st.dev), then normalized
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/ui-components.md
+@$HOME/{envToolDir}/workflows/ui-components.md
 </execution_context>
 
 <context>
@@ -58,7 +58,7 @@ Optional flags:
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/ui-components.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/ui-components.md`
 
 Key steps:
 1. Prepare global + local component stores

package/skills/vp-update/SKILL.md

@@ -37,7 +37,7 @@ Run **`vp-tools update`** to plan and (when confirmed) execute the `npm` upgrade
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/bin/vp-tools.cjs
+@$HOME/{envToolDir}/bin/vp-tools.cjs
 </execution_context>
 
 <process>

package/workflows/autonomous.md

@@ -134,6 +134,25 @@ FOR EACH path in ## Paths:
 This check fires on `~/`, `~\`, and any path starting with `/`.
 It does NOT fire on paths inside code block content within the task (only the `## Paths` header block is validated).
 
+#### ⛔ PATH RESOLUTION RULE (BUG-012)
+
+**All file reads and edits during task execution MUST be resolved from `{cwd}`** — the repository root where `package.json` lives (e.g. `/Users/.../my-project/`).
+
+```
+WHEN executing a task with:
+  ## Paths
+  workflows/brainstorm.md
+
+→ Read and edit: {cwd}/workflows/brainstorm.md
+→ NEVER:         ~/.claude/viepilot/workflows/brainstorm.md
+→ NEVER:         ~/.cursor/viepilot/workflows/brainstorm.md
+→ NEVER:         any path outside {cwd}
+```
+
+**Rule**: If a file exists at both `{cwd}/workflows/foo.md` (codebase) and `~/.claude/viepilot/workflows/foo.md` (production install), **ALWAYS use the `{cwd}` copy**.
+
+The install directory (`~/.claude/`, `~/.cursor/`) is a **deployment artifact** — it is populated by `dev-install.sh`. Editing it directly bypasses version control and will be silently overwritten on the next install.
+
 ### ViePilot Skill Scope Policy (BUG-004 baseline)
 - **Default mode**: only reference/route skills in the ViePilot namespace (`vp-*`).
 - **External skills** (`non vp-*`) are out of scope by default and must not be suggested implicitly.
@@ -214,6 +233,16 @@ Ensure `PHASE-STATE.md` already shows current task `in_progress` (set during the
    git commit -m "{type}({scope}): {description}"
    git push
    ```
+
+   ⛔ **GITIGNORE-AWARE STAGING RULE (BUG-013)**: Before staging any file, verify it is
+   not gitignored. NEVER stage or commit gitignored files — they are internal state, not
+   shipping artifacts.
+   ```bash
+   # Check before staging:
+   git check-ignore -q {file} && echo "IGNORED — skip" || git add {file}
+   ```
+   `.viepilot/` is ALWAYS gitignored in ViePilot repos. **Never run `git add .viepilot/`.**
+
 8. Log notes in task file after each sub-task
 
 #### Verify Task
@@ -238,6 +267,9 @@ Before marking a task PASS, require durable git persistence:
 ```bash
 # Must have no unstaged/staged residue for this task
 git status --porcelain
+# NOTE (BUG-013): lines starting with "??" are UNTRACKED files — NOT a dirty state.
+# Porcelain is CLEAN when output is empty OR contains only "??" lines.
+# Gitignored files (e.g. .viepilot/) must never be staged, so they appear as ?? here.
 
 # Must track an upstream branch
 git rev-parse --abbrev-ref --symbolic-full-name @{u}

package/workflows/brainstorm.md

@@ -413,7 +413,7 @@ Display a confirmation dialogue when any of the following conditions occur:
 ...
 
 What would you like to do?
-1. Save to ui-direction/notes.md (background extraction)
+1. Save to .viepilot/ui-direction/{session-id}/notes.md (background extraction)
 2. Save + activate UI Direction Mode to generate HTML direction
 3. Discard and continue brainstorming
 ```

package/workflows/crystallize.md

@@ -140,6 +140,11 @@ If gaps found → ask user to clarify or return to brainstorm.
 <step name="consume_ui_direction">
 ## Step 1A: Consume UI Direction Artifacts (for UI/UX projects)
 
+> ⛔ **PATH GUARD (BUG-011):** The ONLY valid ui-direction path is `.viepilot/ui-direction/`.
+> If a `{root}/ui-direction/` directory exists at the project root — **IGNORE it completely**.
+> It is user-managed reference material, NOT ViePilot artifacts.
+> Never read, glob, or reference any file under `{root}/ui-direction/` in this workflow.
+
 ### UI Scope Detection (ENH-026 hard gate)
 
 Before checking for artifacts, scan brainstorm session files (`docs/brainstorm/session-*.md`) for UI signal keywords:

package/workflows/evolve.md

@@ -135,6 +135,8 @@ If unsure of the repo-relative path, inspect:
 - `ls bin/`         → CLI files
 - `ls templates/`   → template files
 
+**Resolution rule (BUG-012):** Paths in `## Paths` are always resolved from `{cwd}` (the repo root where `package.json` lives) — never from `~/.claude/`, `~/.cursor/`, or any install directory. When both a codebase copy and an installed copy exist, `{cwd}` wins.
+
 ### Create Phase Directory
 ```bash
 mkdir -p .viepilot/phases/{NN}-{feature-slug}/tasks/

package/dev-install.sh

@@ -1,171 +0,0 @@
-#!/bin/bash
-
-# ViePilot Development Installation Script
-# Installs development build without symlink dependency by default
-#
-# Optional env vars:
-#   VIEPILOT_ADAPTER      — target platform: claude-code (default), cursor, cursor-agent, cursor-ide
-#   VIEPILOT_INSTALL_PROFILE — backward-compat alias for VIEPILOT_ADAPTER
-#   VIEPILOT_AUTO_YES     — skip confirmation prompt (set to 1)
-#   VIEPILOT_SYMLINK_SKILLS=1 — symlink each skills/vp-* instead of copy
-
-set -e
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-
-# Get script directory (project root)
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-AUTO_YES="${VIEPILOT_AUTO_YES:-0}"
-
-# Backward compat: VIEPILOT_INSTALL_PROFILE accepted as alias for VIEPILOT_ADAPTER
-ADAPTER="${VIEPILOT_ADAPTER:-${VIEPILOT_INSTALL_PROFILE:-claude-code}}"
-
-case "$ADAPTER" in
-  claude-code)
-    SKILLS_DIR="$HOME/.claude/skills"
-    VIEPILOT_DIR="$HOME/.claude/viepilot"
-    PROFILE_LABEL="Claude Code"
-    ;;
-  cursor|cursor-agent|cursor-ide)
-    SKILLS_DIR="$HOME/.cursor/skills"
-    VIEPILOT_DIR="$HOME/.cursor/viepilot"
-    PROFILE_LABEL="Cursor"
-    ;;
-  *)
-    echo "Unknown adapter: $ADAPTER. Use: claude-code (default), cursor-agent, cursor-ide"
-    exit 1
-    ;;
-esac
-
-echo -e "${BLUE}"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo " VIEPILOT DEV INSTALLER"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo -e "${NC}"
-
-if [ "${VIEPILOT_SYMLINK_SKILLS:-0}" = "1" ]; then
-    echo -e "${YELLOW}Development mode installation (skills: SYMLINK → repo)${NC}"
-else
-    echo -e "${YELLOW}Development mode installation (copy-first for reliability)${NC}"
-fi
-echo "  Source:  $SCRIPT_DIR"
-echo "  Skills:  $SKILLS_DIR"
-echo "  Viepilot: $VIEPILOT_DIR"
-echo "  Adapter: $ADAPTER ($PROFILE_LABEL)"
-echo ""
-
-check_cloc_dependency() {
-    if command -v cloc >/dev/null 2>&1; then
-        echo -e "  ${GREEN}✓${NC} cloc detected"
-        return 0
-    fi
-
-    echo -e "${YELLOW}  cloc not found.${NC}"
-    echo "  README LOC auto-sync will fallback safely, but metrics won't refresh automatically."
-    echo "  Install suggestion:"
-    echo "    - macOS: brew install cloc"
-    echo "    - Ubuntu/Debian: sudo apt-get install -y cloc"
-    echo "    - Windows: choco install cloc"
-}
-
-# Confirm
-if [ "$AUTO_YES" != "1" ]; then
-    read -p "This will replace existing installation with dev files. Continue? (y/n) " -n 1 -r
-    echo
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-        echo "Installation cancelled."
-        exit 0
-    fi
-else
-    echo "Auto-yes enabled via VIEPILOT_AUTO_YES=1"
-fi
-
-echo ""
-echo -e "${BLUE}Removing old installations...${NC}"
-
-# Remove old skill installations
-for skill in "$SKILLS_DIR"/vp-*/; do
-    if [ -d "$skill" ] || [ -L "$skill" ]; then
-        rm -rf "$skill"
-        echo "  Removed: $(basename "$skill")"
-    fi
-done
-
-# Remove old viepilot installation
-if [ -d "$VIEPILOT_DIR" ] || [ -L "$VIEPILOT_DIR" ]; then
-    rm -rf "$VIEPILOT_DIR"
-    echo "  Removed: viepilot/"
-fi
-
-echo ""
-echo -e "${BLUE}Installing skills...${NC}"
-
-# Install skills: copy (default) or symlink when VIEPILOT_SYMLINK_SKILLS=1
-mkdir -p "$SKILLS_DIR"
-for skill in "$SCRIPT_DIR"/skills/vp-*/; do
-    skill_name=$(basename "$skill")
-    if [ "${VIEPILOT_SYMLINK_SKILLS:-0}" = "1" ]; then
-        if command -v realpath >/dev/null 2>&1; then
-            skill_abs=$(realpath "$skill")
-        else
-            skill_abs=$(cd "$skill" && pwd)
-        fi
-        ln -sfn "$skill_abs" "$SKILLS_DIR/$skill_name"
-        echo -e "  ${GREEN}✓${NC} $skill_name (symlink)"
-    else
-        cp -R "$skill" "$SKILLS_DIR/$skill_name"
-        echo -e "  ${GREEN}✓${NC} $skill_name"
-    fi
-done
-
-echo ""
-echo -e "${BLUE}Installing viepilot files...${NC}"
-
-# Install file copies (avoid symlink discovery issues)
-mkdir -p "$VIEPILOT_DIR"
-mkdir -p "$VIEPILOT_DIR/workflows"
-mkdir -p "$VIEPILOT_DIR/templates"
-mkdir -p "$VIEPILOT_DIR/bin"
-mkdir -p "$VIEPILOT_DIR/lib"
-mkdir -p "$VIEPILOT_DIR/ui-components"
-
-cp -R "$SCRIPT_DIR/workflows/"* "$VIEPILOT_DIR/workflows/"
-cp -R "$SCRIPT_DIR/templates/"* "$VIEPILOT_DIR/templates/"
-cp -R "$SCRIPT_DIR/bin/"* "$VIEPILOT_DIR/bin/"
-cp -R "$SCRIPT_DIR/lib/"* "$VIEPILOT_DIR/lib/"
-if [ -d "$SCRIPT_DIR/ui-components" ]; then
-    cp -R "$SCRIPT_DIR/ui-components/"* "$VIEPILOT_DIR/ui-components/"
-fi
-
-echo -e "  ${GREEN}✓${NC} workflows"
-echo -e "  ${GREEN}✓${NC} templates"
-echo -e "  ${GREEN}✓${NC} bin"
-echo -e "  ${GREEN}✓${NC} lib"
-echo -e "  ${GREEN}✓${NC} ui-components"
-check_cloc_dependency
-
-# Count installed
-SKILL_COUNT=$(ls -d "$SKILLS_DIR"/vp-*/ 2>/dev/null | wc -l | tr -d ' ')
-WORKFLOW_COUNT=$(ls "$SCRIPT_DIR"/workflows/*.md 2>/dev/null | wc -l | tr -d ' ')
-
-echo ""
-echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo -e "${GREEN} DEV INSTALLATION COMPLETE ✓${NC}"
-echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo ""
-if [ "${VIEPILOT_SYMLINK_SKILLS:-0}" = "1" ]; then
-    echo "Installed (skills symlink mode):"
-    echo -e "${YELLOW}Skills point at repo — edits in $SCRIPT_DIR/skills/ are live.${NC}"
-else
-    echo "Installed (copy mode):"
-    echo -e "${YELLOW}Development mode enabled (reliable copy mode).${NC}"
-    echo "Re-run this script after local changes to refresh installed files."
-fi
-echo "  - Skills: $SKILL_COUNT"
-echo "  - Workflows: $WORKFLOW_COUNT"
-echo ""

package/install.sh

@@ -1,125 +0,0 @@
-#!/bin/bash
-
-# 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
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR" || exit 1
-
-CURSOR_SKILLS_DIR="$HOME/.cursor/skills"
-VIEPILOT_DIR="$HOME/.cursor/viepilot"
-AUTO_YES="${VIEPILOT_AUTO_YES:-0}"
-INSTALL_PROFILE="${VIEPILOT_INSTALL_PROFILE:-cursor-ide}"
-ADD_PATH_CHOICE="${VIEPILOT_ADD_PATH:-0}"
-
-echo -e "${BLUE}"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo " VIEPILOT INSTALLER"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo -e "${NC}"
-
-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
-fi
-
-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() {
-    if command -v cloc >/dev/null 2>&1; then
-        echo "  ✓ cloc detected"
-        return 0
-    fi
-
-    echo -e "${YELLOW}  cloc not found.${NC}"
-    echo "  README metric auto-sync can still run with fallback, but LOC refresh will be skipped."
-    echo "  Suggested install:"
-    echo "    - macOS: brew install cloc"
-    echo "    - Ubuntu/Debian: sudo apt-get install -y cloc"
-    echo "    - Windows: choco install cloc"
-
-    if [ "$AUTO_YES" = "1" ]; then
-        return 0
-    fi
-
-    read -p "  Attempt automatic cloc install now (best effort)? (y/n) " -n 1 -r
-    echo
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-        return 0
-    fi
-
-    if command -v brew >/dev/null 2>&1; then
-        brew install cloc || true
-    elif command -v apt-get >/dev/null 2>&1; then
-        sudo apt-get update && sudo apt-get install -y cloc || true
-    elif command -v dnf >/dev/null 2>&1; then
-        sudo dnf install -y cloc || true
-    elif command -v yum >/dev/null 2>&1; then
-        sudo yum install -y cloc || true
-    elif command -v pacman >/dev/null 2>&1; then
-        sudo pacman -Sy --noconfirm cloc || true
-    else
-        echo -e "${YELLOW}  Could not detect supported package manager. Install cloc manually.${NC}"
-    fi
-
-    if command -v cloc >/dev/null 2>&1; then
-        echo "  ✓ cloc installed"
-    else
-        echo -e "${YELLOW}  cloc is still unavailable; continuing without blocking installation.${NC}"
-    fi
-}
-
-if [ "$AUTO_YES" != "1" ]; then
-    read -p "Continue with installation? (y/n) " -n 1 -r
-    echo
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-        echo "Installation cancelled."
-        exit 0
-    fi
-else
-    echo "Auto-yes enabled via VIEPILOT_AUTO_YES=1"
-fi
-
-echo ""
-echo -e "${BLUE}Preparing Node installer...${NC}"
-install_cloc_best_effort
-
-echo ""
-if [ "$AUTO_YES" != "1" ]; then
-    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
-    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 "${BLUE}Running: node bin/viepilot.cjs ${NODE_ARGS[*]}${NC}"
-exec node "$SCRIPT_DIR/bin/viepilot.cjs" "${NODE_ARGS[@]}"