auq-mcp-server 1.2.9 → 1.3.2

package/README.md

@@ -67,27 +67,20 @@ Recent AI workflows often use parallel sub-agents for concurrent coding. AUQ han
 AUQ is designed for the era of parallel multi-agent workflows, with several key advantages:
 
 ### 🚀 Non-Blocking Parallel Operation
+
 Unlike built-in ask tools that halt the entire AI workflow until you respond, AUQ **doesn't block the AI from continuing work**. Questions are queued asynchronously, allowing your AI assistants to keep coding while you review and answer questions at your own pace.
 
 ### 🎯 Multi-Agent Question Set Support
-**The killer feature**: AUQ can handle question sets from **multiple agents simultaneously**. In modern AI coding workflows, you often have several sub-agents working in parallel—each might need clarification on different aspects of your codebase. With AUQ:
+
+AUQ can handle question sets from **multiple agents simultaneously**. In modern AI coding workflows, you often have several sub-agents working in parallel—each might need clarification on different aspects of your codebase. With AUQ:
 
 - **No more screen switching** between different agent conversations
 - **Unified queue** for all agent questions, regardless of which AI tool they're coming from
 - **Sequential processing** of questions from multiple sources in one interface
 
-### 🌐 Cross-Platform Question Aggregation
-AUQ's **unified data origin** means you can answer questions from **different AI clients simultaneously**:
-- Claude Code questions
-- OpenCode questions
-- Cursor/MCP questions
-
-All appear in the **same CLI interface**, creating a single source of truth for all AI-agent questions across your entire development environment.
-
-### 💡 Perfect for Parallel Agent Workflows
-As AI coding moves toward sophisticated multi-agent systems, AUQ becomes essential. Instead of managing blocking questions across multiple agent screens, you get one streamlined interface that handles questions from your entire AI coding ecosystem—keeping your focus on the code, not the coordination.
+### 🌐 Question Set Rejection Support
 
-**TL;DR**: AUQ transforms AI-agent questions from blocking interruptions into a smooth, unified workflow that scales with your AI coding setup.
+**Skip irrelevant question sets entirely** - reject whole question batches that don't apply to your current context, saving time and maintaining focus on relevant AI-agent questions.
 
 ---
 
@@ -103,8 +96,6 @@ First, install the AUQ CLI tool:
 # Install globally
 npm install -g auq-mcp-server
 
-# Start the TUI
-auq
 ```
 
 ### Local Installation (Project-specific)
@@ -113,8 +104,6 @@ auq
 # Install in your project
 npm install auq-mcp-server
 
-# Start the TUI from project directory
-npx auq
 ```
 
 **Session Storage:**
@@ -128,7 +117,7 @@ npx auq
 
 AUQ supports multiple AI coding environments. Choose the one that fits your workflow:
 
-### Option A: MCP Server (Recommended for most users)
+### Option A: MCP Server
 
 ### Cursor
 
@@ -211,17 +200,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 
 ### Option B: Official OpenCode Plugin
 
-We now have **official OpenCode plugin support**! We support OpenCode because OpenCode's MCP server seems to have some limitations (timeout), so we created an OpenCode-specific plugin that works perfectly together with OpenCode.
-
-The OpenCode plugin allows OpenCode to call `auq ask` directly (without MCP), providing seamless integration with OpenCode's workflow.
-
-#### Installation
-
-```bash
-# Install both CLI and plugin
-npm install -g auq-mcp-server
-npm install -g @paulp-o/opencode-auq
-```
+**Direct integration** for OpenCode users. Bypasses MCP limitations by calling `auq ask` directly.
 
 #### Configuration
 
@@ -233,7 +212,6 @@ Add to `opencode.json`:
 }
 ```
 
-
 ---
 
 ## 💻 Usage
@@ -256,6 +234,53 @@ auq --version    # Show version
 auq --help       # Show help
 ```
 
+<details>
+<summary><strong>🔍 auq ask 명령어 상세 설명 (클릭하여 펼치기)</strong></summary>
+
+<br>
+
+`auq ask`는 AI 코딩 에이전트가 사용자에게 질문을 할 때 사용하는 핵심 명령어입니다.
+
+#### 기본 사용법
+
+```bash
+auq ask
+```
+
+이 명령어를 실행하면 대화형 터미널 인터페이스가 시작되어 AI 에이전트의 질문 세트를 기다립니다.
+
+#### 작동 방식
+
+1. **질문 수신 대기**: AI 에이전트(MCP 클라이언트)가 질문을 보내면 자동으로 표시됩니다
+2. **질문 세트 처리**: 여러 개의 연관된 질문을 하나의 세트로 묶어서 처리
+3. **사용자 응답**: 각 질문에 대해 답변을 입력하거나 건너뛸 수 있음
+4. **응답 전송**: 모든 답변을 완료하면 AI 에이전트로 결과가 전송됩니다
+
+#### 주요 특징
+
+- **비차단 방식**: AI가 질문을 보내는 동안에도 계속 작업할 수 있음
+- **다중 에이전트 지원**: 여러 AI 에이전트의 질문을 동시에 처리
+- **세션 관리**: 각 질문 세트는 독립적인 세션으로 관리됨
+- **타임아웃 처리**: 일정 시간 동안 응답이 없으면 세션이 자동 종료
+
+#### 예시 워크플로우
+
+```
+1. AI 에이전트가 복잡한 코드를 작성 중
+2. AI가 "이 함수의 반환 타입을 어떻게 할까요?"라고 질문
+3. auq ask가 실행되어 질문이 터미널에 표시
+4. 사용자가 답변 입력
+5. AI가 답변을 받아서 코드 작성 계속 진행
+```
+
+#### 문제 해결
+
+- **질문이 표시되지 않음**: MCP 서버가 제대로 실행되고 있는지 확인
+- **응답이 전송되지 않음**: 네트워크 연결과 세션 상태 확인
+- **세션이 중단됨**: 타임아웃 설정이나 세션 관리 확인
+
+</details>
+
 ---
 
 ### Manual session cleanup

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "auq-mcp-server",
-    "version": "1.2.9",
+    "version": "1.3.2",
     "main": "dist/index.js",
     "bin": {
         "auq": "dist/bin/auq.js"
@@ -19,6 +19,8 @@
         "prepare": "npm run build",
         "postinstall": "node scripts/postinstall.cjs",
         "deploy": "node scripts/deploy.mjs",
+        "release": "semantic-release",
+        "release:dry-run": "semantic-release --dry-run",
         "server": "node dist/src/server.js",
         "start": "tsx src/server.ts",
         "dev": "fastmcp dev src/server.ts",
@@ -58,17 +60,25 @@
     },
     "release": {
         "branches": [
-            "main"
+            "main",
+            "master"
         ],
         "plugins": [
             "@semantic-release/commit-analyzer",
             "@semantic-release/release-notes-generator",
+            [
+                "@semantic-release/changelog",
+                {
+                    "changelogFile": "CHANGELOG.md"
+                }
+            ],
             "@semantic-release/npm",
             "@semantic-release/github"
         ]
     },
     "devDependencies": {
         "@eslint/js": "^9.26.0",
+        "@semantic-release/changelog": "^6.0.3",
         "@tsconfig/node22": "^22.0.1",
         "@types/node": "^22.13.0",
         "@types/react": "^19.2.2",

package/dist/src/__tests__/schema-validation.test.js

@@ -3,7 +3,7 @@
  * Tests the most common edge cases to catch obvious bugs
  */
 import { describe, expect, it } from "vitest";
-import { QuestionSchema, QuestionsSchema, } from "../core/ask-user-questions.js";
+import { QuestionSchema, QuestionsSchema } from "../core/ask-user-questions.js";
 describe("Schema Validation - Edge Cases", () => {
     describe("Invalid Input (should reject)", () => {
         it("should reject missing title field", () => {

package/dist/src/server.js

@@ -4,16 +4,8 @@ import { AskUserQuestionsParametersSchema, createAskUserQuestionsCore, } from ".
 const askUserQuestionsCore = createAskUserQuestionsCore();
 const server = new FastMCP({
     name: "AskUserQuestions",
-    instructions: "This MCP server provides a tool to ask structured questions to the user. " +
-        "Use the ask_user_questions tool when you need to:\n" +
-        "- Gather user preferences or requirements during execution\n" +
-        "- Clarify ambiguous instructions or implementation choices\n" +
-        "- Get decisions on what direction to take\n" +
-        "- Offer choices to the user about multiple valid approaches\n\n" +
-        "The tool allows AI models to pause execution and gather direct user input through an interactive TUI, " +
-        "returning formatted responses for continued reasoning. " +
-        "Each question supports 2-4 multiple-choice options with descriptions, and users can always provide custom text input. " +
-        "Both single-select and multi-select modes are supported.",
+    instructions: "MCP server for asking users structured questions during AI execution. " +
+        "Use ask_user_questions tool to gather preferences, clarify requirements, or make implementation decisions without blocking AI workflow.",
     version: "0.1.17",
 });
 // Add the ask_user_questions tool

package/dist/src/session/file-watcher.js

@@ -6,7 +6,7 @@
  */
 import { EventEmitter } from "events";
 import { watch } from "fs";
-import { join } from "path";
+import { basename, join } from "path";
 import { fileExists } from "./utils.js";
 import { resolveSessionDirectory } from "./utils.js";
 /**
@@ -171,7 +171,7 @@ export class PromiseFileWatcher extends EventEmitter {
             if (!stats.isDirectory())
                 return;
             // Extract session ID from directory name
-            const sessionId = sessionPath.split("/").pop() ?? "";
+            const sessionId = basename(sessionPath);
             if (!sessionId)
                 return;
             // Verify it's a valid session (has request.json)

package/dist/src/shared/schemas.js

@@ -41,24 +41,10 @@ export const AskUserQuestionsParametersSchema = z.object({
         "options (2-4 choices with labels and descriptions), and multiSelect (boolean). " +
         "Mark one choice as recommended if possible."),
 });
-export const TOOL_DESCRIPTION = "Use this tool when you need to ask the user questions during execution. " +
-    "This allows you to:\n" +
-    "1. Gather user preferences or requirements\n" +
-    "2. Clarify ambiguous instructions\n" +
-    "3. Get decisions on implementation choices as you work\n" +
-    "4. Offer choices to the user about what direction to take\n\n" +
+export const TOOL_DESCRIPTION = "Ask users structured questions during execution to gather preferences, clarify requirements, or make implementation decisions.\n\n" +
     "FEATURES:\n" +
-    "- Ask 1-4 structured questions via an interactive terminal interface\n" +
-    "- Each question includes 2-4 multiple-choice options with explanatory descriptions\n" +
-    "- Users can always provide custom free-text input as an alternative to predefined options\n" +
-    "- Single-select mode (default): User picks ONE option or provides custom text\n" +
-    "- Multi-select mode (multiSelect: true): User can select MULTIPLE options\n\n" +
-    "USAGE NOTES:\n" +
-    "- Always provide a descriptive 'title' field (max 12 chars) for each question\n" +
-    "- Use multiSelect: true when choices are not mutually exclusive\n" +
-    "- Option labels should be concise (1-5 words)\n" +
-    "- Questions should end with a question mark\n" +
-    "- Don't include an 'Other' option - it's provided automatically\n" +
-    "- Mark one choice as recommended if possible.\n\n" +
-    "- If user seems not aware how to answer the question, inform them that they need to install the 'auq' cli tool.\n\n" +
-    "Returns a formatted summary of all questions and answers.";
+    "- Non-blocking: doesn't halt AI workflow\n" +
+    "- 1-4 questions with 2-4 options each\n" +
+    "- Single/multi-select modes\n" +
+    "- Custom text input always available\n\n" +
+    "Returns formatted responses for continued reasoning.";

package/dist/src/tui/components/ConfirmationDialog.js

@@ -1,7 +1,7 @@
 import { Box, Text, useInput } from "ink";
 import React, { useState } from "react";
 import { theme } from "../theme.js";
-import { MultiLineTextInput } from "./MultiLineTextInput.js";
+import { SingleLineTextInput } from "./SingleLineTextInput.js";
 /**
  * ConfirmationDialog shows a 3-option prompt for session rejection
  * Options: Reject & inform AI, Cancel, or Quit CLI
@@ -64,9 +64,9 @@ export const ConfirmationDialog = ({ message, onReject, onCancel, onQuit, }) =>
             React.createElement(Box, { marginBottom: 1 },
                 React.createElement(Text, { dimColor: true }, "(Optional - helps the AI improve)")),
             React.createElement(Box, { marginBottom: 1 },
-                React.createElement(MultiLineTextInput, { isFocused: true, onChange: setRejectionReason, onSubmit: handleReasonSubmit, placeholder: "Type your reason here...", value: rejectionReason })),
+                React.createElement(SingleLineTextInput, { isFocused: true, onChange: setRejectionReason, onSubmit: handleReasonSubmit, placeholder: "Type your reason here...", value: rejectionReason })),
             React.createElement(Box, { marginTop: 1 },
-                React.createElement(Text, { dimColor: true }, "Enter Submit | Shift+Enter Newline | Esc Skip"))));
+                React.createElement(Text, { dimColor: true }, "Enter Submit | Esc Skip"))));
     }
     // Step 1: Confirmation options
     return (React.createElement(Box, { borderColor: theme.borders.warning, borderStyle: "single", flexDirection: "column", padding: 1 },

package/dist/src/tui/components/Footer.js

@@ -16,25 +16,23 @@ export const Footer = ({ focusContext, multiSelect, isReviewScreen = false, cust
         }
         // Custom input focused
         if (focusContext === "custom-input") {
-            const hasContent = customInputValue.trim().length > 0;
-            const bindings = [
+            return [
                 { key: "↑↓", action: "Options" },
-                { key: "Tab", action: "Next" },
+                { key: "←→", action: "Cursor" },
+                { key: "Tab/S+Tab", action: "Questions" },
+                { key: "Enter", action: "Newline" },
+                { key: "Esc", action: "Reject" },
             ];
-            if (hasContent) {
-                bindings.push({ key: "Enter", action: "Submit" });
-            }
-            bindings.push({ key: "Shift+Enter", action: "Newline" }, { key: "Esc", action: "Reject" });
-            return bindings;
         }
         // Option focused
         if (focusContext === "option") {
             const bindings = [
                 { key: "↑↓", action: "Options" },
                 { key: "←→", action: "Questions" },
+                { key: "Tab/S+Tab", action: "Questions" },
             ];
             if (multiSelect) {
-                bindings.push({ key: "Space", action: "Toggle" }, { key: "Tab", action: "Submit" });
+                bindings.push({ key: "Space", action: "Toggle" });
             }
             else {
                 bindings.push({ key: "Enter", action: "Select" });

package/dist/src/tui/components/MultiLineTextInput.js

@@ -4,7 +4,7 @@ import { theme } from "../theme.js";
 /**
  * Multi-line text input component for Ink with cursor positioning
  * Supports left/right arrow keys for cursor movement
- * Shift+Enter for newlines, Enter to submit
+ * Enter for newlines, Tab to submit (portable across terminals)
  */
 export const MultiLineTextInput = ({ isFocused = true, onChange, onSubmit, placeholder = "Type your answer...", value, }) => {
     const [cursorPosition, setCursorPosition] = useState(value.length);
@@ -17,33 +17,22 @@ export const MultiLineTextInput = ({ isFocused = true, onChange, onSubmit, place
     useInput((input, key) => {
         if (!isFocused)
             return;
-        // Normalize Enter key sequences that may arrive as raw input ("\r"/"\n").
-        // Prevent accidental carriage return insertion which causes line overwrite in terminals.
-        if (input === "\r" || input === "\n") {
-            if (key.shift) {
-                const newValue = value.slice(0, cursorPosition) + "\n" + value.slice(cursorPosition);
-                onChange(newValue);
-                setCursorPosition(cursorPosition + 1);
-            }
-            else if (onSubmit) {
-                onSubmit();
-            }
+        // Tab: Submit (also triggers question navigation via parent)
+        if (key.tab && !key.shift) {
+            onSubmit?.();
+            return;
+        }
+        // Shift+Tab: Let parent handle for previous question navigation
+        if (key.tab && key.shift) {
             return;
         }
-        // Shift+Enter: Add newline
-        if (key.return && key.shift) {
+        // Enter: Always add newline (portable behavior)
+        if (input === "\r" || input === "\n" || key.return) {
             const newValue = value.slice(0, cursorPosition) + "\n" + value.slice(cursorPosition);
             onChange(newValue);
             setCursorPosition(cursorPosition + 1);
             return;
         }
-        // Enter: Submit (empty input allowed)
-        if (key.return) {
-            if (onSubmit) {
-                onSubmit();
-            }
-            return;
-        }
         // Left arrow: Move cursor left
         if (key.leftArrow) {
             setCursorPosition(Math.max(0, cursorPosition - 1));
@@ -75,13 +64,11 @@ export const MultiLineTextInput = ({ isFocused = true, onChange, onSubmit, place
             setCursorPosition(cursorPosition + 1);
         }
     }, { isActive: isFocused });
-    // Normalize any carriage returns that might already be present in value
     const normalizedValue = value.replace(/\r\n?/g, "\n");
     const hasContent = normalizedValue.length > 0;
     const lines = hasContent ? normalizedValue.split("\n") : [placeholder];
-    // Calculate which line and position the cursor is on
     const cursorLineIndex = normalizedValue.slice(0, cursorPosition).split("\n").length - 1;
-    const cursorLineStart = normalizedValue.split("\n").slice(0, cursorLineIndex).join("\n").length + (cursorLineIndex > 0 ? cursorLineIndex : 0);
+    const cursorLineStart = normalizedValue.lastIndexOf("\n", cursorPosition - 1) + 1;
     const cursorPositionInLine = cursorPosition - cursorLineStart;
     return (React.createElement(Box, { flexDirection: "column" }, lines.map((line, index) => {
         const isCursorLine = isFocused && index === cursorLineIndex && hasContent;

package/dist/src/tui/components/OptionsList.js

@@ -47,8 +47,9 @@ export const OptionsList = ({ isFocused, onSelect, options, selectedOption, show
                     onToggle?.(options[focusedIndex].label);
                 }
             }
-            if (key.return || key.tab) {
-                // Enter OR Tab: Advance to next question (don't toggle)
+            if (key.return) {
+                // Enter: Advance to next question (don't toggle)
+                // Note: Tab is handled globally in StepperView for question navigation
                 if (!isCustomInputFocused && onAdvance) {
                     onAdvance();
                 }
@@ -67,12 +68,7 @@ export const OptionsList = ({ isFocused, onSelect, options, selectedOption, show
                     onAdvance();
                 }
             }
-            if (key.tab) {
-                // Tab: Just advance (don't select)
-                if (onAdvance) {
-                    onAdvance();
-                }
-            }
+            // Tab is handled globally in StepperView for question navigation
         }
     }, { isActive: isFocused });
     return (React.createElement(Box, { flexDirection: "column" },
@@ -117,7 +113,7 @@ export const OptionsList = ({ isFocused, onSelect, options, selectedOption, show
                     customValue ? "●" : "○",
                     " Other (custom answer)"),
                 isCustomInputFocused && onCustomChange && (React.createElement(Box, { marginLeft: 2, marginTop: 0.5 },
-                    React.createElement(MultiLineTextInput, { isFocused: true, onChange: onCustomChange, onSubmit: onAdvance, placeholder: "Type your answer... (Shift+Enter for newline)", value: customValue }))),
+                    React.createElement(MultiLineTextInput, { isFocused: true, onChange: onCustomChange, onSubmit: onAdvance, placeholder: "Type your answer... (Enter for newline, Tab to submit)", value: customValue }))),
                 !isCustomInputFocused && customValue && (React.createElement(Box, { marginLeft: 2, marginTop: 0.5 },
                     React.createElement(Text, { dimColor: true }, customLines.map((line, idx) => (React.createElement(React.Fragment, { key: idx },
                         idx === 0 ? "❯ " : "  ",

package/dist/src/tui/components/QuestionDisplay.js

@@ -7,9 +7,12 @@ import { TabBar } from "./TabBar.js";
  * QuestionDisplay shows a single question with its options
  * Includes TabBar, question prompt, options list, and footer
  */
-export const QuestionDisplay = ({ currentQuestion, currentQuestionIndex, customAnswer = "", elapsedLabel, onChangeCustomAnswer, onSelectOption, questions, selectedOption, onAdvanceToNext, answers, onToggleOption, multiSelect, }) => {
-    // Track focus context for Footer component
+export const QuestionDisplay = ({ currentQuestion, currentQuestionIndex, customAnswer = "", elapsedLabel, onChangeCustomAnswer, onSelectOption, questions, selectedOption, onAdvanceToNext, answers, onToggleOption, multiSelect, onFocusContextChange, }) => {
     const [focusContext, setFocusContext] = useState("option");
+    const handleFocusContextChange = (context) => {
+        setFocusContext(context);
+        onFocusContextChange?.(context);
+    };
     // Handle option selection - clears custom answer only in single-select mode
     const handleSelectOption = (label) => {
         onSelectOption(label);
@@ -35,6 +38,6 @@ export const QuestionDisplay = ({ currentQuestion, currentQuestionIndex, customA
             React.createElement(Text, { dimColor: true },
                 "Elapsed ",
                 elapsedLabel)),
-        React.createElement(OptionsList, { customValue: customAnswer, isFocused: true, onAdvance: onAdvanceToNext, onCustomChange: handleCustomAnswerChange, onSelect: handleSelectOption, options: currentQuestion.options, selectedOption: selectedOption, showCustomInput: true, onToggle: onToggleOption, multiSelect: multiSelect, selectedOptions: answers.get(currentQuestionIndex)?.selectedOptions, onFocusContextChange: setFocusContext }),
+        React.createElement(OptionsList, { customValue: customAnswer, isFocused: true, onAdvance: onAdvanceToNext, onCustomChange: handleCustomAnswerChange, onSelect: handleSelectOption, options: currentQuestion.options, selectedOption: selectedOption, showCustomInput: true, onToggle: onToggleOption, multiSelect: multiSelect, selectedOptions: answers.get(currentQuestionIndex)?.selectedOptions, onFocusContextChange: handleFocusContextChange }),
         React.createElement(Footer, { focusContext: focusContext, multiSelect: multiSelect ?? false, customInputValue: customAnswer })));
 };

package/dist/src/tui/components/SingleLineTextInput.js

@@ -0,0 +1,59 @@
+import { Text, useInput } from "ink";
+import React, { useState } from "react";
+import { theme } from "../theme.js";
+export const SingleLineTextInput = ({ isFocused = true, onChange, onSubmit, placeholder = "Type here...", value, }) => {
+    const [cursorPosition, setCursorPosition] = useState(value.length);
+    React.useEffect(() => {
+        if (cursorPosition > value.length) {
+            setCursorPosition(value.length);
+        }
+    }, [value.length, cursorPosition]);
+    useInput((input, key) => {
+        if (!isFocused)
+            return;
+        if (key.return) {
+            onSubmit?.();
+            return;
+        }
+        if (key.leftArrow) {
+            setCursorPosition(Math.max(0, cursorPosition - 1));
+            return;
+        }
+        if (key.rightArrow) {
+            setCursorPosition(Math.min(value.length, cursorPosition + 1));
+            return;
+        }
+        if (key.backspace || key.delete) {
+            if (cursorPosition > 0) {
+                const newValue = value.slice(0, cursorPosition - 1) + value.slice(cursorPosition);
+                onChange(newValue);
+                setCursorPosition(cursorPosition - 1);
+            }
+            return;
+        }
+        if (input &&
+            !key.ctrl &&
+            !key.meta &&
+            !key.escape &&
+            !key.tab &&
+            input !== "\r" &&
+            input !== "\n") {
+            const newValue = value.slice(0, cursorPosition) + input + value.slice(cursorPosition);
+            onChange(newValue);
+            setCursorPosition(cursorPosition + 1);
+        }
+    }, { isActive: isFocused });
+    const hasContent = value.length > 0;
+    const displayText = hasContent ? value : placeholder;
+    if (hasContent && isFocused) {
+        const beforeCursor = value.slice(0, cursorPosition);
+        const afterCursor = value.slice(cursorPosition);
+        return (React.createElement(Text, null,
+            beforeCursor,
+            React.createElement(Text, { color: theme.colors.focused, dimColor: true }, "\u258C"),
+            afterCursor));
+    }
+    return (React.createElement(Text, { dimColor: !hasContent },
+        displayText,
+        isFocused && !hasContent && (React.createElement(Text, { color: theme.colors.focused, dimColor: true }, "\u258C"))));
+};

package/dist/src/tui/components/StepperView.js

@@ -18,7 +18,9 @@ export const StepperView = ({ onComplete, sessionId, sessionRequest, }) => {
     const [submitting, setSubmitting] = useState(false);
     const [showRejectionConfirm, setShowRejectionConfirm] = useState(false);
     const [elapsedSeconds, setElapsedSeconds] = useState(0);
-    const currentQuestion = sessionRequest.questions[currentQuestionIndex];
+    const [focusContext, setFocusContext] = useState("option");
+    const safeIndex = Math.min(currentQuestionIndex, sessionRequest.questions.length - 1);
+    const currentQuestion = sessionRequest.questions[safeIndex];
     const sessionCreatedAt = useMemo(() => {
         const parsed = Date.parse(sessionRequest.timestamp);
         return Number.isNaN(parsed) ? Date.now() : parsed;
@@ -163,11 +165,21 @@ export const StepperView = ({ onComplete, sessionId, sessionRequest, }) => {
             setShowRejectionConfirm(true);
             return;
         }
-        // Question navigation with arrow keys
-        if (key.leftArrow && currentQuestionIndex > 0) {
+        // Tab/Shift+Tab: Global question navigation (works in all contexts)
+        if (key.tab && key.shift) {
+            setCurrentQuestionIndex((prev) => Math.max(0, prev - 1));
+            return;
+        }
+        if (key.tab && !key.shift) {
+            setCurrentQuestionIndex((prev) => Math.min(sessionRequest.questions.length - 1, prev + 1));
+            return;
+        }
+        const shouldNavigate = focusContext !== "custom-input";
+        if (shouldNavigate && key.leftArrow && currentQuestionIndex > 0) {
             setCurrentQuestionIndex((prev) => prev - 1);
         }
-        if (key.rightArrow &&
+        if (shouldNavigate &&
+            key.rightArrow &&
             currentQuestionIndex < sessionRequest.questions.length - 1) {
             setCurrentQuestionIndex((prev) => prev + 1);
         }
@@ -189,5 +201,5 @@ export const StepperView = ({ onComplete, sessionId, sessionRequest, }) => {
         return (React.createElement(ReviewScreen, { answers: answers, elapsedLabel: elapsedLabel, onConfirm: handleConfirm, onGoBack: handleGoBack, questions: sessionRequest.questions, sessionId: sessionId }));
     }
     // Show question display (default)
-    return (React.createElement(QuestionDisplay, { currentQuestion: currentQuestion, currentQuestionIndex: currentQuestionIndex, customAnswer: currentAnswer?.customText, elapsedLabel: elapsedLabel, onAdvanceToNext: handleAdvanceToNext, onChangeCustomAnswer: handleChangeCustomAnswer, onSelectOption: handleSelectOption, onToggleOption: handleToggleOption, multiSelect: currentQuestion.multiSelect, questions: sessionRequest.questions, selectedOption: currentAnswer?.selectedOption, answers: answers }));
+    return (React.createElement(QuestionDisplay, { currentQuestion: currentQuestion, currentQuestionIndex: currentQuestionIndex, customAnswer: currentAnswer?.customText, elapsedLabel: elapsedLabel, onAdvanceToNext: handleAdvanceToNext, onChangeCustomAnswer: handleChangeCustomAnswer, onSelectOption: handleSelectOption, onToggleOption: handleToggleOption, multiSelect: currentQuestion.multiSelect, questions: sessionRequest.questions, selectedOption: currentAnswer?.selectedOption, answers: answers, onFocusContextChange: setFocusContext }));
 };

package/dist/src/tui/components/WaitingScreen.js

@@ -19,7 +19,7 @@ export const WaitingScreen = ({ queueCount }) => {
     }, [startTime]);
     // Handle 'q' key to quit
     useInput((input, key) => {
-        if (input === 'q') {
+        if (input === "q") {
             process.exit(0);
         }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auq-mcp-server",
-  "version": "1.2.9",
+  "version": "1.3.2",
   "main": "dist/index.js",
   "bin": {
     "auq": "dist/bin/auq.js"
@@ -19,6 +19,8 @@
     "prepare": "npm run build",
     "postinstall": "node scripts/postinstall.cjs",
     "deploy": "node scripts/deploy.mjs",
+    "release": "semantic-release",
+    "release:dry-run": "semantic-release --dry-run",
     "server": "node dist/src/server.js",
     "start": "tsx src/server.ts",
     "dev": "fastmcp dev src/server.ts",
@@ -58,17 +60,25 @@
   },
   "release": {
     "branches": [
-      "main"
+      "main",
+      "master"
     ],
     "plugins": [
       "@semantic-release/commit-analyzer",
       "@semantic-release/release-notes-generator",
+      [
+        "@semantic-release/changelog",
+        {
+          "changelogFile": "CHANGELOG.md"
+        }
+      ],
       "@semantic-release/npm",
       "@semantic-release/github"
     ]
   },
   "devDependencies": {
     "@eslint/js": "^9.26.0",
+    "@semantic-release/changelog": "^6.0.3",
     "@tsconfig/node22": "^22.0.1",
     "@types/node": "^22.13.0",
     "@types/react": "^19.2.2",