auq-mcp-server 2.0.0 → 2.1.0

package/README.md

@@ -62,6 +62,8 @@ First, install the **AUQ CLI**:
 bun add -g auq-mcp-server
 ```
 
+This serves as the 'answering interface' for you, the human.
+
 _**Note:** Other package managers (npm, pnpm..) also work but not recommended._
 
 <details><summary>Local (Project-specific) Installation</summary>
@@ -210,6 +212,17 @@ Whenever you need clarification on what you are working on, never guess, and cal
 
 When the AI asks questions, you'll see them appear in the AUQ TUI. Answer them **at your convenience**.
 
+### Markdown rendering in question prompts
+
+Question prompts now support **Markdown formatting** in the `prompt` text.
+
+- Supported: **bold**, _italic_, ~~strikethrough~~, `inline code`, links, and fenced code blocks (with syntax highlighting)
+- Links render as `text (url)` for broad terminal compatibility
+- Code blocks use theme-aware colors (background/text/border)
+- Always enabled (no configuration needed)
+- Plain text prompts pass through unchanged
+- Graceful fallback: if Markdown parsing fails, the raw text is shown
+
 > _Note: AUQ is an unopinionated tool and doesn't include prompts on **HOW** AI should leverage it. It is expected that you do your own prompt engineering to make the most out of it in your own workflows._
 > _I personally enjoy prompting it to ask at least 30 questions repeatedly before action!_
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "auq-mcp-server",
-    "version": "2.0.0",
+    "version": "2.1.0",
     "main": "dist/index.js",
     "bin": {
         "auq": "dist/bin/auq.js"
@@ -53,11 +53,14 @@
         "@modelcontextprotocol/sdk": "1.17.2",
         "@types/uuid": "^10.0.0",
         "chalk": "^5.6.2",
+        "cli-highlight": "^2.1.11",
         "fastmcp": "^3.23.0",
         "gradient-string": "^3.0.0",
         "ink": "^6.4.0",
         "ink-gradient": "^3.0.0",
+        "ink-markdown-es": "^1.1.0",
         "ink-text-input": "^6.0.0",
+        "marked": "^17.0.3",
         "node-notifier": "^10.0.1",
         "react": "^19.2.0",
         "string-width": "^8.1.1",
@@ -206,6 +209,7 @@
         "conventional-changelog-conventionalcommits": "^9.1.0",
         "eslint-config-prettier": "^10.1.3",
         "eslint-plugin-perfectionist": "^4.12.3",
+        "ink-testing-library": "^4.0.0",
         "prettier": "^3.5.3",
         "semantic-release": "^24.2.3",
         "typescript": "^5.8.3",

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

@@ -0,0 +1,59 @@
+import React from "react";
+import { Text } from "ink";
+import Markdown from "ink-markdown-es";
+import { lexer } from "marked";
+import { useTheme } from "../ThemeContext.js";
+/**
+ * MarkdownPrompt renders markdown text with basic formatting support.
+ * Falls back to plain text if markdown parsing fails.
+ *
+ * Supports:
+ * - **bold** text
+ * - *italic* text
+ * - `inline code`
+ * - ~~strikethrough~~
+ * - [links](url) rendered as "text (url)"
+ * - Fenced code blocks with syntax highlighting
+ */
+export const MarkdownPrompt = ({ text }) => {
+    const { theme } = useTheme();
+    // Fallback to plain text if text is empty
+    if (!text || text.trim().length === 0) {
+        return React.createElement(Text, null, text);
+    }
+    try {
+        const tokens = lexer(text);
+        const hasBlockElements = tokens.some((token) => ["code", "list", "blockquote", "heading", "hr", "table"].includes(token.type));
+        const styles = {
+            code: {
+                backgroundColor: theme.components.markdown.codeBlockBg,
+                color: theme.components.markdown.codeBlockText,
+                borderColor: theme.components.markdown.codeBlockBorder,
+                borderStyle: "round",
+                paddingX: 1,
+            },
+            codespan: {
+                backgroundColor: theme.components.markdown.codeBlockBg,
+                color: theme.components.markdown.codeBlockText,
+            },
+        };
+        const baseRenderers = {
+            link: (linkText, href) => (React.createElement(Text, null,
+                linkText,
+                " (",
+                href,
+                ")")),
+        };
+        if (!hasBlockElements) {
+            return (React.createElement(Markdown, { styles: styles, renderers: {
+                    ...baseRenderers,
+                    paragraph: (content) => React.createElement(Text, null, content),
+                }, highlight: true }, text));
+        }
+        return (React.createElement(Markdown, { styles: styles, renderers: baseRenderers, highlight: true }, text));
+    }
+    catch {
+        // Silently fall back to plain text on any error
+        return React.createElement(Text, null, text);
+    }
+};

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

@@ -3,6 +3,7 @@ import React, { useState } from "react";
 import { t } from "../../i18n/index.js";
 import { useTheme } from "../ThemeContext.js";
 import { Footer } from "./Footer.js";
+import { MarkdownPrompt } from "./MarkdownPrompt.js";
 import { OptionsList } from "./OptionsList.js";
 import { TabBar } from "./TabBar.js";
 /**
@@ -35,19 +36,17 @@ export const QuestionDisplay = ({ currentQuestion, currentQuestionIndex, customA
             React.createElement(Text, { color: theme.components.directory.label, dimColor: true }, "\uD83D\uDCC1"),
             React.createElement(Text, { color: theme.components.directory.path }, ` ${workingDirectory}`))),
         React.createElement(TabBar, { currentIndex: currentQuestionIndex, questions: questions, answers: answers, elaborateMarks: elaborateMarks }),
-        React.createElement(Box, null,
-            React.createElement(Text, null,
-                React.createElement(Text, { bold: true },
-                    " ",
-                    currentQuestion.prompt,
-                    " "),
+        React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Box, null,
+                React.createElement(MarkdownPrompt, { text: currentQuestion.prompt }),
                 React.createElement(Text, { color: theme.components.questionDisplay.typeIndicator },
+                    " ",
                     "[",
                     multiSelect
                         ? t("question.multipleChoice")
                         : t("question.singleChoice"),
-                    "]"),
-                React.createElement(Text, null, " "),
+                    "]")),
+            React.createElement(Box, null,
                 React.createElement(Text, { color: theme.components.questionDisplay.elapsed, dimColor: true }, 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: handleFocusContextChange, onRecommendedDetected: onRecommendedDetected, questionKey: currentQuestionIndex, isElaborateMarked: elaborateMarks?.has(currentQuestionIndex), onElaborateSelect: onElaborateSelect, elaborateText: elaborateText, onElaborateTextChange: onElaborateTextChange }),
         React.createElement(Footer, { focusContext: focusContext, multiSelect: multiSelect ?? false, customInputValue: customAnswer, hasRecommendedOptions: hasRecommendedOptions, hasAnyRecommendedInSession: hasAnyRecommendedInSession })));

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

@@ -3,6 +3,7 @@ import React from "react";
 import { t } from "../../i18n/index.js";
 import { useTheme } from "../ThemeContext.js";
 import { Footer } from "./Footer.js";
+import { MarkdownPrompt } from "./MarkdownPrompt.js";
 /**
  * ReviewScreen displays a summary of all answers for confirmation
  * User can press Enter to confirm and submit, or 'n' to go back and edit
@@ -45,16 +46,18 @@ export const ReviewScreen = ({ answers, elapsedLabel, onConfirm, onGoBack, quest
             const questionId = `Q${index}`;
             const questionTitle = question.title || questionId;
             return (React.createElement(Box, { flexDirection: "column", key: index, marginBottom: 1 },
-                React.createElement(Box, null,
-                    React.createElement(Text, { color: theme.components.review.questionId },
-                        "[",
-                        questionId,
-                        "]",
-                        " "),
-                    React.createElement(Text, { bold: true },
-                        questionTitle,
-                        ". ",
-                        question.prompt)),
+                React.createElement(Box, { flexDirection: "column" },
+                    React.createElement(Box, null,
+                        React.createElement(Text, { color: theme.components.review.questionId },
+                            "[",
+                            questionId,
+                            "]",
+                            " "),
+                        React.createElement(Text, { bold: true },
+                            questionTitle,
+                            ".",
+                            " ")),
+                    React.createElement(MarkdownPrompt, { text: question.prompt })),
                 React.createElement(Box, { flexDirection: "column", marginLeft: 2, marginTop: 0.5 },
                     answer?.selectedOptions &&
                         answer.selectedOptions.length > 0 && (React.createElement(React.Fragment, null, answer.selectedOptions.map((option, idx) => (React.createElement(Text, { key: idx, color: theme.components.review.selectedOption },

package/dist/src/tui/components/__tests__/MarkdownPrompt.test.js

@@ -0,0 +1,96 @@
+import React from "react";
+import { cleanup, render } from "ink-testing-library";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { ThemeContext } from "../../ThemeContext.js";
+import { darkTheme } from "../../themes/dark.js";
+import { MarkdownPrompt } from "../MarkdownPrompt.js";
+const mockThemeValue = {
+    theme: darkTheme,
+    themeName: "AUQ dark",
+    cycleTheme: () => { },
+};
+function renderWithTheme(ui) {
+    return render(React.createElement(ThemeContext.Provider, { value: mockThemeValue }, ui));
+}
+function getOutput(frame) {
+    return (frame ?? "").replace(/\x1b\[[0-9;]*m/g, "").replace(/\r/g, "");
+}
+function compact(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+afterEach(() => {
+    cleanup();
+    vi.restoreAllMocks();
+});
+describe("MarkdownPrompt", () => {
+    it("renders plain text unchanged", () => {
+        const text = "Choose one option";
+        const instance = renderWithTheme(React.createElement(MarkdownPrompt, { text: text }));
+        expect(compact(getOutput(instance.lastFrame()))).toBe(text);
+    });
+    it("renders core inline markdown without raw markers", () => {
+        const text = "**bold** *italic* `code` ~~strike~~";
+        const instance = renderWithTheme(React.createElement(MarkdownPrompt, { text: text }));
+        const output = getOutput(instance.lastFrame());
+        expect(output).toContain("bold");
+        expect(output).toContain("italic");
+        expect(output).toContain("code");
+        expect(output).toContain("strike");
+        expect(output).not.toContain("**");
+        expect(output).not.toContain("~~");
+        expect(output).not.toContain("`code`");
+    });
+    it("keeps inline-only markdown in inline flow without extra block spacing", () => {
+        const text = "Hello **there** with `inline` markdown";
+        const instance = renderWithTheme(React.createElement(MarkdownPrompt, { text: text }));
+        const output = getOutput(instance.lastFrame());
+        expect(output).not.toContain("\n\n");
+        expect(compact(output)).toContain("Hello there with inline markdown");
+    });
+    it("renders links as text followed by URL in parentheses", () => {
+        const text = "Read [docs](https://example.com/docs) now";
+        const instance = renderWithTheme(React.createElement(MarkdownPrompt, { text: text }));
+        expect(compact(getOutput(instance.lastFrame()))).toContain("Read docs (https://example.com/docs) now");
+    });
+    it("renders fenced code blocks as distinct multi-line block content", () => {
+        const text = "Before\n\n```ts\nconst x = 1;\n```\n\nAfter";
+        const instance = renderWithTheme(React.createElement(MarkdownPrompt, { text: text }));
+        const output = getOutput(instance.lastFrame());
+        expect(output).toContain("Before");
+        expect(output).toContain("const x = 1;");
+        expect(output).toContain("After");
+        expect(output.split("\n").length).toBeGreaterThan(2);
+    });
+    it("handles empty and whitespace-only inputs without crashing", () => {
+        const empty = renderWithTheme(React.createElement(MarkdownPrompt, { text: "" }));
+        const spaces = renderWithTheme(React.createElement(MarkdownPrompt, { text: "   " }));
+        expect(getOutput(empty.lastFrame())).toBe("");
+        expect(getOutput(spaces.lastFrame())).toBe("");
+    });
+    it("normalizes CRLF content during rendering", () => {
+        const text = "Line1\r\nLine2\r\n**Bold**";
+        const instance = renderWithTheme(React.createElement(MarkdownPrompt, { text: text }));
+        const output = getOutput(instance.lastFrame());
+        expect(output).not.toContain("\r");
+        expect(output).toContain("Line1");
+        expect(output).toContain("Line2");
+        expect(output).toContain("Bold");
+    });
+    it("renders nested inline markdown content", () => {
+        const text = "**bold and *italic* with `code`**";
+        const instance = renderWithTheme(React.createElement(MarkdownPrompt, { text: text }));
+        const output = getOutput(instance.lastFrame());
+        expect(output).toContain("bold and");
+        expect(output).toContain("italic");
+        expect(output).toContain("code");
+        expect(output).not.toContain("**");
+        expect(output).not.toContain("`code`");
+    });
+    it("does not crash on malformed markdown", () => {
+        const malformed = "Broken [link](https://example.com and **mixed";
+        expect(() => renderWithTheme(React.createElement(MarkdownPrompt, { text: malformed }))).not.toThrow();
+        const instance = renderWithTheme(React.createElement(MarkdownPrompt, { text: malformed }));
+        const output = getOutput(instance.lastFrame());
+        expect(output.length).toBeGreaterThan(0);
+    });
+});

package/dist/src/tui/themes/catppuccin-latte.js

@@ -93,5 +93,10 @@ export const catppuccinLatteTheme = {
             info: "#1e66f5",
             border: "#ccd0da",
         },
+        markdown: {
+            codeBlockBg: "#eff1f5",
+            codeBlockText: "#4c4f69",
+            codeBlockBorder: "#ccd0da",
+        },
     },
 };

package/dist/src/tui/themes/catppuccin-mocha.js

@@ -93,5 +93,10 @@ export const catppuccinMochaTheme = {
             info: "#89b4fa",
             border: "#313244",
         },
+        markdown: {
+            codeBlockBg: "#1e1e2e",
+            codeBlockText: "#cdd6f4",
+            codeBlockBorder: "#313244",
+        },
     },
 };

package/dist/src/tui/themes/dark.js

@@ -94,5 +94,10 @@ export const darkTheme = {
             info: "#46D9FF",
             border: "#2A3238",
         },
+        markdown: {
+            codeBlockBg: "#0F1419",
+            codeBlockText: "#E7EEF5",
+            codeBlockBorder: "#2A3238",
+        },
     },
 };

package/dist/src/tui/themes/dracula.js

@@ -93,5 +93,10 @@ export const draculaTheme = {
             info: "#bd93f9",
             border: "#44475a",
         },
+        markdown: {
+            codeBlockBg: "#282a36",
+            codeBlockText: "#f8f8f2",
+            codeBlockBorder: "#44475a",
+        },
     },
 };

package/dist/src/tui/themes/github-dark.js

@@ -92,5 +92,10 @@ export const githubDarkTheme = {
             info: "#58a6ff",
             border: "#30363d",
         },
+        markdown: {
+            codeBlockBg: "#0d1117",
+            codeBlockText: "#c9d1d9",
+            codeBlockBorder: "#30363d",
+        },
     },
 };

package/dist/src/tui/themes/github-light.js

@@ -92,5 +92,10 @@ export const githubLightTheme = {
             info: "#0969DA",
             border: "#D0D7DE",
         },
+        markdown: {
+            codeBlockBg: "#f6f8fa",
+            codeBlockText: "#24292F",
+            codeBlockBorder: "#D0D7DE",
+        },
     },
 };

package/dist/src/tui/themes/gruvbox-dark.js

@@ -93,5 +93,10 @@ export const gruvboxDarkTheme = {
             info: "#458588",
             border: "#3c3836",
         },
+        markdown: {
+            codeBlockBg: "#282828",
+            codeBlockText: "#ebdbb2",
+            codeBlockBorder: "#3c3836",
+        },
     },
 };

package/dist/src/tui/themes/gruvbox-light.js

@@ -93,5 +93,10 @@ export const gruvboxLightTheme = {
             info: "#076678",
             border: "#d5c4a1",
         },
+        markdown: {
+            codeBlockBg: "#f9f5d9",
+            codeBlockText: "#3c3836",
+            codeBlockBorder: "#d5c4a1",
+        },
     },
 };

package/dist/src/tui/themes/light.js

@@ -93,5 +93,10 @@ export const lightTheme = {
             info: "#007EA7",
             border: "#D0D7DE",
         },
+        markdown: {
+            codeBlockBg: "#F6F8FA",
+            codeBlockText: "#24292F",
+            codeBlockBorder: "#D0D7DE",
+        },
     },
 };

package/dist/src/tui/themes/monokai.js

@@ -94,5 +94,10 @@ export const monokaiTheme = {
             info: "#66D9EF",
             border: "#49483E",
         },
+        markdown: {
+            codeBlockBg: "#272822",
+            codeBlockText: "#F8F8F2",
+            codeBlockBorder: "#49483E",
+        },
     },
 };

package/dist/src/tui/themes/nord.js

@@ -93,5 +93,10 @@ export const nordTheme = {
             info: "#88c0d0", // nord8
             border: "#3b4252", // nord1
         },
+        markdown: {
+            codeBlockBg: "#2e3440",
+            codeBlockText: "#eceff4",
+            codeBlockBorder: "#3b4252",
+        },
     },
 };

package/dist/src/tui/themes/one-dark.js

@@ -93,5 +93,10 @@ export const oneDarkTheme = {
             info: "#61afef",
             border: "#3e4451",
         },
+        markdown: {
+            codeBlockBg: "#21252b",
+            codeBlockText: "#abb2bf",
+            codeBlockBorder: "#3e4451",
+        },
     },
 };

package/dist/src/tui/themes/rose-pine.js

@@ -94,5 +94,10 @@ export const rosePineTheme = {
             info: "#9ccfd8",
             border: "#26233a",
         },
+        markdown: {
+            codeBlockBg: "#191724",
+            codeBlockText: "#e0def4",
+            codeBlockBorder: "#26233a",
+        },
     },
 };

package/dist/src/tui/themes/solarized-dark.js

@@ -93,5 +93,10 @@ export const solarizedDarkTheme = {
             info: "#268bd2",
             border: "#073642",
         },
+        markdown: {
+            codeBlockBg: "#002b36",
+            codeBlockText: "#839496",
+            codeBlockBorder: "#073642",
+        },
     },
 };

package/dist/src/tui/themes/solarized-light.js

@@ -93,5 +93,10 @@ export const solarizedLightTheme = {
             info: "#268bd2",
             border: "#eee8d5",
         },
+        markdown: {
+            codeBlockBg: "#fdf6e3",
+            codeBlockText: "#657b83",
+            codeBlockBorder: "#eee8d5",
+        },
     },
 };

package/dist/src/tui/themes/tokyo-night.js

@@ -93,5 +93,10 @@ export const tokyoNightTheme = {
             info: "#7aa2f7",
             border: "#24283b",
         },
+        markdown: {
+            codeBlockBg: "#1a1b26",
+            codeBlockText: "#c0caf5",
+            codeBlockBorder: "#24283b",
+        },
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auq-mcp-server",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "main": "dist/index.js",
   "bin": {
     "auq": "dist/bin/auq.js"
@@ -53,11 +53,14 @@
     "@modelcontextprotocol/sdk": "1.17.2",
     "@types/uuid": "^10.0.0",
     "chalk": "^5.6.2",
+    "cli-highlight": "^2.1.11",
     "fastmcp": "^3.23.0",
     "gradient-string": "^3.0.0",
     "ink": "^6.4.0",
     "ink-gradient": "^3.0.0",
+    "ink-markdown-es": "^1.1.0",
     "ink-text-input": "^6.0.0",
+    "marked": "^17.0.3",
     "node-notifier": "^10.0.1",
     "react": "^19.2.0",
     "string-width": "^8.1.1",
@@ -206,6 +209,7 @@
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "eslint-config-prettier": "^10.1.3",
     "eslint-plugin-perfectionist": "^4.12.3",
+    "ink-testing-library": "^4.0.0",
     "prettier": "^3.5.3",
     "semantic-release": "^24.2.3",
     "typescript": "^5.8.3",