auq-mcp-server 1.3.1 → 1.3.2

package/README.md

@@ -200,9 +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.
+**Direct integration** for OpenCode users. Bypasses MCP limitations by calling `auq ask` directly.
 
 #### Configuration
 
@@ -236,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.3.1",
+    "version": "1.3.2",
     "main": "dist/index.js",
     "bin": {
         "auq": "dist/bin/auq.js"
@@ -19,7 +19,8 @@
         "prepare": "npm run build",
         "postinstall": "node scripts/postinstall.cjs",
         "deploy": "node scripts/deploy.mjs",
-        "semantic-release": "semantic-release",
+        "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",
@@ -59,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/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/OptionsList.js

@@ -68,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" },

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

@@ -19,7 +19,8 @@ export const StepperView = ({ onComplete, sessionId, sessionRequest, }) => {
     const [showRejectionConfirm, setShowRejectionConfirm] = useState(false);
     const [elapsedSeconds, setElapsedSeconds] = useState(0);
     const [focusContext, setFocusContext] = useState("option");
-    const currentQuestion = sessionRequest.questions[currentQuestionIndex];
+    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;
@@ -165,14 +166,12 @@ export const StepperView = ({ onComplete, sessionId, sessionRequest, }) => {
             return;
         }
         // Tab/Shift+Tab: Global question navigation (works in all contexts)
-        if (key.tab && key.shift && currentQuestionIndex > 0) {
-            setCurrentQuestionIndex((prev) => prev - 1);
+        if (key.tab && key.shift) {
+            setCurrentQuestionIndex((prev) => Math.max(0, prev - 1));
             return;
         }
-        if (key.tab &&
-            !key.shift &&
-            currentQuestionIndex < sessionRequest.questions.length - 1) {
-            setCurrentQuestionIndex((prev) => prev + 1);
+        if (key.tab && !key.shift) {
+            setCurrentQuestionIndex((prev) => Math.min(sessionRequest.questions.length - 1, prev + 1));
             return;
         }
         const shouldNavigate = focusContext !== "custom-input";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auq-mcp-server",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "main": "dist/index.js",
   "bin": {
     "auq": "dist/bin/auq.js"
@@ -19,7 +19,8 @@
     "prepare": "npm run build",
     "postinstall": "node scripts/postinstall.cjs",
     "deploy": "node scripts/deploy.mjs",
-    "semantic-release": "semantic-release",
+    "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",
@@ -59,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",