auq-mcp-server 1.2.9 → 1.3.1

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.
+### 🌐 Question Set Rejection Support
 
-### 💡 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.
-
-**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
 
@@ -215,14 +204,6 @@ We now have **official OpenCode plugin support**! We support OpenCode because Op
 
 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
-```
-
 #### Configuration
 
 Add to `opencode.json`:
@@ -233,7 +214,6 @@ Add to `opencode.json`:
 }
 ```
 
-
 ---
 
 ## 💻 Usage

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "auq-mcp-server",
-    "version": "1.2.9",
+    "version": "1.3.1",
     "main": "dist/index.js",
     "bin": {
         "auq": "dist/bin/auq.js"
@@ -19,6 +19,7 @@
         "prepare": "npm run build",
         "postinstall": "node scripts/postinstall.cjs",
         "deploy": "node scripts/deploy.mjs",
+        "semantic-release": "semantic-release",
         "server": "node dist/src/server.js",
         "start": "tsx src/server.ts",
         "dev": "fastmcp dev src/server.ts",

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/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();
                 }
@@ -117,7 +118,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,6 +18,7 @@ export const StepperView = ({ onComplete, sessionId, sessionRequest, }) => {
     const [submitting, setSubmitting] = useState(false);
     const [showRejectionConfirm, setShowRejectionConfirm] = useState(false);
     const [elapsedSeconds, setElapsedSeconds] = useState(0);
+    const [focusContext, setFocusContext] = useState("option");
     const currentQuestion = sessionRequest.questions[currentQuestionIndex];
     const sessionCreatedAt = useMemo(() => {
         const parsed = Date.parse(sessionRequest.timestamp);
@@ -163,11 +164,23 @@ 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 && currentQuestionIndex > 0) {
+            setCurrentQuestionIndex((prev) => prev - 1);
+            return;
+        }
+        if (key.tab &&
+            !key.shift &&
+            currentQuestionIndex < sessionRequest.questions.length - 1) {
+            setCurrentQuestionIndex((prev) => 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 +202,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.1",
   "main": "dist/index.js",
   "bin": {
     "auq": "dist/bin/auq.js"
@@ -19,6 +19,7 @@
     "prepare": "npm run build",
     "postinstall": "node scripts/postinstall.cjs",
     "deploy": "node scripts/deploy.mjs",
+    "semantic-release": "semantic-release",
     "server": "node dist/src/server.js",
     "start": "tsx src/server.ts",
     "dev": "fastmcp dev src/server.ts",