sequant 1.12.0 → 1.13.1

package/dist/src/lib/cli-ui.js

@@ -0,0 +1,544 @@
+/**
+ * Centralized CLI UI module for Sequant
+ *
+ * Provides consistent styling, spinners, boxes, tables, and branding
+ * with graceful fallbacks for non-TTY, CI, and legacy terminals.
+ */
+import chalk from "chalk";
+import ora from "ora";
+import boxen from "boxen";
+// cli-table3 uses CommonJS `export =` syntax, default import works with esModuleInterop
+import Table from "cli-table3";
+import gradient from "gradient-string";
+import { isCI, isStdoutTTY } from "./tty.js";
+/**
+ * Global UI configuration state
+ */
+let config = {
+    noColor: false,
+    jsonMode: false,
+    verbose: false,
+    isTTY: isStdoutTTY(),
+    isCI: isCI(),
+    minimal: false,
+};
+/**
+ * Configure UI settings
+ *
+ * Call this early in CLI startup to set global options.
+ */
+export function configureUI(options) {
+    config = { ...config, ...options };
+    // Check environment variables
+    if (process.env.NO_COLOR || process.env.SEQUANT_MINIMAL === "1") {
+        config.noColor = !!process.env.NO_COLOR;
+        config.minimal = process.env.SEQUANT_MINIMAL === "1";
+    }
+    // Auto-configure for CI
+    if (config.isCI && !options.minimal) {
+        config.minimal = true;
+    }
+}
+/**
+ * Get current UI configuration
+ */
+export function getUIConfig() {
+    return { ...config };
+}
+/**
+ * Check if decorative output should be shown
+ */
+function shouldShowDecorative() {
+    return !config.jsonMode && !config.minimal && config.isTTY;
+}
+/**
+ * Check if animations should be used
+ */
+function shouldAnimate() {
+    return (!config.jsonMode &&
+        !config.verbose &&
+        !config.isCI &&
+        config.isTTY &&
+        !config.noColor);
+}
+// ============================================================================
+// Color Palette
+// ============================================================================
+/**
+ * Standardized color palette for consistent styling
+ */
+export const colors = {
+    // Semantic colors
+    success: config.noColor ? (s) => s : chalk.green,
+    error: config.noColor ? (s) => s : chalk.red,
+    warning: config.noColor ? (s) => s : chalk.yellow,
+    info: config.noColor ? (s) => s : chalk.blue,
+    muted: config.noColor ? (s) => s : chalk.gray,
+    // UI elements
+    header: config.noColor ? (s) => s : chalk.blue.bold,
+    label: config.noColor ? (s) => s : chalk.cyan,
+    value: config.noColor ? (s) => s : chalk.white,
+    accent: config.noColor ? (s) => s : chalk.cyan,
+    bold: config.noColor ? (s) => s : chalk.bold,
+    // Status colors
+    pending: config.noColor ? (s) => s : chalk.gray,
+    running: config.noColor ? (s) => s : chalk.cyan,
+    completed: config.noColor ? (s) => s : chalk.green,
+    failed: config.noColor ? (s) => s : chalk.red,
+};
+/**
+ * Get color function respecting current config
+ */
+function getColor(colorFn) {
+    return config.noColor ? (s) => s : colorFn;
+}
+// ============================================================================
+// Windows Compatibility
+// ============================================================================
+/**
+ * Detect if running on legacy Windows terminal
+ */
+function isLegacyWindows() {
+    return (process.platform === "win32" &&
+        !process.env.WT_SESSION && // Not Windows Terminal
+        !process.env.TERM_PROGRAM // Not VS Code terminal
+    );
+}
+// ============================================================================
+// ASCII Logo (Static - No figlet)
+// ============================================================================
+/**
+ * Static ASCII logo for SEQUANT branding
+ * Pre-generated to avoid ~1MB figlet font bundle
+ */
+const ASCII_LOGO = `
+   _____ _____ _____ _   _ _____ _   _ _____
+  /  ___/  ___|  _  | | | |  _  | \\ | |_   _|
+  \\ \`--.\\ \`--.| | | | | | | | | |  \\| | | |
+   \`--. \\\`--. \\ \\_/ / | | \\_| |_| . \` | | |
+  /\\__/ /\\__/ /\\___/\\ |_| |\\___/\\_|\\_/ \\_/
+  \\____/\\____/       \\___/
+`.trimStart();
+/**
+ * Get the ASCII logo with optional gradient
+ */
+export function logo() {
+    if (config.jsonMode || config.minimal)
+        return "";
+    if (config.noColor || !config.isTTY)
+        return ASCII_LOGO;
+    // Apply gradient for color terminals
+    const sequantGradient = gradient(["#00D4FF", "#7B68EE", "#FF6B9D"]);
+    return sequantGradient(ASCII_LOGO);
+}
+/**
+ * Get the banner (logo + tagline)
+ */
+export function banner() {
+    if (config.jsonMode || config.minimal)
+        return "";
+    const logoText = logo();
+    const tagline = config.noColor
+        ? "  Quantize your development workflow"
+        : chalk.gray("  Quantize your development workflow");
+    return `${logoText}\n${tagline}\n`;
+}
+/**
+ * Text-only spinner for verbose mode / non-TTY
+ */
+class TextSpinner {
+    text;
+    isSpinning = false;
+    constructor(initialText) {
+        this.text = initialText;
+    }
+    start(text) {
+        if (text)
+            this.text = text;
+        this.isSpinning = true;
+        if (!config.jsonMode) {
+            console.log(getColor(chalk.cyan)(`\u23F3 ${this.text}`));
+        }
+        return this;
+    }
+    succeed(text) {
+        if (text)
+            this.text = text;
+        this.isSpinning = false;
+        if (!config.jsonMode) {
+            console.log(getColor(chalk.green)(`\u2713 ${this.text}`));
+        }
+        return this;
+    }
+    fail(text) {
+        if (text)
+            this.text = text;
+        this.isSpinning = false;
+        if (!config.jsonMode) {
+            console.log(getColor(chalk.red)(`\u2717 ${this.text}`));
+        }
+        return this;
+    }
+    warn(text) {
+        if (text)
+            this.text = text;
+        this.isSpinning = false;
+        if (!config.jsonMode) {
+            console.log(getColor(chalk.yellow)(`\u26A0 ${this.text}`));
+        }
+        return this;
+    }
+    stop() {
+        this.isSpinning = false;
+        return this;
+    }
+}
+/**
+ * Animated spinner wrapper
+ */
+class AnimatedSpinner {
+    spinner;
+    constructor(initialText) {
+        this.spinner = ora({
+            text: initialText,
+            color: "cyan",
+            spinner: "dots",
+        });
+    }
+    get text() {
+        return this.spinner.text;
+    }
+    set text(value) {
+        this.spinner.text = value;
+    }
+    get isSpinning() {
+        return this.spinner.isSpinning;
+    }
+    start(text) {
+        if (text)
+            this.spinner.text = text;
+        this.spinner.start();
+        return this;
+    }
+    succeed(text) {
+        this.spinner.succeed(text);
+        return this;
+    }
+    fail(text) {
+        this.spinner.fail(text);
+        return this;
+    }
+    warn(text) {
+        this.spinner.warn(text);
+        return this;
+    }
+    stop() {
+        this.spinner.stop();
+        return this;
+    }
+}
+/**
+ * Create a spinner with automatic fallback
+ *
+ * Returns an animated spinner for TTY, text-only for non-TTY/verbose/CI.
+ */
+export function spinner(text) {
+    if (shouldAnimate()) {
+        return new AnimatedSpinner(text);
+    }
+    return new TextSpinner(text);
+}
+/**
+ * Get boxen options for a given style
+ */
+function getBoxOptions(style) {
+    const baseOptions = {
+        padding: 1,
+        borderStyle: isLegacyWindows() ? "classic" : "round",
+    };
+    switch (style) {
+        case "success":
+            return {
+                ...baseOptions,
+                borderColor: config.noColor ? undefined : "green",
+            };
+        case "error":
+            return {
+                ...baseOptions,
+                borderColor: config.noColor ? undefined : "red",
+            };
+        case "warning":
+            return {
+                ...baseOptions,
+                borderColor: config.noColor ? undefined : "yellow",
+            };
+        case "info":
+            return {
+                ...baseOptions,
+                borderColor: config.noColor ? undefined : "blue",
+            };
+        case "header":
+            return {
+                ...baseOptions,
+                borderColor: config.noColor ? undefined : "cyan",
+                padding: { top: 0, bottom: 0, left: 1, right: 1 },
+            };
+        default:
+            return baseOptions;
+    }
+}
+/**
+ * Create a boxed message
+ */
+export function box(content, style = "default") {
+    if (config.jsonMode)
+        return "";
+    if (!shouldShowDecorative()) {
+        // Fallback to simple bordered output
+        return content;
+    }
+    return boxen(content, getBoxOptions(style));
+}
+/**
+ * Create a success box with title and message
+ */
+export function successBox(title, message) {
+    const content = `${getColor(chalk.green.bold)(`\u2705 ${title}`)}\n\n${message}`;
+    return box(content, "success");
+}
+/**
+ * Create an error box with title and message
+ */
+export function errorBox(title, message) {
+    const content = `${getColor(chalk.red.bold)(`\u274C ${title}`)}\n\n${message}`;
+    return box(content, "error");
+}
+/**
+ * Create a warning box with title and message
+ */
+export function warningBox(title, message) {
+    const content = `${getColor(chalk.yellow.bold)(`\u26A0\uFE0F  ${title}`)}\n\n${message}`;
+    return box(content, "warning");
+}
+/**
+ * Create a header box
+ */
+export function headerBox(title) {
+    const content = getColor(chalk.bold)(title);
+    return box(content, "header");
+}
+/**
+ * Create a formatted table
+ */
+export function table(rows, options) {
+    if (config.jsonMode)
+        return "";
+    const tableInstance = new Table({
+        head: options.columns.map((col) => config.noColor ? col.header : chalk.cyan.bold(col.header)),
+        colWidths: options.columns.map((col) => col.width ?? null),
+        colAligns: options.columns.map((col) => col.align || "left"),
+        style: {
+            head: [],
+            border: config.noColor ? [] : ["gray"],
+        },
+        chars: isLegacyWindows()
+            ? {
+                top: "-",
+                "top-mid": "+",
+                "top-left": "+",
+                "top-right": "+",
+                bottom: "-",
+                "bottom-mid": "+",
+                "bottom-left": "+",
+                "bottom-right": "+",
+                left: "|",
+                "left-mid": "+",
+                mid: "-",
+                "mid-mid": "+",
+                right: "|",
+                "right-mid": "+",
+                middle: "|",
+            }
+            : undefined,
+    });
+    for (const row of rows) {
+        tableInstance.push(row.map(String));
+    }
+    return tableInstance.toString();
+}
+/**
+ * Create a simple key-value table
+ */
+export function keyValueTable(data) {
+    if (config.jsonMode)
+        return "";
+    const rows = Object.entries(data).map(([key, value]) => [
+        config.noColor ? key : chalk.cyan(key),
+        String(value),
+    ]);
+    const tableInstance = new Table({
+        style: {
+            head: [],
+            border: config.noColor ? [] : ["gray"],
+        },
+        chars: isLegacyWindows()
+            ? {
+                top: "-",
+                "top-mid": "+",
+                "top-left": "+",
+                "top-right": "+",
+                bottom: "-",
+                "bottom-mid": "+",
+                "bottom-left": "+",
+                "bottom-right": "+",
+                left: "|",
+                "left-mid": "+",
+                mid: "-",
+                "mid-mid": "+",
+                right: "|",
+                "right-mid": "+",
+                middle: "|",
+            }
+            : undefined,
+    });
+    for (const row of rows) {
+        tableInstance.push(row);
+    }
+    return tableInstance.toString();
+}
+/**
+ * Get a status icon
+ */
+export function statusIcon(type) {
+    if (config.noColor) {
+        switch (type) {
+            case "success":
+                return "[OK]";
+            case "error":
+                return "[FAIL]";
+            case "warning":
+                return "[WARN]";
+            case "pending":
+                return "[ ]";
+            case "running":
+                return "[..]";
+        }
+    }
+    switch (type) {
+        case "success":
+            return chalk.green("\u2713");
+        case "error":
+            return chalk.red("\u2717");
+        case "warning":
+            return chalk.yellow("\u26A0");
+        case "pending":
+            return chalk.gray("\u25CB");
+        case "running":
+            return chalk.cyan("\u25D0");
+    }
+}
+/**
+ * Print a status message with icon
+ */
+export function printStatus(type, message) {
+    if (config.jsonMode)
+        return;
+    console.log(`${statusIcon(type)} ${message}`);
+}
+// ============================================================================
+// Layout Utilities
+// ============================================================================
+/**
+ * Create a horizontal divider
+ */
+export function divider(width = 50) {
+    if (config.jsonMode)
+        return "";
+    const char = isLegacyWindows() ? "-" : "\u2501";
+    const line = char.repeat(width);
+    return config.noColor ? line : chalk.gray(line);
+}
+/**
+ * Create a section header
+ */
+export function sectionHeader(title) {
+    if (config.jsonMode)
+        return "";
+    const formattedTitle = config.noColor ? title : chalk.blue.bold(title);
+    return `\n${formattedTitle}\n${divider(title.length + 4)}\n`;
+}
+/**
+ * Display phase progress as a visual indicator
+ */
+export function phaseProgress(phases) {
+    if (config.jsonMode)
+        return "";
+    const icons = phases.map((phase) => {
+        switch (phase.status) {
+            case "success":
+                return config.noColor ? "[OK]" : chalk.green("\u25CF");
+            case "failure":
+                return config.noColor ? "[X]" : chalk.red("\u2717");
+            case "running":
+                return config.noColor ? "[..]" : chalk.cyan("\u25D0");
+            case "skipped":
+                return config.noColor ? "[-]" : chalk.gray("-");
+            default:
+                return config.noColor ? "[ ]" : chalk.gray("\u25CB");
+        }
+    });
+    const labels = phases.map((phase) => phase.name.charAt(0).toUpperCase());
+    return `  Phases: ${icons.join(" ")}\n          ${labels.join(" ")}`;
+}
+/**
+ * Create a progress bar
+ */
+export function progressBar(current, total, width = 20) {
+    if (config.jsonMode)
+        return "";
+    const percentage = total > 0 ? current / total : 0;
+    const filled = Math.round(percentage * width);
+    const empty = width - filled;
+    const filledChar = config.noColor || isLegacyWindows() ? "#" : "\u2588";
+    const emptyChar = config.noColor || isLegacyWindows() ? "-" : "\u2591";
+    const bar = filledChar.repeat(filled) + emptyChar.repeat(empty);
+    return config.noColor
+        ? bar
+        : chalk.green(filledChar.repeat(filled)) +
+            chalk.gray(emptyChar.repeat(empty));
+}
+// ============================================================================
+// Unified UI Namespace
+// ============================================================================
+/**
+ * Unified UI object for convenient access to all utilities
+ */
+export const ui = {
+    // Config
+    configure: configureUI,
+    getConfig: getUIConfig,
+    // Branding
+    logo,
+    banner,
+    // Spinners
+    spinner,
+    // Boxes
+    box,
+    successBox,
+    errorBox,
+    warningBox,
+    headerBox,
+    // Tables
+    table,
+    keyValueTable,
+    // Status
+    statusIcon,
+    printStatus,
+    // Layout
+    divider,
+    sectionHeader,
+    // Progress
+    phaseProgress,
+    progressBar,
+};
+export default ui;

package/dist/src/lib/content-analyzer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Content Analyzer for Phase Detection
+ *
+ * Analyzes issue title and body content to detect phase-relevant keywords
+ * and patterns. This supplements (not replaces) label-based detection.
+ *
+ * @example
+ * ```typescript
+ * import { analyzeTitleForPhases, analyzeBodyForPhases, analyzeContentForPhases } from './content-analyzer';
+ *
+ * const title = "Extract header component from main layout";
+ * const body = "Refactor the header.tsx file to create a reusable component...";
+ *
+ * const signals = analyzeContentForPhases(title, body);
+ * // Returns: { phases: ['test'], signals: [...], source: 'content' }
+ * ```
+ */
+import type { Phase } from "./workflow/types.js";
+/**
+ * A signal detected from content analysis
+ */
+export interface ContentSignal {
+    /** The phase this signal suggests */
+    phase: Phase | "quality-loop";
+    /** Where the signal was detected */
+    source: "title" | "body";
+    /** The pattern or keyword that matched */
+    pattern: string;
+    /** The actual text that matched */
+    match: string;
+    /** Confidence level of the signal */
+    confidence: "high" | "medium" | "low";
+    /** Human-readable reason for this signal */
+    reason: string;
+}
+/**
+ * Result of content analysis
+ */
+export interface ContentAnalysisResult {
+    /** Phases suggested by content analysis */
+    phases: Phase[];
+    /** Whether quality loop should be enabled */
+    qualityLoop: boolean;
+    /** Individual signals detected */
+    signals: ContentSignal[];
+    /** Notes about the analysis */
+    notes: string[];
+}
+/**
+ * Analyze issue title for phase-relevant keywords
+ *
+ * @param title - The issue title
+ * @returns Array of detected signals
+ */
+export declare function analyzeTitleForPhases(title: string): ContentSignal[];
+/**
+ * Analyze issue body for phase-relevant patterns
+ *
+ * @param body - The issue body
+ * @returns Array of detected signals
+ */
+export declare function analyzeBodyForPhases(body: string): ContentSignal[];
+/**
+ * Check if content indicates trivial work
+ *
+ * @param title - The issue title
+ * @param body - The issue body
+ * @returns True if the work appears trivial
+ */
+export declare function isTrivialWork(title: string, body: string): boolean;
+/**
+ * Analyze issue content (title + body) for phase recommendations
+ *
+ * This is the main entry point for content analysis.
+ * It analyzes both title and body, deduplicates signals,
+ * and returns a consolidated result.
+ *
+ * @param title - The issue title
+ * @param body - The issue body
+ * @returns Consolidated analysis result with phases and signals
+ */
+export declare function analyzeContentForPhases(title: string, body: string): ContentAnalysisResult;
+/**
+ * Format content analysis result for display
+ *
+ * @param result - The analysis result
+ * @returns Formatted markdown string
+ */
+export declare function formatContentAnalysis(result: ContentAnalysisResult): string;