viepilot 2.45.3 → 2.45.4

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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/package.json

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