@atlashub/smartstack-cli 3.51.0 → 3.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "3.51.0",
+  "version": "3.52.0",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",

package/templates/agents/gitflow/init.md

@@ -95,188 +95,104 @@ Parse the report to extract:
 
 ---
 
-## STEP 2: ASK USER (4 MANDATORY QUESTIONS)
-
-⛔ EXECUTION RULES FOR STEP 2:
-- Each question = ONE separate AskUserQuestion call
-- NEVER combine multiple questions into a single AskUserQuestion
-- NEVER skip a question, even if a default seems obvious
-- ALL 4 variables must be set by explicit user response before proceeding
-
-> **Reconfigure mode:** When `EXISTING_GITFLOW=true` and user chose "Reconfigure", show existing values as "(Current)" recommended options in each question. This avoids forcing the user to re-enter everything.
+## STEP 2: ASK USER — MANDATORY INTERACTIVE QUESTIONS
+
+╔══════════════════════════════════════════════════════════════════════════╗
+║  MANDATORY TOOL CALL REQUIREMENT                                        ║
+║                                                                          ║
+║  You MUST call the AskUserQuestion tool AT LEAST 3 TIMES in this step.  ║
+║  (4 times if URL was not provided in the command.)                       ║
+║                                                                          ║
+║  Each call = ONE question. Wait for the user's response before asking   ║
+║  the next question.                                                      ║
+║                                                                          ║
+║  You are FORBIDDEN from:                                                 ║
+║  - Deriving values from the URL or environment instead of asking        ║
+║  - Deciding what the user "would probably choose"                        ║
+║  - Proceeding to step 3 without having received user responses          ║
+║  - Using detected/inferred values as final values without user confirm  ║
+║                                                                          ║
+║  Auto-detected values from step 1 are SUGGESTIONS for the options,      ║
+║  NOT answers. The user MUST confirm or override each one.               ║
+╚══════════════════════════════════════════════════════════════════════════╝
+
+> **Reconfigure mode:** When `EXISTING_GITFLOW=true` and user chose "Reconfigure", show existing values as "(Current)" recommended options in each question.
 
 ### 2a. Repository URL
 
-**If user provided a URL in the command (starts with `https://` or `git@`), use it directly.**
+**If user provided a URL in the command (starts with `https://` or `git@`), use it directly. Skip to 2b.**
 
-Otherwise ask:
+Otherwise, CALL the AskUserQuestion tool NOW with:
+- header: "Repository"
+- question: "Repository URL? (detected: {DETECTED_URL})"
+- options: Use detected URL (Recommended) / Enter GitHub URL / Enter Azure DevOps URL / Local only
+- **If user selects a custom option, CALL AskUserQuestion again for the actual URL.**
+- Store the result as `{REPO_URL}`.
 
-**Fresh init (no existing config):**
-```json
-{
-  "questions": [{
-    "question": "Repository URL? (detected: {DETECTED_URL})",
-    "header": "Repository",
-    "options": [
-      {"label": "Use detected URL (Recommended)", "description": "{DETECTED_URL}"},
-      {"label": "Enter GitHub URL", "description": "https://github.com/org/repo.git"},
-      {"label": "Enter Azure DevOps URL", "description": "https://dev.azure.com/org/project/_git/repo"},
-      {"label": "Local only (no remote)", "description": "Initialize without remote"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+### 2b. Root Folder — CALL AskUserQuestion NOW
 
-**Reconfigure mode (existing config):**
-```json
-{
-  "questions": [{
-    "question": "Repository URL? (current: {EXISTING_URL})",
-    "header": "Repository",
-    "options": [
-      {"label": "Keep current (Recommended)", "description": "{EXISTING_URL}"},
-      {"label": "Enter GitHub URL", "description": "https://github.com/org/repo.git"},
-      {"label": "Enter Azure DevOps URL", "description": "https://dev.azure.com/org/project/_git/repo"},
-      {"label": "Local only (no remote)", "description": "Initialize without remote"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+DO NOT SKIP THIS. DO NOT auto-derive from the URL.
 
-**If user selects a custom option, ask follow-up for the actual URL.**
+CALL the AskUserQuestion tool with:
+- header: "Location"
+- question: "Root folder for this project? (worktrees will be created here)"
+- options: Use parent folder (Recommended): "{PARENT_DIR}/" / Use current folder: "{CURRENT_DIR}/" / Custom path
+- In reconfigure mode: add "Keep current" option with `{EXISTING_ROOT}`
+- **If user selects "Custom path", CALL AskUserQuestion again for the actual path.**
 
-### 2b. Root Folder
+WAIT for the user's response. Store as `{PROJECT_BASE}`.
 
-**CRITICAL for WSL: Normalize the path for the current platform.**
+After getting the response, normalize the path:
+- On WSL: translate Windows paths to /mnt/ format
+- On Windows: ensure forward slashes
 
-**Fresh init:**
-```json
-{
-  "questions": [{
-    "question": "Root folder for this project? (worktrees will be created here)",
-    "header": "Location",
-    "options": [
-      {"label": "Use parent folder (Recommended)", "description": "{PARENT_DIR}/ - consistent with {SIBLING_COUNT} sibling project(s)"},
-      {"label": "Use current folder", "description": "{CURRENT_DIR}/ - will create subfolders here"},
-      {"label": "Custom path", "description": "Specify a different location"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+### 2c. Project Name — CALL AskUserQuestion NOW
 
-**Reconfigure mode:**
-```json
-{
-  "questions": [{
-    "question": "Root folder? (current: {EXISTING_ROOT})",
-    "header": "Location",
-    "options": [
-      {"label": "Keep current (Recommended)", "description": "{EXISTING_ROOT}"},
-      {"label": "Use parent folder", "description": "{PARENT_DIR}/"},
-      {"label": "Custom path", "description": "Specify a different location"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+DO NOT SKIP THIS. DO NOT auto-derive from the URL.
 
-**After getting the path, normalize it:**
-```bash
-# On WSL: translate Windows paths to /mnt/ format
-# On Windows: ensure forward slashes
-# Store the platform-normalized path as PROJECT_BASE
-```
+CALL the AskUserQuestion tool with:
+- header: "Project"
+- question: "Project name? (detected: {DETECTED_NAME})"
+- options: Use detected name (Recommended): "{DETECTED_NAME}" / Custom name
+- In reconfigure mode: add "Keep current" option with `{EXISTING_NAME}`
+- **If user selects "Custom name", CALL AskUserQuestion again for the actual name.**
 
-### 2c. Project Name
+WAIT for the user's response. Store as `{PROJECT_NAME}`.
 
-**Fresh init:**
-```json
-{
-  "questions": [{
-    "question": "Project name? (detected: {DETECTED_NAME})",
-    "header": "Project",
-    "options": [
-      {"label": "Use detected name (Recommended)", "description": "{DETECTED_NAME}"},
-      {"label": "Custom name", "description": "Specify a different project name"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+Then normalize name into variants (PascalCase.Dot, PascalCase, kebab-case, snake_case, Display Name).
 
-**Reconfigure mode:**
-```json
-{
-  "questions": [{
-    "question": "Project name? (current: {EXISTING_NAME})",
-    "header": "Project",
-    "options": [
-      {"label": "Keep current (Recommended)", "description": "{EXISTING_NAME}"},
-      {"label": "Custom name", "description": "Specify a different project name"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+### 2d. Worktree Mode — CALL AskUserQuestion NOW
 
-Normalize name into variants (PascalCase.Dot, PascalCase, kebab-case, snake_case, Display Name).
+DO NOT SKIP THIS. This question has been skipped in past sessions causing incorrect defaults.
 
-### 2d. Worktree Mode
+CALL the AskUserQuestion tool with:
+- header: "Worktrees"
+- question: "How should worktrees be organized?"
+- options: Organized (Recommended): "01-Main, 02-Develop, ..." / Simple: "main/, develop/, ..." / Disabled: "No worktrees, use git checkout"
+- In reconfigure mode: add "Keep current: {EXISTING_MODE}" option
 
-⛔ MANDATORY — this question is FREQUENTLY SKIPPED by accident. ALWAYS ask it.
+WAIT for the user's response. Store as `{WORKTREE_MODE}` ("organized", "simple", or "disabled").
 
-**Fresh init:**
-```json
-{
-  "questions": [{
-    "question": "How should worktrees be organized?",
-    "header": "Worktrees",
-    "options": [
-      {"label": "Organized (Recommended)", "description": "01-Main, 02-Develop, features/, releases/, hotfixes/"},
-      {"label": "Simple", "description": "main/, develop/, features/, releases/, hotfixes/"},
-      {"label": "Disabled", "description": "No worktrees, use git checkout (not recommended)"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
-
-**Reconfigure mode:**
-```json
-{
-  "questions": [{
-    "question": "How should worktrees be organized? (current: {EXISTING_MODE})",
-    "header": "Worktrees",
-    "options": [
-      {"label": "Keep current: {EXISTING_MODE} (Recommended)", "description": "No change to worktree structure"},
-      {"label": "Organized", "description": "01-Main, 02-Develop, features/, releases/, hotfixes/"},
-      {"label": "Simple", "description": "main/, develop/, features/, releases/, hotfixes/"},
-      {"label": "Disabled", "description": "No worktrees, use git checkout (not recommended)"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+---
 
-Store the result as `{WORKTREE_MODE}` ("organized", "simple", or "disabled").
+## GATE CHECK — SELF-VERIFICATION BEFORE STEP 3
 
----
+Before proceeding, verify your tool call history for this step:
 
-## GATE CHECK: Verify all 4 questions were answered
+**Count your AskUserQuestion calls in step 2. The minimum is:**
+- 3 calls if URL was provided in the command (2b + 2c + 2d)
+- 4 calls if URL was NOT provided (2a + 2b + 2c + 2d)
 
-⛔ BLOCKING — Do NOT proceed to step 3 until ALL variables are confirmed:
+**If your count is less than the minimum, STOP. You have skipped a question. Go back and ask it.**
 
-| Variable | Required | Source |
-|----------|----------|--------|
-| {REPO_URL} | ✅ | From command arg OR question 2a |
-| {PROJECT_BASE} | ✅ | From question 2b |
-| {PROJECT_NAME} | ✅ | From question 2c |
-| {WORKTREE_MODE} | ✅ | From question 2d — MUST be "organized", "simple", or "disabled" |
+All 4 variables MUST have been confirmed by the user (not auto-derived):
 
-If {WORKTREE_MODE} is not set, GO BACK and ask question 2d NOW.
+| Variable | Required | How to verify |
+|----------|----------|---------------|
+| {REPO_URL} | ✅ | From command arg OR user answered question 2a |
+| {PROJECT_BASE} | ✅ | User answered question 2b (NEVER auto-derived) |
+| {PROJECT_NAME} | ✅ | User answered question 2c (NEVER auto-derived) |
+| {WORKTREE_MODE} | ✅ | User answered question 2d (NEVER defaulted to "organized") |
 
 ---
 

package/templates/skills/gitflow/references/init-questions.md

@@ -1,10 +1,15 @@
 # MANDATORY User Questions for Init
 
-All questions must be asked in order. See step-init.md for context on when each is asked.
+╔══════════════════════════════════════════════════════════════════════════╗
+║  Every question below REQUIRES a call to the AskUserQuestion tool.      ║
+║  The YAML blocks are the EXACT parameters to pass to the tool.         ║
+║  NEVER substitute a tool call with auto-derived values.                ║
+║  NEVER combine questions — one AskUserQuestion call per question.      ║
+╚══════════════════════════════════════════════════════════════════════════╝
 
 ## Question 1: Repository URL
 
-**⛔ ALWAYS ask, even if URL was detected:**
+**CALL AskUserQuestion with these parameters (skip only if URL provided in command args):**
 
 ```yaml
 AskUserQuestion:
@@ -44,7 +49,7 @@ The user will type the actual URL via "Other". Then:
 
 ## Question 2: Root Folder
 
-**⛔ ALWAYS ask where to create THIS project's structure:**
+**CALL AskUserQuestion NOW — do NOT auto-derive from URL:**
 
 **If sibling projects exist, show where it fits:**
 
@@ -108,7 +113,7 @@ The user will type the actual path via "Other". Validate the path exists or can
 
 ## Question 3: Project Name
 
-**⛔ ALWAYS ask to confirm project name:**
+**CALL AskUserQuestion NOW — do NOT auto-derive from URL:**
 
 ```yaml
 AskUserQuestion:
@@ -170,8 +175,8 @@ AskUserQuestion:
 
 ## Question 5: Worktree Mode
 
-⛔ CRITICAL — This question is the MOST FREQUENTLY SKIPPED.
-It MUST be asked as a SEPARATE AskUserQuestion call. NEVER default silently.
+CALL AskUserQuestion NOW. This is the MOST FREQUENTLY SKIPPED question.
+Do NOT default to "organized". The user MUST explicitly choose.
 
 ```yaml
 AskUserQuestion:

package/templates/skills/gitflow/steps/step-init.md

@@ -14,17 +14,21 @@ Set up GitFlow configuration with bare repository, worktrees, and branches.
 
 ---
 
-## MANDATORY QUESTIONS
-
-**⛔ ALWAYS ask these 4 questions, even if values can be auto-detected.**
-**⛔ ALWAYS detect workspace context (step 2) to show sibling projects.**
-
-| Question | Variable | Auto-detect from |
-|----------|----------|------------------|
-| Repository URL | `{REPO_URL}` | `git remote get-url origin` |
-| Root folder | `{ROOT_FOLDER}` | Parent of current directory |
-| Project name | `{PROJECT_NAME}` | Repo name from URL or folder |
-| Worktree mode | `{WORKTREE_MODE}` | Default: organized |
+## MANDATORY INTERACTIVE QUESTIONS
+
+╔══════════════════════════════════════════════════════════════════════════╗
+║  You MUST call AskUserQuestion for EACH question below.                 ║
+║  Auto-detected values are SUGGESTIONS for option labels, NOT answers.  ║
+║  NEVER use a detected value as the final value without user confirm.   ║
+║  Minimum AskUserQuestion calls: 3 (if URL provided) or 4 (if not).    ║
+╚══════════════════════════════════════════════════════════════════════════╝
+
+| Question | Variable | Suggested from | MUST ASK? |
+|----------|----------|----------------|-----------|
+| Repository URL | `{REPO_URL}` | `git remote get-url origin` | YES (skip only if URL in command args) |
+| Root folder | `{ROOT_FOLDER}` | Parent of current directory | **ALWAYS YES** |
+| Project name | `{PROJECT_NAME}` | Repo name from URL or folder | **ALWAYS YES** |
+| Worktree mode | `{WORKTREE_MODE}` | None — no default | **ALWAYS YES** |
 
 **Multi-project principle:** Each repository has its OWN independent GitFlow config. Step 2 scans for sibling projects to provide context, not to share configuration.
 
@@ -60,15 +64,15 @@ See [references/init-questions.md](../references/init-questions.md) → **Questi
 
 See [references/init-questions.md](../references/init-questions.md) → **Question 1** for format and follow-up rules.
 
-### 5. Question: Root Folder
+### 5. Question: Root Folder — CALL AskUserQuestion
 
-**⛔ MUST ASK — even if parent folder was auto-detected.**
+**CALL AskUserQuestion NOW. Do NOT auto-derive from the URL or environment.**
 
 See [references/init-questions.md](../references/init-questions.md) → **Question 2** for format and follow-up rules.
 
-### 6. Question: Project Name
+### 6. Question: Project Name — CALL AskUserQuestion
 
-**⛔ MUST ASK — even if name was auto-detected.**
+**CALL AskUserQuestion NOW. Do NOT auto-derive from the URL or environment.**
 
 See [references/init-questions.md](../references/init-questions.md) → **Question 3** for format and follow-up rules.
 
@@ -83,12 +87,13 @@ See [references/init-name-normalization.md](../references/init-name-normalizatio
 4. Ask user to choose PRIMARY format
 5. Store all derived names in `PROJECT_VARIANTS`
 
-### 7. Question: Worktree Mode
+### 7. Question: Worktree Mode — CALL AskUserQuestion
 
-**⛔ MUST ASK — this determines the directory structure (step 8).**
+**CALL AskUserQuestion NOW. This question is the MOST FREQUENTLY SKIPPED.**
 
-⛔ BLOCKING: If you reach step 8 without having asked the worktree mode question
-and received an explicit user answer, STOP and ask it NOW.
+⛔ BLOCKING: If you reach step 8 without having called AskUserQuestion for
+worktree mode and received an explicit user answer, STOP and ask it NOW.
+Do NOT default to "organized". The user MUST choose.
 
 See [references/init-questions.md](../references/init-questions.md) → **Question 5** for options:
 - **Organized** (recommended): `01-Main/`, `02-Develop/`, `features/`, `releases/`, `hotfixes/`
@@ -200,7 +205,7 @@ Before completing init, verify:
 
 ## SUCCESS CRITERIA:
 
-- ✅ All 4 mandatory questions asked (URL, folder, name, worktree mode)
+- ✅ AskUserQuestion tool called at least 3 times (4 if URL not in command args)
 - ✅ Complete folder structure created
 - ✅ Both main and develop worktrees functional
 - ✅ Configuration file created