viepilot 2.45.3 → 2.45.5

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.45.5] - 2026-04-27
+
+### Enhanced
+- **ENH-078**: `npx viepilot install` now prompts users to select their preferred
+  communication language (the language ViePilot uses for banners and AI prompts)
+  via keyboard selector or numbered-list fallback; chosen language written to
+  `~/.viepilot/config.json → language.communication`; supports 10 languages
+  (en, vi, fr, ja, de, es, zh, ko, pt, id); `--yes` mode skips prompt and
+  defaults to `en` (ENH-078)
+
+## [2.45.4] - 2026-04-27
+
+### Fixed
+- **BUG-025**: brownfield crystallize initial mode-selection prompt ("Proceed / Run brainstorm
+  first / Cancel") was rendered as plain-text numbered list on Claude Code terminal because
+  `workflows/crystallize.md` Step 0-B had no AUQ spec for the auto-detected entry gate.
+  Fix: added adapter-aware `AskUserQuestion` block with 3 labelled options before scanner
+  execution; text fallback preserved for Cursor/Codex/Antigravity (BUG-025)
+
 ## [2.45.3] - 2026-04-25
 
 ### Fixed

package/bin/viepilot.cjs

@@ -17,6 +17,19 @@ const { buildInstallPlan, applyInstallPlan, resolveViepilotPackageRoot } = requi
 const { adapters: adapterMap } = require(path.join(__dirname, '..', 'lib', 'adapters', 'index.cjs'));
 
 // UI target list — keep cursor-agent and cursor-ide as distinct choices for users.
+const LANGUAGES = [
+  { id: 'en', label: 'English (en)' },
+  { id: 'vi', label: 'Vietnamese — Tiếng Việt (vi)' },
+  { id: 'fr', label: 'French — Français (fr)' },
+  { id: 'ja', label: 'Japanese — 日本語 (ja)' },
+  { id: 'de', label: 'German — Deutsch (de)' },
+  { id: 'es', label: 'Spanish — Español (es)' },
+  { id: 'zh', label: 'Chinese Simplified — 中文 (zh)' },
+  { id: 'ko', label: 'Korean — 한국어 (ko)' },
+  { id: 'pt', label: 'Portuguese — Português (pt)' },
+  { id: 'id', label: 'Indonesian — Bahasa Indonesia (id)' },
+];
+
 const TARGETS = [
   { id: 'claude-code',  label: adapterMap['claude-code'].name + ' (default)' },
   { id: 'cursor-agent', label: 'Cursor Agent' },
@@ -235,6 +248,19 @@ function ask(question) {
   });
 }
 
+async function interactiveLanguageSelection() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    console.log('\nSelect communication language (ViePilot banners and prompts):');
+    LANGUAGES.forEach((l, idx) => console.log(`  ${idx + 1}. ${l.label}`));
+    const answer = await ask('Language [1 = English]: ');
+    const idx = parseInt(answer, 10);
+    const lang = LANGUAGES[Number.isInteger(idx) && idx >= 1 && idx <= LANGUAGES.length ? idx - 1 : 0];
+    return lang.id;
+  }
+  const selected = await runKeyboardSelector(LANGUAGES, 'single', 'Select communication language');
+  return (selected && selected[0]) || 'en';
+}
+
 async function interactiveTargetSelection() {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     console.log('\nSelect install targets (comma-separated numbers):');
@@ -261,7 +287,7 @@ async function interactiveTargetSelection() {
  * @param {boolean} dryRun
  * @returns {{ ok: boolean, code: number }}
  */
-function runInstallViaNode(selectedTargets, dryRun) {
+function runInstallViaNode(selectedTargets, dryRun, communicationLang = 'en') {
   const fallbackRoot = path.join(__dirname, '..');
   const pkgRoot = resolveViepilotPackageRoot(fallbackRoot) || fallbackRoot;
   const profile = selectedTargets[0] || 'claude-code';
@@ -269,6 +295,7 @@ function runInstallViaNode(selectedTargets, dryRun) {
     ...process.env,
     VIEPILOT_AUTO_YES: '1',
     VIEPILOT_INSTALL_PROFILE: profile,
+    VIEPILOT_COMM_LANG: communicationLang,
   };
   const wantPathShim = env.VIEPILOT_ADD_PATH === '1';
 
@@ -328,8 +355,14 @@ async function installCommand(rawArgs) {
     }
   }
 
+  let communicationLang = 'en';
+  if (!options.yes) {
+    communicationLang = await interactiveLanguageSelection();
+  }
+
   console.log(`\nSelected targets: ${selectedTargets.join(', ')}`);
-  const run = runInstallViaNode(selectedTargets, options.dryRun);
+  console.log(`Communication language: ${communicationLang}`);
+  const run = runInstallViaNode(selectedTargets, options.dryRun, communicationLang);
   const results = selectedTargets.map((target) => ({
     ok: run.ok,
     target,

package/lib/viepilot-install.cjs

@@ -29,6 +29,7 @@ function normalizeInstallEnv(envSource = process.env) {
     profile: envSource.VIEPILOT_INSTALL_PROFILE || 'claude-code',
     addPath: envSource.VIEPILOT_ADD_PATH === '1',
     symlinkSkills: envSource.VIEPILOT_SYMLINK_SKILLS === '1',
+    communicationLang: envSource.VIEPILOT_COMM_LANG || 'en',
   };
 }
 
@@ -241,9 +242,10 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
     });
   }
 
-  // ENH-032: prompt for language config at end of install
+  // ENH-032 / ENH-078: write selected communication language; lang chosen interactively in CLI
   steps.push({
     kind: 'language_config_prompt',
+    communicationLang: env.communicationLang,
     autoYes: env.autoYes,
     home,
   });
@@ -519,13 +521,13 @@ function applyInstallPlan(plan, options = {}) {
           break;
         }
         case 'language_config_prompt': {
+          const commLang = step.communicationLang ?? 'en';
           if (dryRun) {
-            logs.push(`[dry-run] language_config_prompt: would write ~/.viepilot/config.json with communication=en, document=en`);
+            logs.push(`[dry-run] language_config_prompt: would write ~/.viepilot/config.json with communication=${commLang}, 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)`);
+          writeConfig({ language: { communication: commLang, document: 'en' } }, step.home);
+          logs.push(`language_config_prompt: wrote ${step.home}/.viepilot/config.json (communication=${commLang}, document=en)`);
           break;
         }
         default:

package/package.json

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

package/workflows/crystallize.md

@@ -238,6 +238,36 @@ Store all metadata for template generation.
 >
 > Ask: "Continue? (y/n)" — abort if n.
 
+**Initial brownfield entry gate (BUG-025) — auto-detected only (no explicit `--brownfield` flag):**
+
+When brownfield was triggered automatically (not via `--brownfield`), present the mode-selection choice **before** running the scanner:
+
+> **Claude Code (terminal) — REQUIRED:** Call `AskUserQuestion` tool. Only fall back to text menu if the tool errors or is unavailable. AUQ spec:
+>   - question: "No brainstorm session found — this looks like an existing project. How would you like to proceed?"
+>   - header: "Brownfield Mode Detected"
+>   - options:
+>     - label: "Proceed with Brownfield Mode (Recommended)"
+>       description: "Scan codebase across 12 signal categories → auto-generate .viepilot/ artifacts"
+>     - label: "Run brainstorm first → /vp-brainstorm"
+>       description: "Capture vision/scope manually, then run /vp-crystallize to convert"
+>     - label: "Cancel"
+>       description: "Exit without changes"
+>   - multiSelect: false
+>
+> **Cursor / Codex / Antigravity / other:** use text menu below:
+> ```
+> No brainstorm session found — existing project detected.
+> 1. Proceed with Brownfield Mode — scan across 12 signal categories → generate .viepilot/ artifacts
+> 2. Run brainstorm first — /vp-brainstorm to capture vision/scope, then /vp-crystallize
+> 3. Cancel — exit without changes
+> Which would you like? (1 / 2 / 3)
+> ```
+>
+> **On selection:**
+> - "Proceed with Brownfield Mode" / "1" → continue to scanner below
+> - "Run brainstorm first" / "2" → print: "Run `/vp-brainstorm` to capture project vision, then `/vp-crystallize` to generate .viepilot/ artifacts." and exit
+> - "Cancel" / "3" → exit without changes
+
 **When brownfield mode is active:**
 1. Run the full 12-category codebase scanner (Signal Categories 1–12 below).
 2. Produce a structured **Scan Report** (see schema at end of this step).