viepilot 2.22.0 → 2.23.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.23.0] - 2026-04-18
+
+### Added
+- **ENH-059**: AskUserQuestion ToolSearch preload — all vp-* skills and workflow files on Claude Code adapter now instruct the model to call `ToolSearch { query: "select:AskUserQuestion" }` before the first interactive prompt, preventing deferred-tool fallback to text menus
+  - 5 SKILL.md files updated: `vp-request`, `vp-evolve`, `vp-auto`, `vp-brainstorm`, `vp-crystallize`
+  - 3 workflow files updated: `workflows/request.md`, `workflows/evolve.md`, `workflows/autonomous.md`
+  - `vp-auto/SKILL.md` now has a full AUQ adapter compatibility section
+
+## [2.22.1] - 2026-04-18
+
+### Fixed
+- **BUG-015**: `copilot` adapter missing from `bin/viepilot.cjs` CLI — `TARGETS` array and `printHelp()` text now include `copilot`; `viepilot --list-targets` shows GitHub Copilot; `viepilot install --target copilot` no longer fails with "Unknown target"
+
 ## [2.22.0] - 2026-04-18
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 **Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**
 
-[![Version](https://img.shields.io/badge/version-2.22.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.23.0-blue.svg)](CHANGELOG.md)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![Skills](https://img.shields.io/badge/skills-17-purple.svg)](#skills-reference)
 [![Workflows](https://img.shields.io/badge/workflows-13-orange.svg)](#workflows)

package/bin/viepilot.cjs

@@ -23,6 +23,7 @@ const TARGETS = [
   { id: 'cursor-ide',   label: 'Cursor IDE' },
   { id: 'antigravity',  label: adapterMap['antigravity'].name },
   { id: 'codex',        label: adapterMap['codex'].name },
+  { id: 'copilot',      label: adapterMap['copilot'].name },
 ];
 
 function printHelp() {
@@ -36,14 +37,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, antigravity, codex
+  --target <id|id,id|all>   Target profile(s): claude-code, cursor-agent, cursor-ide, antigravity, codex, copilot
   --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-*; antigravity: ~/.antigravity/skills/vp-*; codex: ~/.codex/skills/vp-*)
+  --target <id|id,id|all>   Remove assets (claude-code: ~/.claude/skills/vp-*; cursor-*: ~/.cursor/skills/vp-*; antigravity: ~/.antigravity/skills/vp-*; codex: ~/.codex/skills/vp-*; copilot: ~/.config/gh-copilot/skills/vp-*)
   --yes                     Non-interactive mode (skip confirmations)
   --dry-run                 Print actions only, do not remove files
 `);

package/package.json

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

package/skills/vp-auto/SKILL.md

@@ -242,6 +242,22 @@ At any control point, offer:
 Display progress summary on stop.
 </process>
 
+## Adapter Compatibility
+
+### AskUserQuestion Tool (ENH-059)
+Control-point prompts use `AskUserQuestion` on Claude Code (terminal).
+
+| Adapter | Interactive Prompts | Notes |
+|---------|---------------------|-------|
+| Claude Code (terminal) | ✅ `AskUserQuestion` — **REQUIRED** at control points | Preload schema via ToolSearch first |
+| Cursor / Codex / Copilot / Antigravity | ❌ Text fallback | Plain numbered list |
+
+**Claude Code (terminal) — AUQ preload required (ENH-059):**
+Before the first interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"` to load the deferred tool schema. Only after `ToolSearch` succeeds can `AskUserQuestion` be invoked. If `ToolSearch` returns an error, fall back to plain-text numbered list for that session.
+
+**Prompts using AskUserQuestion in this skill:**
+- Control point decisions (retry / skip / rollback / stop — Step 7)
+
 <success_criteria>
 - [ ] Phases executed in dependency order
 - [ ] Tasks tracked with git tags

package/skills/vp-brainstorm/SKILL.md

@@ -135,7 +135,10 @@ This skill uses adapter-aware interactive prompts. Behavior depends on your adap
 | Antigravity (native agent) | ❌ Text fallback | Artifact model, no raw tool calls |
 | GitHub Copilot | ✅ `/skill-name` in Chat | Via `.agent.md` custom agent; AUQ not available — text fallback |
 
-When `AskUserQuestion` is not available, the skill automatically falls back to
+**Claude Code (terminal) — AUQ preload required (ENH-059):**
+Before the first interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"` to load the deferred tool schema. Only after `ToolSearch` succeeds can `AskUserQuestion` be invoked. If `ToolSearch` returns an error, fall back to plain-text numbered list for that session.
+
+When `AskUserQuestion` is not available on other adapters, the skill automatically falls back to
 plain-text numbered list prompts — no configuration required.
 
 **Prompts using AskUserQuestion in this skill:**

package/skills/vp-crystallize/SKILL.md

@@ -291,7 +291,10 @@ This skill uses adapter-aware interactive prompts. Behavior depends on your adap
 | Antigravity (native agent) | ❌ Text fallback | Artifact model, no raw tool calls |
 | GitHub Copilot | ✅ `/skill-name` in Chat | Via `.agent.md` custom agent; AUQ not available — text fallback |
 
-When `AskUserQuestion` is not available, the skill automatically falls back to
+**Claude Code (terminal) — AUQ preload required (ENH-059):**
+Before the first interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"` to load the deferred tool schema. Only after `ToolSearch` succeeds can `AskUserQuestion` be invoked. If `ToolSearch` returns an error, fall back to plain-text numbered list for that session.
+
+When `AskUserQuestion` is not available on other adapters, the skill automatically falls back to
 plain-text numbered list prompts — no configuration required.
 
 **Prompts using AskUserQuestion in this skill:**

package/skills/vp-evolve/SKILL.md

@@ -204,7 +204,8 @@ Next action: /vp-auto --from {new_phase}
 | Antigravity (native agent) | ❌ Text fallback | Artifact model, no raw tool calls |
 | GitHub Copilot | ✅ `/skill-name` in Chat | Via `.agent.md` custom agent; AUQ not available — text fallback |
 
-**Claude Code (terminal):** Always call `AskUserQuestion` first. Only fall back to the plain-text menu if the tool returns an error or is unavailable.
+**Claude Code (terminal) — AUQ preload required (ENH-059):**
+Before the first interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"` to load the deferred tool schema. Only after `ToolSearch` succeeds can `AskUserQuestion` be invoked. If `ToolSearch` returns an error, fall back to plain-text numbered list for that session.
 
 **Prompts using AskUserQuestion in this skill:**
 - Evolve mode selection (Step 2 — Add Feature / New Milestone / Refactor)

package/skills/vp-request/SKILL.md

@@ -293,7 +293,10 @@ This skill uses adapter-aware interactive prompts. Behavior depends on your adap
 | Antigravity (native agent) | ❌ Text fallback | Artifact model, no raw tool calls |
 | GitHub Copilot | ✅ `/skill-name` in Chat | Via `.agent.md` custom agent; AUQ not available — text fallback |
 
-When `AskUserQuestion` is not available, the skill automatically falls back to
+**Claude Code (terminal) — AUQ preload required (ENH-059):**
+Before the first interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"` to load the deferred tool schema. Only after `ToolSearch` succeeds can `AskUserQuestion` be invoked. If `ToolSearch` returns an error, fall back to plain-text numbered list for that session.
+
+When `AskUserQuestion` is not available on other adapters, the skill automatically falls back to
 plain-text numbered list prompts — no configuration required.
 
 **Prompts using AskUserQuestion in this skill:**

package/workflows/autonomous.md

@@ -39,6 +39,8 @@ See `agents/` directory for full agent specifications.
 
 <process>
 
+> **AUQ preload — Claude Code adapter (ENH-059):** At session start, before any interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"` to load the deferred schema. Required on Claude Code (terminal). Skip only if `ToolSearch` returns an error → use text fallback for that session.
+
 <step name="initialize">
 ## 1. Initialize
 

package/workflows/evolve.md

@@ -26,6 +26,8 @@ Upgrade or expand the project: add features, start a new milestone, or refactor.
 
 <process>
 
+> **AUQ preload — Claude Code adapter (ENH-059):** At session start, before any interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"` to load the deferred schema. Required on Claude Code (terminal). Skip only if `ToolSearch` returns an error → use text fallback for that session.
+
 <step name="detect_state">
 ## 1. Detect Current State
 

package/workflows/request.md

@@ -26,6 +26,8 @@ Create and manage project requests: bugs, features, enhancements, tech debt, and
 
 <process>
 
+> **AUQ preload — Claude Code adapter (ENH-059):** At session start, before any interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"` to load the deferred schema. Required on Claude Code (terminal). Skip only if `ToolSearch` returns an error → use text fallback for that session.
+
 <step name="init">
 ## 1. Initialize