instar 0.12.3 → 0.12.4

package/.claude/skills/setup-wizard/skill.md

@@ -19,16 +19,31 @@ You are running the **instar setup wizard**. Your job is to walk the user throug
 
 The only exception is when the user explicitly asks "what command do I run?" or "show me the CLI."
 
+## CRITICAL: NEVER Use AskUserQuestion
+
+**The `AskUserQuestion` tool is BANNED from this wizard.** Do not use it at any step, for any reason. Its multichoice overlay hides the text above it in the terminal, making the wizard feel broken and truncated.
+
+Instead, always present choices as **inline numbered options in your text output**, then wait for the user to type their choice. Example:
+
+> How much initiative should the agent take?
+>
+> 1. Guided — follows your lead, confirms before acting
+> 2. Proactive — takes initiative, asks when uncertain
+> 3. Fully autonomous — owns outcomes end-to-end
+>
+> Type a number or describe what you'd prefer.
+
+This keeps all context visible. The user types "1", "2", "guided", or a free-text answer.
+
 ## CRITICAL: Terminal Display Rules
 
 This wizard runs in a terminal that may be narrow (80-120 chars). Long text gets **truncated and cut off**, making the wizard feel broken. Follow these rules strictly:
 
 1. **Keep paragraphs to 2-3 sentences max.** Break long explanations into multiple short paragraphs.
 2. **Never write a sentence longer than ~100 characters.** Break long sentences into two.
-3. **Put details in question descriptions**, not in free text above the question. The AskUserQuestion option descriptions render properly; long text above the question gets cut off.
-4. **Use bullet points** instead of dense paragraphs for explanations.
-5. **Avoid parenthetical asides** — they make sentences too long. Use a separate sentence instead.
-6. **When reassuring the user** (e.g., "you can change this later"), keep it to ONE short sentence. Don't elaborate.
+3. **Use bullet points** instead of dense paragraphs for explanations.
+4. **Avoid parenthetical asides** — they make sentences too long. Use a separate sentence instead.
+5. **When reassuring the user** (e.g., "you can change this later"), keep it to ONE short sentence. Don't elaborate.
 
 **Bad** (gets truncated):
 > Everything we set up here is just a starting point. The agent's identity, autonomy level, communication style — all of it lives in simple markdown and config files in your project's .instar/ directory. You can edit them anytime, or even just tell the agent to adjust itself.
@@ -561,7 +576,7 @@ Ask conversationally — not as a form, but as a getting-to-know-you:
   - **Proactive** — Takes initiative on obvious next steps. Asks when uncertain.
   - **Fully autonomous** — Owns outcomes end-to-end. Asks only when blocked.
 
-Before presenting this question, say ONE short sentence like: "You can always change this later." Do NOT write a long paragraph reassuring them. Put the descriptions in the AskUserQuestion option descriptions, not in free text.
+Before presenting this question, say ONE short sentence like: "You can always change this later." Do NOT write a long paragraph reassuring them. Present these as inline numbered options in your text — never use AskUserQuestion.
 
 ### Step 2c: Learn About the Agent
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "0.12.3",
+  "version": "0.12.4",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-03-03T18:00:12.103Z",
-  "instarVersion": "0.12.3",
+  "generatedAt": "2026-03-03T18:10:21.922Z",
+  "instarVersion": "0.12.4",
   "entryCount": 165,
   "entries": {
     "hook:session-start": {
@@ -295,7 +295,7 @@
       "type": "skill",
       "domain": "skills",
       "sourcePath": ".claude/skills/setup-wizard/skill.md",
-      "contentHash": "b2fde46d780510726cc2e3d7d3c5617fd710d4941f0b44ec1b474f9884801cbb",
+      "contentHash": "3a6c862351f559993cac82ec6da668a2118ea5737c1f92b9f4019beb5398f564",
       "since": "2025-01-01"
     },
     "route-group:health": {

package/upgrades/0.12.4.md

@@ -0,0 +1,19 @@
+# Upgrade Guide — v0.12.4
+
+<!-- bump: patch -->
+
+## What Changed
+
+`AskUserQuestion` is now completely banned from the setup wizard. A new `## CRITICAL: NEVER Use AskUserQuestion` section at the top of the skill prohibits its use at any step. All choice points now use inline numbered text options with typed user responses.
+
+The previous fix (v0.12.3) only addressed Entry Point B. This fix applies the same pattern globally — every step that presents options now uses inline numbered text instead of the multichoice overlay.
+
+## What to Tell Your User
+
+- **Setup wizard improvement**: "All wizard choices now show inline instead of in popup menus. No more hidden or truncated text."
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Overlay-free wizard | Automatic — just run `npx instar` |