auq-mcp-server 2.6.4 → 2.7.0

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

@@ -0,0 +1,130 @@
+/**
+ * Solarized Dark Theme
+ * Precision colors for machines and people.
+ * https://ethanschoonover.com/solarized/
+ */
+export const solarizedDarkTheme = {
+    name: "solarized-dark",
+    gradient: {
+        start: "#268bd2", // blue
+        middle: "#2aa198", // cyan
+        end: "#268bd2",
+    },
+    colors: {
+        bg: "#002B36",
+        surface: "#073642",
+        surfaceAlt: "#0A4050",
+        primary: "#268bd2", // blue
+        success: "#859900", // green
+        warning: "#b58900", // yellow
+        error: "#dc322f", // red
+        info: "#2aa198", // cyan
+        focused: "#268bd2",
+        selected: "#859900",
+        pending: "#b58900",
+        unansweredHighlight: "#dc322f",
+        text: "#93A1A1", // base1 - brighter for readability
+        textDim: "#7D8E95", // base01 brightened for contrast
+        textBold: "#EEE8D5", // base2 - clearly bold
+    },
+    borders: {
+        primary: "#268bd2",
+        warning: "#b58900",
+        error: "#dc322f",
+        neutral: "#073642", // base02
+    },
+    components: {
+        header: {
+            border: "#586e75", // base01 - slightly more visible
+            queueActive: "#268bd2",
+            queueEmpty: "#6c7c83",
+            queueFlash: "#2aa198",
+            pillBg: "#073642",
+        },
+        directory: {
+            label: "#6c7c83",
+            path: "#839496",
+        },
+        tabBar: {
+            selected: "#93a1a1",
+            selectedBg: "#073642",
+            default: "#6c7c83",
+            answered: "#859900",
+            unanswered: "#6c7c83",
+            divider: "#073642",
+        },
+        options: {
+            focused: "#859900",
+            focusedBg: "#073642",
+            selected: "#268bd2",
+            selectedBg: "#073642",
+            default: "#839496",
+            description: "#93a1a1", // base1 - lighter for readability
+            hint: "#93a1a1", // base1 - lighter for readability
+        },
+        input: {
+            border: "#073642",
+            borderFocused: "#268bd2",
+            placeholder: "#6c7c83",
+            cursor: "#268bd2",
+            cursorDim: "#2aa198",
+        },
+        review: {
+            border: "#073642",
+            confirmBorder: "#268bd2",
+            selectedOption: "#859900",
+            customAnswer: "#b58900",
+            questionId: "#6c7c83",
+            divider: "#073642",
+        },
+        questionDisplay: {
+            questionId: "#268bd2",
+            typeIndicator: "#6c7c83",
+            elapsed: "#6c7c83",
+        },
+        footer: {
+            border: "#073642",
+            keyBg: "#073642",
+            keyFg: "#268bd2",
+            action: "#839496", // base0 - brighter for visibility
+            separator: "#073642",
+        },
+        toast: {
+            success: "#859900",
+            successPillBg: "#073642",
+            error: "#dc322f",
+            info: "#268bd2",
+            warning: "#b58900",
+            border: "#073642",
+        },
+        markdown: {
+            codeBlockBg: "#002b36",
+            codeBlockText: "#839496",
+            codeBlockBorder: "#073642",
+        },
+        sessionDots: {
+            active: "#268bd2",
+            answered: "#859900",
+            inProgress: "#b58900",
+            untouched: "#6c7c83",
+            number: "#839496",
+            activeNumber: "#268bd2",
+            stale: "#b58900",
+            abandoned: "#dc322f",
+        },
+        sessionPicker: {
+            border: "#268bd2",
+            title: "#268bd2",
+            rowText: "#839496",
+            rowDim: "#6c7c83",
+            highlightBg: "#073642",
+            highlightFg: "#859900",
+            activeMark: "#268bd2",
+            progress: "#2aa198",
+            staleIcon: "#b58900",
+            staleText: "#b58900",
+            staleAge: "#b58900",
+            staleSubtitle: "#6c7c83",
+        },
+    },
+};

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

@@ -0,0 +1,130 @@
+/**
+ * Solarized Light Theme
+ * Precision colors for machines and people - light variant.
+ * https://ethanschoonover.com/solarized/
+ */
+export const solarizedLightTheme = {
+    name: "solarized-light",
+    gradient: {
+        start: "#268bd2", // blue
+        middle: "#2aa198", // cyan
+        end: "#268bd2",
+    },
+    colors: {
+        bg: "#FDF6E3",
+        surface: "#EEE8D5",
+        surfaceAlt: "#DDD6C1",
+        primary: "#268bd2", // blue
+        success: "#859900", // green
+        warning: "#b58900", // yellow
+        error: "#dc322f", // red
+        info: "#2aa198", // cyan
+        focused: "#268bd2",
+        selected: "#859900",
+        pending: "#b58900",
+        unansweredHighlight: "#dc322f",
+        text: "#657b83", // base00
+        textDim: "#8A9899", // base1 darkened for contrast on cream
+        textBold: "#586e75", // base01
+    },
+    borders: {
+        primary: "#268bd2",
+        warning: "#b58900",
+        error: "#dc322f",
+        neutral: "#eee8d5", // base2
+    },
+    components: {
+        header: {
+            border: "#93a1a1", // base1 - slightly more visible
+            queueActive: "#268bd2",
+            queueEmpty: "#a3b1b1",
+            queueFlash: "#2aa198",
+            pillBg: "#eee8d5",
+        },
+        directory: {
+            label: "#8A9899",
+            path: "#657b83",
+        },
+        tabBar: {
+            selected: "#586e75",
+            selectedBg: "#eee8d5",
+            default: "#8A9899",
+            answered: "#859900",
+            unanswered: "#a3b1b1",
+            divider: "#eee8d5",
+        },
+        options: {
+            focused: "#859900",
+            focusedBg: "#eee8d5",
+            selected: "#268bd2",
+            selectedBg: "#eee8d5",
+            default: "#657b83",
+            description: "#586e75", // base01 - darker for readability
+            hint: "#586e75", // base01 - darker for readability
+        },
+        input: {
+            border: "#eee8d5",
+            borderFocused: "#268bd2",
+            placeholder: "#a3b1b1",
+            cursor: "#268bd2",
+            cursorDim: "#2aa198",
+        },
+        review: {
+            border: "#eee8d5",
+            confirmBorder: "#268bd2",
+            selectedOption: "#859900",
+            customAnswer: "#b58900",
+            questionId: "#a3b1b1",
+            divider: "#eee8d5",
+        },
+        questionDisplay: {
+            questionId: "#268bd2",
+            typeIndicator: "#a3b1b1",
+            elapsed: "#a3b1b1",
+        },
+        footer: {
+            border: "#eee8d5",
+            keyBg: "#eee8d5",
+            keyFg: "#268bd2",
+            action: "#657b83", // base00 - darker for visibility
+            separator: "#eee8d5",
+        },
+        toast: {
+            success: "#859900",
+            successPillBg: "#eee8d5",
+            error: "#dc322f",
+            info: "#268bd2",
+            warning: "#b58900",
+            border: "#eee8d5",
+        },
+        markdown: {
+            codeBlockBg: "#fdf6e3",
+            codeBlockText: "#657b83",
+            codeBlockBorder: "#eee8d5",
+        },
+        sessionDots: {
+            active: "#268bd2",
+            answered: "#859900",
+            inProgress: "#b58900",
+            untouched: "#a3b1b1",
+            number: "#657b83",
+            activeNumber: "#268bd2",
+            stale: "#b58900",
+            abandoned: "#dc322f",
+        },
+        sessionPicker: {
+            border: "#268bd2",
+            title: "#268bd2",
+            rowText: "#657b83",
+            rowDim: "#a3b1b1",
+            highlightBg: "#eee8d5",
+            highlightFg: "#859900",
+            activeMark: "#268bd2",
+            progress: "#2aa198",
+            staleIcon: "#b58900",
+            staleText: "#b58900",
+            staleAge: "#b58900",
+            staleSubtitle: "#a3b1b1",
+        },
+    },
+};

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

@@ -0,0 +1,131 @@
+/**
+ * Tokyo Night Theme
+ * A clean, dark theme celebrating the lights of downtown Tokyo.
+ * https://github.com/enkia/tokyo-night-vscode-theme
+ */
+export const tokyoNightTheme = {
+    name: "tokyo-night",
+    gradient: {
+        start: "#7aa2f7", // blue
+        middle: "#7dcfff", // cyan
+        end: "#7aa2f7",
+    },
+    colors: {
+        // Background layers (OpenCode-style filled surfaces)
+        bg: "#1A1B26",
+        surface: "#1F2335",
+        surfaceAlt: "#292E42",
+        primary: "#7aa2f7", // blue
+        success: "#9ece6a", // green
+        warning: "#e0af68", // yellow
+        error: "#f7768e", // red
+        info: "#7dcfff", // cyan
+        focused: "#7aa2f7",
+        selected: "#9ece6a",
+        pending: "#e0af68",
+        unansweredHighlight: "#f7768e",
+        text: "#c0caf5", // foreground
+        textDim: "#7F87B5", // comment brightened
+        textBold: "#c0caf5",
+    },
+    borders: {
+        primary: "#7aa2f7",
+        warning: "#e0af68",
+        error: "#f7768e",
+        neutral: "#24283b", // storm bg
+    },
+    components: {
+        header: {
+            border: "#3b4261", // slightly more visible
+            queueActive: "#7aa2f7",
+            queueEmpty: "#7078A3",
+            queueFlash: "#7dcfff",
+            pillBg: "#24283b",
+        },
+        directory: {
+            label: "#7078A3",
+            path: "#c0caf5",
+        },
+        tabBar: {
+            selected: "#c0caf5",
+            selectedBg: "#24283b",
+            default: "#7078A3",
+            answered: "#9ece6a",
+            unanswered: "#7078A3",
+            divider: "#24283b",
+        },
+        options: {
+            focused: "#9ece6a",
+            focusedBg: "#24283b",
+            selected: "#7aa2f7",
+            selectedBg: "#24283b",
+            default: "#c0caf5",
+            description: "#9aa5ce", // lighter for readability
+            hint: "#9aa5ce", // lighter for readability
+        },
+        input: {
+            border: "#24283b",
+            borderFocused: "#7aa2f7",
+            placeholder: "#7078A3",
+            cursor: "#7aa2f7",
+            cursorDim: "#7dcfff",
+        },
+        review: {
+            border: "#24283b",
+            confirmBorder: "#7aa2f7",
+            selectedOption: "#9ece6a",
+            customAnswer: "#e0af68",
+            questionId: "#7078A3",
+            divider: "#24283b",
+        },
+        questionDisplay: {
+            questionId: "#7aa2f7",
+            typeIndicator: "#7078A3",
+            elapsed: "#7078A3",
+        },
+        footer: {
+            border: "#24283b",
+            keyBg: "#24283b",
+            keyFg: "#7aa2f7",
+            action: "#8E9AB5",
+            separator: "#24283b",
+        },
+        toast: {
+            success: "#9ece6a",
+            successPillBg: "#1a1b26",
+            error: "#f7768e",
+            info: "#7aa2f7",
+            warning: "#e0af68",
+            border: "#24283b",
+        },
+        markdown: {
+            codeBlockBg: "#1a1b26",
+            codeBlockText: "#c0caf5",
+            codeBlockBorder: "#24283b",
+        },
+        sessionDots: {
+            active: "#7aa2f7",
+            answered: "#9ece6a",
+            inProgress: "#e0af68",
+            untouched: "#7078A3",
+            number: "#c0caf5",
+            activeNumber: "#7aa2f7",
+            stale: "#e0af68",
+            abandoned: "#f7768e",
+        },
+        sessionPicker: {
+            border: "#7aa2f7",
+            title: "#7aa2f7",
+            rowText: "#c0caf5",
+            rowDim: "#7078A3",
+            highlightBg: "#24283b",
+            highlightFg: "#9ece6a",
+            activeMark: "#7aa2f7",
+            progress: "#7dcfff",
+            staleIcon: "#e0af68",
+            staleText: "#e0af68",
+            staleAge: "#e0af68",
+            staleSubtitle: "#7078A3",
+        },
+    },
+};

package/dist/src/tui/shared/themes/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/tui/shared/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/tui/shared/utils/config.js

@@ -0,0 +1,80 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+/**
+ * Get the config directory for AUQ
+ * Respects XDG_CONFIG_HOME on Linux, defaults to ~/.config/auq
+ */
+function getConfigDirectory() {
+    const xdgConfig = process.env.XDG_CONFIG_HOME;
+    const baseConfig = xdgConfig || path.join(os.homedir(), ".config");
+    return path.join(baseConfig, "auq");
+}
+/**
+ * Get the config file path
+ */
+function getConfigPath() {
+    return path.join(getConfigDirectory(), "config.json");
+}
+/**
+ * Load config from file
+ * Returns empty config if file doesn't exist or is invalid
+ */
+export function loadConfig() {
+    try {
+        const configPath = getConfigPath();
+        if (!fs.existsSync(configPath)) {
+            return {};
+        }
+        const content = fs.readFileSync(configPath, "utf-8");
+        const data = JSON.parse(content);
+        if (typeof data !== "object" || data === null) {
+            return {};
+        }
+        return data;
+    }
+    catch {
+        // Silently return empty config on any error
+        return {};
+    }
+}
+/**
+ * Save config to file
+ * Creates the config directory if it doesn't exist
+ */
+export function saveConfig(config) {
+    try {
+        const configDir = getConfigDirectory();
+        const configPath = getConfigPath();
+        // Ensure directory exists
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        // Merge with existing config to preserve other settings
+        const existingConfig = loadConfig();
+        const mergedConfig = { ...existingConfig, ...config };
+        fs.writeFileSync(configPath, JSON.stringify(mergedConfig, null, 2) + "\n");
+    }
+    catch {
+        // Silently ignore save errors - config is optional
+    }
+}
+/**
+ * Get saved theme from config
+ */
+export function getSavedTheme() {
+    const config = loadConfig();
+    return config.theme;
+}
+/**
+ * Save theme to config
+ */
+export function saveTheme(themeName) {
+    saveConfig({ theme: themeName });
+}
+/**
+ * Get the config directory path (for display purposes)
+ */
+export function getConfigDirectoryPath() {
+    return getConfigDirectory();
+}

package/dist/src/tui/shared/utils/detectTheme.js

@@ -0,0 +1,33 @@
+let cachedResult = null;
+/**
+ * Detect whether the system prefers dark or light mode.
+ * Uses the COLORFGBG environment variable if available, otherwise defaults to dark.
+ * Results are cached for performance.
+ *
+ * @returns The resolved theme name ("AUQ dark" or "AUQ light")
+ */
+export function detectSystemTheme() {
+    if (cachedResult !== null) {
+        return cachedResult;
+    }
+    const colorfgbg = process.env.COLORFGBG;
+    if (colorfgbg) {
+        const parts = colorfgbg.split(";");
+        if (parts.length >= 2) {
+            const bg = parseInt(parts[1], 10);
+            if (!isNaN(bg)) {
+                cachedResult = bg < 8 ? "AUQ dark" : "AUQ light";
+                return cachedResult;
+            }
+        }
+    }
+    cachedResult = "AUQ dark";
+    return cachedResult;
+}
+/**
+ * Clear the cached theme detection result.
+ * Call this when the system theme may have changed.
+ */
+export function clearDetectionCache() {
+    cachedResult = null;
+}

package/dist/src/tui/shared/utils/index.js

@@ -0,0 +1,6 @@
+export * from "./staleDetection.js";
+export * from "./sessionSwitching.js";
+export * from "./relativeTime.js";
+export * from "./recommended.js";
+export * from "./config.js";
+export * from "./detectTheme.js";

package/dist/src/tui/shared/utils/recommended.js

@@ -0,0 +1,52 @@
+/**
+ * Utility for detecting recommended options in question labels.
+ * Supports multiple languages and bracket styles.
+ */
+/**
+ * Regex patterns for detecting recommended markers in labels.
+ * Requires matching delimiters: either (word) or [word].
+ * Matches case-insensitively and supports both parentheses and brackets.
+ */
+export const RECOMMENDED_PATTERNS = {
+    /** Matches (recommended) or [recommended] - case insensitive, requires matching delimiters */
+    EN: /(?:\(recommended\)|\[recommended\])/i,
+    /** Matches (추천) or [추천] - requires matching delimiters */
+    KO: /(?:\(추천\)|\[추천\])/,
+};
+/**
+ * Combined regex for detecting any recommended pattern.
+ * Requires matching delimiters: either (word) or [word].
+ * Matches case-insensitively for English, exactly for Korean.
+ */
+const RECOMMENDED_REGEX = /(?:\(recommended\)|\[recommended\]|\(추천\)|\[추천\])/i;
+/**
+ * Detects if a label contains a recommended pattern.
+ * Supports English "recommended" and Korean "추천" in parentheses or brackets.
+ * Case-insensitive matching.
+ *
+ * @param label - The option label to check
+ * @returns true if the label contains a recommended marker
+ *
+ * @example
+ * isRecommendedOption("Option A (recommended)") // true
+ * isRecommendedOption("[추천] Option B") // true
+ * isRecommendedOption("Option C") // false
+ */
+export function isRecommendedOption(label) {
+    return RECOMMENDED_REGEX.test(label);
+}
+/**
+ * Extracts the clean label by removing recommended markers.
+ * Removes recommended patterns and trims whitespace.
+ *
+ * @param label - The option label with potential recommended marker
+ * @returns The clean label without recommended markers
+ *
+ * @example
+ * extractCleanLabel("Option A (recommended)") // "Option A"
+ * extractCleanLabel("[추천] Option B") // "Option B"
+ * extractCleanLabel("  Option C  ") // "Option C"
+ */
+export function extractCleanLabel(label) {
+    return label.replace(RECOMMENDED_REGEX, "").trim().replace(/\s+/g, " ");
+}

package/dist/src/tui/shared/utils/relativeTime.js

@@ -0,0 +1,24 @@
+/**
+ * Format a timestamp as a concise relative time string.
+ *
+ * @param date - A Date object or a numeric epoch-ms timestamp
+ * @returns Human-readable label such as "just now", "12s ago", "3m ago"
+ */
+export function formatRelativeTime(date) {
+    const now = Date.now();
+    const then = typeof date === "number" ? date : date.getTime();
+    const diffMs = Math.max(0, now - then);
+    const diffSec = Math.floor(diffMs / 1000);
+    if (diffSec < 5)
+        return "just now";
+    if (diffSec < 60)
+        return `${diffSec}s ago`;
+    const diffMin = Math.floor(diffSec / 60);
+    if (diffMin < 60)
+        return `${diffMin}m ago`;
+    const diffHr = Math.floor(diffMin / 60);
+    if (diffHr < 24)
+        return `${diffHr}h ago`;
+    const diffDay = Math.floor(diffHr / 24);
+    return `${diffDay}d ago`;
+}

package/dist/src/tui/shared/utils/sessionSwitching.js

@@ -0,0 +1,56 @@
+/**
+ * Calculate the next session index with cyclic wrap-around.
+ * Returns current index if queue has <= 1 item.
+ */
+export function getNextSessionIndex(currentIndex, queueLength) {
+    if (queueLength <= 1) {
+        return currentIndex;
+    }
+    return (currentIndex + 1) % queueLength;
+}
+/**
+ * Calculate the previous session index with cyclic wrap-around.
+ * Returns current index if queue has <= 1 item.
+ */
+export function getPrevSessionIndex(currentIndex, queueLength) {
+    if (queueLength <= 1) {
+        return currentIndex;
+    }
+    return (currentIndex - 1 + queueLength) % queueLength;
+}
+/**
+ * Validate and return the target index for a direct jump (1-based input).
+ * Returns null if the jump is invalid (out of range, same as current).
+ */
+export function getDirectJumpIndex(keyNumber, currentIndex, queueLength) {
+    if (keyNumber < 1 || keyNumber > 9) {
+        return null;
+    }
+    const targetIndex = keyNumber - 1;
+    if (targetIndex >= queueLength) {
+        return null;
+    }
+    if (targetIndex === currentIndex) {
+        return null;
+    }
+    return targetIndex;
+}
+/**
+ * Calculate the new active session index after removing a session.
+ * Handles: removal before active, removal at active, removal after active, queue becoming empty.
+ */
+export function getAdjustedIndexAfterRemoval(removedIndex, activeIndex, newQueueLength) {
+    if (newQueueLength === 0) {
+        return 0;
+    }
+    if (removedIndex < activeIndex) {
+        return activeIndex - 1;
+    }
+    if (removedIndex > activeIndex) {
+        return activeIndex;
+    }
+    if (removedIndex < newQueueLength) {
+        return removedIndex;
+    }
+    return newQueueLength - 1;
+}