viepilot 1.14.0 → 2.4.0

package/lib/viepilot-install.cjs

@@ -7,6 +7,8 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const { resolveViepilotPackageRoot } = require('./viepilot-info.cjs');
+const { writeConfig } = require('./viepilot-config.cjs');
+const { getAdapter } = require('./adapters/index.cjs');
 
 /** @see docs/dev/global-profiles.md (FEAT-009) */
 const VIEPILOT_PROFILE_MAP_SEED = `# ViePilot profile map
@@ -24,7 +26,7 @@ Machine-level registry for reusable org/client profiles. Add rows when you creat
 function normalizeInstallEnv(envSource = process.env) {
   return {
     autoYes: envSource.VIEPILOT_AUTO_YES === '1',
-    profile: envSource.VIEPILOT_INSTALL_PROFILE || 'cursor-ide',
+    profile: envSource.VIEPILOT_INSTALL_PROFILE || 'claude-code',
     addPath: envSource.VIEPILOT_ADD_PATH === '1',
     symlinkSkills: envSource.VIEPILOT_SYMLINK_SKILLS === '1',
   };
@@ -85,16 +87,34 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
   const env = normalizeInstallEnv(envSource);
   const home =
     opts.overrideHomedir != null ? path.resolve(opts.overrideHomedir) : os.homedir();
-  const cursorSkillsDir = path.join(home, '.cursor', 'skills');
-  const viepilotDir = path.join(home, '.cursor', 'viepilot');
   const viepilotUserDataDir = path.join(home, '.viepilot');
   const viepilotProfilesDir = path.join(viepilotUserDataDir, 'profiles');
   const viepilotProfileMapPath = path.join(viepilotUserDataDir, 'profile-map.md');
 
   const installTargets = Array.isArray(opts.installTargets) ? opts.installTargets : [];
-  const installClaudeSkills = installTargets.includes('claude-code');
-  const claudeSkillsDir = installClaudeSkills ? path.join(home, '.claude', 'skills') : null;
-  const claudeViepilotDir = installClaudeSkills ? path.join(home, '.claude', 'viepilot') : null;
+
+  // Resolve target IDs to adapters.
+  // Backward compat: if no installTargets, infer from env.profile (cursor-agent/cursor-ide → cursor).
+  // Default: claude-code (FEAT-013 — Claude Code is primary platform).
+  let targetIds;
+  if (installTargets.length > 0) {
+    targetIds = installTargets;
+  } else if (env.profile === 'cursor-agent' || env.profile === 'cursor-ide') {
+    targetIds = [env.profile];
+  } else {
+    targetIds = ['claude-code'];
+  }
+
+  // Deduplicate by adapter canonical id (cursor-agent + cursor-ide → one cursor install).
+  const seenAdapterIds = new Set();
+  const selectedAdapters = [];
+  for (const id of targetIds) {
+    const adapter = getAdapter(id);
+    if (!seenAdapterIds.has(adapter.id)) {
+      seenAdapterIds.add(adapter.id);
+      selectedAdapters.push(adapter);
+    }
+  }
 
   let wantPathShim = opts.wantPathShim;
   if (wantPathShim === undefined) {
@@ -104,19 +124,6 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
   /** @type {object[]} */
   const steps = [];
 
-  const mkdirTargets = [
-    cursorSkillsDir,
-    path.join(viepilotDir, 'workflows'),
-    path.join(viepilotDir, 'templates', 'project'),
-    path.join(viepilotDir, 'templates', 'phase'),
-    path.join(viepilotDir, 'bin'),
-    path.join(viepilotDir, 'lib'),
-    path.join(viepilotDir, 'ui-components'),
-  ];
-  for (const dir of mkdirTargets) {
-    steps.push({ kind: 'mkdir', path: dir });
-  }
-
   steps.push({ kind: 'mkdir', path: viepilotProfilesDir });
   steps.push({
     kind: 'write_file_if_missing',
@@ -124,147 +131,81 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
     content: VIEPILOT_PROFILE_MAP_SEED,
   });
 
-  for (const name of listSkillDirNames(root)) {
-    const src = path.join(root, 'skills', name);
-    const dest = path.join(cursorSkillsDir, name);
-    if (env.symlinkSkills) {
-      steps.push({
-        kind: 'symlink_dir',
-        target: dest,
-        sourceAbsolute: path.resolve(src),
-      });
-    } else {
-      steps.push({ kind: 'copy_dir', from: src, to: dest });
+  const binFiles = ['vp-tools.cjs', 'viepilot.cjs'];
+  const libFiles = ['cli-shared.cjs', 'viepilot-info.cjs', 'viepilot-update.cjs', 'viepilot-install.cjs', 'viepilot-config.cjs'];
+  const uiRoot = path.join(root, 'ui-components');
+
+  // One install loop per selected adapter (replaces cursor block + claude-code if-block).
+  for (const adapter of selectedAdapters) {
+    const skillsDir = adapter.skillsDir(home);
+    const vpDir = adapter.viepilotDir(home);
+
+    // mkdir: skills dir + all viepilot subdirs
+    steps.push({ kind: 'mkdir', path: skillsDir });
+    for (const sub of adapter.installSubdirs) {
+      steps.push({ kind: 'mkdir', path: path.join(vpDir, sub) });
     }
-  }
 
-  if (installClaudeSkills && claudeSkillsDir) {
-    steps.push({ kind: 'mkdir', path: claudeSkillsDir });
+    // copy skills into skillsDir
     for (const name of listSkillDirNames(root)) {
       const src = path.join(root, 'skills', name);
-      const dest = path.join(claudeSkillsDir, name);
+      const dest = path.join(skillsDir, name);
       if (env.symlinkSkills) {
-        steps.push({
-          kind: 'symlink_dir',
-          target: dest,
-          sourceAbsolute: path.resolve(src),
-        });
+        steps.push({ kind: 'symlink_dir', target: dest, sourceAbsolute: path.resolve(src) });
       } else {
         steps.push({ kind: 'copy_dir', from: src, to: dest });
       }
     }
 
-    // BUG-005: mirror workflows/templates/bin/lib to ~/.claude/viepilot/
-    if (claudeViepilotDir) {
-      for (const sub of [
-        'workflows',
-        path.join('templates', 'project'),
-        path.join('templates', 'phase'),
-        'bin',
-        'lib',
-      ]) {
-        steps.push({ kind: 'mkdir', path: path.join(claudeViepilotDir, sub) });
-      }
-
-      for (const ent of listDirEntries(root, 'workflows')) {
-        const src = path.join(root, 'workflows', ent.name);
-        const dest = path.join(claudeViepilotDir, 'workflows', ent.name);
-        steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
-      }
-
-      for (const ent of listDirEntries(root, path.join('templates', 'project'))) {
-        const src = path.join(root, 'templates', 'project', ent.name);
-        const dest = path.join(claudeViepilotDir, 'templates', 'project', ent.name);
-        steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
-      }
-
-      for (const ent of listDirEntries(root, path.join('templates', 'phase'))) {
-        const src = path.join(root, 'templates', 'phase', ent.name);
-        const dest = path.join(claudeViepilotDir, 'templates', 'phase', ent.name);
-        steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
-      }
-
-      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) });
-      }
-      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({
-        kind: 'rewrite_paths_in_dir',
-        dir: claudeSkillsDir,
-        glob: '**/*.md',
-        from: '.cursor/viepilot',
-        to: '.claude/viepilot',
-      });
+    // copy viepilot files into vpDir
+    for (const ent of listDirEntries(root, 'workflows')) {
+      const src = path.join(root, 'workflows', ent.name);
+      const dest = path.join(vpDir, 'workflows', ent.name);
+      steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
     }
-  }
-
-  for (const ent of listDirEntries(root, 'workflows')) {
-    const src = path.join(root, 'workflows', ent.name);
-    const dest = path.join(viepilotDir, 'workflows', ent.name);
-    if (ent.isDirectory()) {
-      steps.push({ kind: 'copy_dir', from: src, to: dest });
-    } else if (ent.isFile()) {
-      steps.push({ kind: 'copy_file', from: src, to: dest });
+    for (const ent of listDirEntries(root, path.join('templates', 'project'))) {
+      const src = path.join(root, 'templates', 'project', ent.name);
+      const dest = path.join(vpDir, 'templates', 'project', ent.name);
+      steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
     }
-  }
-
-  for (const ent of listDirEntries(root, path.join('templates', 'project'))) {
-    const src = path.join(root, 'templates', 'project', ent.name);
-    const dest = path.join(viepilotDir, 'templates', 'project', ent.name);
-    if (ent.isDirectory()) {
-      steps.push({ kind: 'copy_dir', from: src, to: dest });
-    } else if (ent.isFile()) {
-      steps.push({ kind: 'copy_file', from: src, to: dest });
+    for (const ent of listDirEntries(root, path.join('templates', 'phase'))) {
+      const src = path.join(root, 'templates', 'phase', ent.name);
+      const dest = path.join(vpDir, 'templates', 'phase', ent.name);
+      steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
     }
-  }
-
-  for (const ent of listDirEntries(root, path.join('templates', 'phase'))) {
-    const src = path.join(root, 'templates', 'phase', ent.name);
-    const dest = path.join(viepilotDir, 'templates', 'phase', ent.name);
-    if (ent.isDirectory()) {
-      steps.push({ kind: 'copy_dir', from: src, to: dest });
-    } else if (ent.isFile()) {
-      steps.push({ kind: 'copy_file', from: src, to: dest });
+    for (const ent of listDirEntries(root, path.join('templates', 'architect'))) {
+      const src = path.join(root, 'templates', 'architect', ent.name);
+      const dest = path.join(vpDir, 'templates', 'architect', ent.name);
+      steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
     }
-  }
-
-  const uiRoot = path.join(root, 'ui-components');
-  if (fs.existsSync(uiRoot)) {
-    for (const ent of listDirEntries(root, 'ui-components')) {
-      const src = path.join(root, 'ui-components', ent.name);
-      const dest = path.join(viepilotDir, 'ui-components', ent.name);
-      if (ent.isDirectory()) {
-        steps.push({ kind: 'copy_dir', from: src, to: dest });
-      } else if (ent.isFile()) {
-        steps.push({ kind: 'copy_file', from: src, to: dest });
+    for (const f of binFiles) {
+      steps.push({ kind: 'copy_file', from: path.join(root, 'bin', f), to: path.join(vpDir, 'bin', f) });
+    }
+    for (const f of libFiles) {
+      steps.push({ kind: 'copy_file', from: path.join(root, 'lib', f), to: path.join(vpDir, 'lib', f) });
+    }
+    if (fs.existsSync(uiRoot)) {
+      for (const ent of listDirEntries(root, 'ui-components')) {
+        const src = path.join(root, 'ui-components', ent.name);
+        const dest = path.join(vpDir, 'ui-components', ent.name);
+        steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
       }
     }
-  }
+    // BUG-007: copy package.json so resolveViepilotPackageRoot() finds the root
+    steps.push({ kind: 'copy_file', from: path.join(root, 'package.json'), to: path.join(vpDir, 'package.json') });
 
-  const binFiles = ['vp-tools.cjs', 'viepilot.cjs'];
-  for (const f of binFiles) {
-    steps.push({
-      kind: 'copy_file',
-      from: path.join(root, 'bin', f),
-      to: path.join(viepilotDir, 'bin', f),
-    });
-  }
-  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) });
-  }
+    // chmod bin files
+    for (const f of binFiles) {
+      steps.push({ kind: 'chmod', path: path.join(vpDir, 'bin', f), mode: 0o755 });
+    }
 
-  for (const f of binFiles) {
+    // resolve {envToolDir} placeholder → adapter's actual install base (ENH-035)
     steps.push({
-      kind: 'chmod',
-      path: path.join(viepilotDir, 'bin', f),
-      mode: 0o755,
+      kind: 'rewrite_paths_in_dir',
+      dir: skillsDir,
+      glob: '**/*.md',
+      from: '{envToolDir}',
+      to: adapter.executionContextBase,
     });
   }
 
@@ -275,27 +216,43 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
       'Check optional cloc for README metrics (brew/apt/dnf/choco); installation continues if missing.',
   });
 
+  const primaryAdapter = selectedAdapters[0];
+  const primaryVpDir = primaryAdapter.viepilotDir(home);
+
   if (wantPathShim) {
     steps.push({
       kind: 'path_shim',
       links: [
-        { path: '/usr/local/bin/vp-tools', target: path.join(viepilotDir, 'bin', 'vp-tools.cjs') },
-        { path: '/usr/local/bin/viepilot', target: path.join(viepilotDir, 'bin', 'viepilot.cjs') },
+        { path: '/usr/local/bin/vp-tools', target: path.join(primaryVpDir, 'bin', 'vp-tools.cjs') },
+        { path: '/usr/local/bin/viepilot', target: path.join(primaryVpDir, 'bin', 'viepilot.cjs') },
       ],
       note: 'Unix typical; on Windows native, PATH shim may be skipped or manual.',
     });
   }
 
+  // ENH-032: prompt for language config at end of install
+  steps.push({
+    kind: 'language_config_prompt',
+    autoYes: env.autoYes,
+    home,
+  });
+
+  // Build paths object — legacy keys preserved for backward compat with existing tests/CLI.
+  const cursorAdapter = selectedAdapters.find((a) => a.id === 'cursor');
+  const claudeAdapter = selectedAdapters.find((a) => a.id === 'claude-code');
+
   return {
     version: 1,
     packageRoot: root,
     env,
     home,
     paths: {
-      cursorSkillsDir,
-      claudeSkillsDir,
-      claudeViepilotDir,
-      viepilotDir,
+      skillsDir: primaryAdapter.skillsDir(home),
+      viepilotDir: primaryAdapter.viepilotDir(home),
+      // Legacy keys for backward compat:
+      cursorSkillsDir: cursorAdapter ? cursorAdapter.skillsDir(home) : null,
+      claudeSkillsDir: claudeAdapter ? claudeAdapter.skillsDir(home) : null,
+      claudeViepilotDir: claudeAdapter ? claudeAdapter.viepilotDir(home) : null,
       viepilotUserDataDir,
       viepilotProfilesDir,
       viepilotProfileMapPath,
@@ -313,12 +270,15 @@ function formatPlanLines(plan) {
   const lines = [];
   lines.push('ViePilot install plan (dry-run)');
   lines.push(`  packageRoot: ${plan.packageRoot}`);
-  lines.push(`  profile: ${plan.env.profile} (informational; Cursor paths always; Claude Code skills when target includes claude-code)`);
-  lines.push(`  skills (Cursor): ${plan.paths.cursorSkillsDir}`);
-  if (plan.paths.claudeSkillsDir) {
+  lines.push(`  profile: ${plan.env.profile}`);
+  lines.push(`  skills: ${plan.paths.skillsDir}`);
+  if (plan.paths.cursorSkillsDir && plan.paths.cursorSkillsDir !== plan.paths.skillsDir) {
+    lines.push(`  skills (Cursor): ${plan.paths.cursorSkillsDir}`);
+  }
+  if (plan.paths.claudeSkillsDir && plan.paths.claudeSkillsDir !== plan.paths.skillsDir) {
     lines.push(`  skills (Claude Code): ${plan.paths.claudeSkillsDir}`);
   }
-  if (plan.paths.claudeViepilotDir) {
+  if (plan.paths.claudeViepilotDir && plan.paths.claudeViepilotDir !== plan.paths.viepilotDir) {
     lines.push(`  viepilot (Claude Code): ${plan.paths.claudeViepilotDir}`);
   }
   lines.push(`  viepilot: ${plan.paths.viepilotDir}`);
@@ -358,6 +318,9 @@ function formatPlanLines(plan) {
       case 'rewrite_paths_in_dir':
         lines.push(`${n}. rewrite_paths_in_dir ${s.dir}: "${s.from}" → "${s.to}" in ${s.glob}`);
         break;
+      case 'language_config_prompt':
+        lines.push(`${n}. language_config_prompt: write ~/.viepilot/config.json (communication + document language; ${s.autoYes ? 'auto-yes → defaults' : 'interactive'})`);
+        break;
       default:
         lines.push(`${n}. ${JSON.stringify(s)}`);
     }
@@ -503,7 +466,7 @@ function applyInstallPlan(plan, options = {}) {
           break;
         case 'path_shim':
           if (process.platform === 'win32') {
-            logs.push('path_shim: skipped on Windows (add ~/.cursor/viepilot/bin to PATH manually if needed).');
+            logs.push('path_shim: skipped on Windows (add viepilot/bin to PATH manually if needed).');
             break;
           }
           if (dryRun) {
@@ -544,6 +507,16 @@ function applyInstallPlan(plan, options = {}) {
           rewriteDir(step.dir);
           break;
         }
+        case 'language_config_prompt': {
+          if (dryRun) {
+            logs.push(`[dry-run] language_config_prompt: would write ~/.viepilot/config.json with communication=en, document=en`);
+            break;
+          }
+          // Write defaults; future interactive installer can prompt here
+          writeConfig({ language: { communication: 'en', document: 'en' } }, step.home);
+          logs.push(`language_config_prompt: wrote ${step.home}/.viepilot/config.json (communication=en, document=en)`);
+          break;
+        }
         default:
           logs.push(`unknown step kind: ${JSON.stringify(step)}`);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "1.14.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

@@ -25,54 +25,54 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 <implementation_routing_guard>
 ## Implementation routing guard (ENH-021)
 
-- **Báo cáo / gap** — **không** fix shipping mặc định; route **`/vp-request`** → **`/vp-evolve`** → **`/vp-auto`** hoặc user explicit. Xem `workflows/request.md`.
+- **Report / gap** — do **not** fix shipping by default; route **`/vp-request`** → **`/vp-evolve`** → **`/vp-auto`** or user explicit. See `workflows/request.md`.
 </implementation_routing_guard>
 
 
 <objective>
-Audit ViePilot project state và documentation để phát hiện drift.
-Hoạt động trên **bất kỳ project nào** đang dùng ViePilot (Java, Node, Python, v.v.).
-Auto-detect nếu đang chạy trong viepilot framework repo để thêm framework-specific checks.
+Audit ViePilot project state and documentation to detect drift.
+Works on **any project** using ViePilot (Java, Node, Python, etc.).
+Auto-detects if running inside the viepilot framework repo to enable framework-specific checks.
 
-**Tier 1 — ViePilot State Consistency (mọi project):**
+**Tier 1 — ViePilot State Consistency (all projects):**
 - `.viepilot/TRACKER.md` current state vs `.viepilot/phases/*/PHASE-STATE.md`
 - `.viepilot/ROADMAP.md` phase status vs PHASE-STATE.md
 - `.viepilot/HANDOFF.json` vs TRACKER.md (resume-state consistency)
 - Git tags `vp-p{N}-complete` vs completed phases in PHASE-STATE.md
 
-**Tier 2 — Project Documentation Drift (mọi project):**
+**Tier 2 — Project Documentation Drift (all projects):**
 - `README.md` version vs `package.json` / `pom.xml` / `pyproject.toml`
 - `CHANGELOG.md` vs recent git commits
-- Placeholder URLs trong `docs/` (`your-org`, `YOUR_USERNAME`, v.v.)
-- Features mới (từ phases gần đây) chưa có documentation
+- Placeholder URLs in `docs/` (`your-org`, `YOUR_USERNAME`, etc.)
+- New features (from recent phases) without documentation
 - `ARCHITECTURE.md` diagram applicability matrix consistency:
   - `required` diagrams must have Mermaid content
   - `optional` diagrams may be omitted/merged with explicit note
   - `N/A` diagrams must have rationale line
 - **ENH-022 (recommended check):** when a diagram type is `required` (or `optional` with a real Mermaid block) and crystallize policy applies, verify **`.viepilot/architecture/<type>.mermaid`** exists and that **Diagram source** lines in `ARCHITECTURE.md` match; for `N/A`, sidecar file should be absent (no empty stubs)
 
-**Tier 3 — Stack Best Practices + Code Quality (mọi project, theo stack detect được):**
-- Detect stacks liên quan từ context/project manifests
-- So khớp code patterns với stack-specific Do/Don't + anti-patterns
-- Severity findings: `critical` / `high` / `medium` / `low` kèm file/module mapping
-- Fallback research bằng `WebSearch` + `WebFetch` khi cache stack thiếu/yếu
-- Sinh output guardrails/checklist để `vp-auto` tái sử dụng trong preflight
+**Tier 3 — Stack Best Practices + Code Quality (all projects, for each detected stack):**
+- Detect relevant stacks from context/project manifests
+- Match code patterns against stack-specific Do/Don't + anti-patterns
+- Severity findings: `critical` / `high` / `medium` / `low` with file/module mapping
+- Fallback research using `WebSearch` + `WebFetch` when stack cache is missing/weak
+- Generate guardrails/checklist output for `vp-auto` reuse during preflight
 
-**Tier 4 — Framework Integrity (chỉ khi detect viepilot framework repo):**
-- Auto-detect: `skills/vp-*/SKILL.md` tồn tại → là viepilot framework repo
-- `ARCHITECTURE.md` counts vs `skills/`, `workflows/`, CLI thực tế
+**Tier 4 — Framework Integrity (only when viepilot framework repo is detected):**
+- Auto-detect: `skills/vp-*/SKILL.md` present → this is the viepilot framework repo
+- `ARCHITECTURE.md` counts vs actual `skills/`, `workflows/`, CLI
 - `README.md` viepilot-specific badges (version, skills-N, workflows-N)
 - `docs/skills-reference.md` sections vs `skills/` directory
 
 **Output:**
-- Báo cáo theo 4 tiers, mỗi tier có status riêng
-- Auto-fix option theo tier
-- Suggestions cho complex gaps
-- `vp-auto` compatible guardrails contract theo từng stack
+- Report by 4 tiers, each tier with its own status
+- Auto-fix option per tier
+- Suggestions for complex gaps
+- `vp-auto`-compatible guardrails contract per stack
 </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

@@ -1,6 +1,6 @@
 ---
 name: vp-auto
-description: "Autonomous execution loop với control points và recovery"
+description: "Autonomous execution loop with control points and recovery"
 version: 0.2.2
 ---
 
@@ -10,7 +10,7 @@ version: 0.2.2
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
 
 ## B. User Prompting
-Prompt user conversationally với numbered list options tại control points.
+Prompt user conversationally with numbered list options at control points.
 
 ## C. Tool Usage
 Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
@@ -28,12 +28,12 @@ Use `Task(subagent_type="generalPurpose", ...)` for parallel execution.
 <implementation_routing_guard>
 ## Primary implementation lane (ENH-021)
 
-- **`/vp-auto`** + `workflows/autonomous.md` là **lane mặc định** để **implement** work đã có **phase/task plan** (doc-first **BUG-001**, git persistence **BUG-003**). **`/vp-request`** và **`/vp-evolve`** **không** thay thế lane này trừ user **explicit** override.
+- **`/vp-auto`** + `workflows/autonomous.md` is the **default lane** for **implementing** work that already has a **phase/task plan** (doc-first **BUG-001**, git persistence **BUG-003**). **`/vp-request`** and **`/vp-evolve`** do **not** replace this lane unless the user **explicitly** overrides.
 </implementation_routing_guard>
 
 
 <objective>
-Autonomous execution của project phases. Cho mỗi phase: analyze → plan → execute → verify → iterate.
+Autonomous execution of project phases. For each phase: analyze → plan → execute → verify → iterate.
 
 Pauses at control points:
 - Conflicts detected
@@ -88,24 +88,38 @@ If required task details are missing, do not implement until task contract is re
 - `README.md` metrics — run `npm run readme:sync` when script exists; if `cloc` missing, continue with logged guidance (non-blocking)
 
 **After:** Project built, or paused for user intervention.
+
+**Language configuration (ENH-032):**
+- Initialize step reads `~/.viepilot/config.json` → `COMMUNICATION_LANG` (default: `en`).
+- `COMMUNICATION_LANG` controls banners, control-point messages, and user-facing output.
+- Configure via: `vp-tools config set language.communication vi`
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/autonomous.md
+@$HOME/{envToolDir}/workflows/autonomous.md
 </execution_context>
 
 <context>
 Optional flags:
-- `--from N` : Start từ phase N
-- `--phase N` : Chỉ chạy phase N
+- `--from N` : Start from phase N
+- `--phase N` : Run only phase N
 - `--fast` : Skip optional verifications
 - `--dry-run` : Plan only, no execution
 
-No extra args: chỉ nghĩa các cờ trên **tắt** — **không** phải rule “dừng bắt buộc sau mỗi task”. Trong chat, một turn thường ~một task; tiếp tục bằng lượt sau hoặc `/vp-auto` lại. Doc: `docs/user/features/autonomous-mode.md`.
+No extra args: simply means the flags above are **off** — **not** a rule of “mandatory stop after each task”. In chat, one turn is typically ~one task; continue with the next turn or invoke `/vp-auto` again. Doc: `docs/user/features/autonomous-mode.md`.
+
+**Task path validation (BUG-009):**
+Before executing each task, validates all paths in the `## Paths` block.
+If any path starts with `~/` or `/` (absolute):
+- Execution stops for that task with a ⛔ error message
+- User must fix the task file to use repo-relative paths before continuing
+- This prevents accidentally editing `~/.claude/` (live install) instead of source
+
+See preflight check in `workflows/autonomous.md` → “Preflight: Task Paths Validation (BUG-009)”.
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/autonomous.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/autonomous.md`
 
 ### 1. Initialize
 ```bash