magi-ai 0.1.0

package/dist/src/tui/animations.js

@@ -0,0 +1,167 @@
+/**
+ * Animation controller for TUI effects.
+ * Manages breathing, cascade, flash, and overlay animations.
+ */
+import { isApproval, isRejection } from '../types/consensus.js';
+// ── Constants ───────────────────────────────────────────────
+const BREATHING_INTERVAL_MS = 62; // ~16fps
+const BREATHING_CYCLE_MS = 2600;
+const FLASH_INTERVAL_MS = 150;
+const FLASH_COUNT = 3;
+// ── Animation Controller ────────────────────────────────────
+export class AnimationController {
+    timers = new Map();
+    disposed = false;
+    /**
+     * Start breathing animation for a unit.
+     * Calls onFrame with a phase value (0.0 ~ 1.0) cycling at ~16fps.
+     */
+    startBreathing(unitId, onFrame) {
+        this.startBreathingWithOffset(unitId, 0, onFrame);
+    }
+    startBreathingWithOffset(unitId, phaseOffset, onFrame) {
+        this.stopBreathing(unitId);
+        if (this.disposed)
+            return;
+        let phase = phaseOffset % 1.0;
+        const step = BREATHING_INTERVAL_MS / BREATHING_CYCLE_MS;
+        const timer = setInterval(() => {
+            phase = (phase + step) % 1.0;
+            onFrame(phase);
+        }, BREATHING_INTERVAL_MS);
+        this.timers.set(`breath:${unitId}`, timer);
+    }
+    /** Stop breathing animation for a unit. */
+    stopBreathing(unitId) {
+        const key = `breath:${unitId}`;
+        const timer = this.timers.get(key);
+        if (timer) {
+            clearInterval(timer);
+            this.timers.delete(key);
+        }
+    }
+    /**
+     * Cascade reveal: call onReveal for each unit with a staggered delay.
+     * Returns a promise that resolves when all reveals are done.
+     */
+    async cascade(units, onReveal) {
+        if (this.disposed)
+            return;
+        for (let i = 0; i < units.length; i++) {
+            if (this.disposed)
+                return;
+            onReveal(units[i]);
+            if (i < units.length - 1) {
+                await sleep(cascadeDelayMs(i, units.length));
+            }
+        }
+    }
+    /**
+     * BERSERK flash: toggle red flash on/off multiple times.
+     */
+    async berserkFlash(onFlash) {
+        if (this.disposed)
+            return;
+        for (let i = 0; i < FLASH_COUNT; i++) {
+            if (this.disposed)
+                return;
+            onFlash(true);
+            await sleep(FLASH_INTERVAL_MS);
+            if (this.disposed)
+                return;
+            onFlash(false);
+            await sleep(FLASH_INTERVAL_MS);
+        }
+    }
+    /**
+     * UNANIMOUS reveal: show overlay text after a brief pause.
+     */
+    async unanimousReveal(decision, onOverlay) {
+        if (this.disposed)
+            return;
+        await sleep(400);
+        if (this.disposed)
+            return;
+        const approve = isApproval(decision);
+        const text = approve ? '可 決' : '否 決';
+        onOverlay(text, approve);
+    }
+    async verdictLock(decision, onOverlay) {
+        if (this.disposed)
+            return;
+        const tone = isApproval(decision) ? 'approve' : isRejection(decision) ? 'reject' : 'deadlock';
+        const text = tone === 'approve' ? '可　決' : tone === 'reject' ? '否　決' : '膠　着';
+        const timings = verdictTiming(tone);
+        for (const timing of timings) {
+            onOverlay(text, tone, false);
+            await sleep(timing.onMs);
+            if (timing.offMs > 0) {
+                onOverlay(text, tone, true);
+                await sleep(timing.offMs);
+            }
+            if (this.disposed)
+                return;
+        }
+        onOverlay(text, tone, false);
+    }
+    async linePulse(length, onPulse) {
+        if (this.disposed)
+            return;
+        for (let i = 0; i < length; i++) {
+            if (this.disposed)
+                return;
+            onPulse(i);
+            await sleep(linePulseDelay(i, length));
+        }
+    }
+    /** Stop all animations and prevent new ones. */
+    dispose() {
+        this.disposed = true;
+        for (const timer of this.timers.values()) {
+            clearInterval(timer);
+        }
+        this.timers.clear();
+    }
+    /** Check if a breathing animation is active. */
+    isBreathing(unitId) {
+        return this.timers.has(`breath:${unitId}`);
+    }
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function cascadeDelayMs(index, total) {
+    if (total <= 1)
+        return 0;
+    const progress = index / Math.max(1, total - 1);
+    return Math.round(90 + progress * 110);
+}
+function linePulseDelay(index, total) {
+    if (total <= 1)
+        return 28;
+    const progress = index / Math.max(1, total - 1);
+    return Math.round(18 + Math.sin(progress * Math.PI) * 18);
+}
+function verdictTiming(tone) {
+    switch (tone) {
+        case 'approve':
+            return [
+                { onMs: 180, offMs: 70 },
+                { onMs: 150, offMs: 80 },
+                { onMs: 260, offMs: 0 },
+            ];
+        case 'reject':
+            return [
+                { onMs: 110, offMs: 70 },
+                { onMs: 120, offMs: 70 },
+                { onMs: 200, offMs: 0 },
+            ];
+        default:
+            return [
+                { onMs: 130, offMs: 60 },
+                { onMs: 120, offMs: 60 },
+                { onMs: 120, offMs: 60 },
+                { onMs: 220, offMs: 0 },
+            ];
+    }
+}

package/dist/src/tui/ansi.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ANSI escape code constants and helpers.
+ * Low-level terminal control — chalk doesn't cover cursor movement or screen control.
+ */
+export declare const ALT_SCREEN_ENTER = "\u001B[?1049h";
+export declare const ALT_SCREEN_LEAVE = "\u001B[?1049l";
+export declare const CURSOR_HIDE = "\u001B[?25l";
+export declare const CURSOR_SHOW = "\u001B[?25h";
+export declare const CLEAR_SCREEN = "\u001B[2J";
+export declare const CURSOR_HOME = "\u001B[H";
+export declare function moveTo(row: number, col: number): string;
+export declare function moveUp(n: number): string;
+export declare function moveDown(n: number): string;
+export declare function moveRight(n: number): string;
+export declare function moveLeft(n: number): string;
+export declare const ERASE_LINE = "\u001B[2K";
+export declare const ERASE_TO_END = "\u001B[0J";
+export declare const RESET = "\u001B[0m";
+export declare const BOLD = "\u001B[1m";
+export declare const DIM = "\u001B[2m";
+export declare const ITALIC = "\u001B[3m";
+export declare const UNDERLINE = "\u001B[4m";
+export declare const BLINK = "\u001B[5m";
+export declare const REVERSE = "\u001B[7m";
+export declare function fg(r: number, g: number, b: number): string;
+export declare function bg(r: number, g: number, b: number): string;
+export declare const SYNC_BEGIN = "\u001B[?2026h";
+export declare const SYNC_END = "\u001B[?2026l";

package/dist/src/tui/ansi.js

@@ -0,0 +1,51 @@
+/**
+ * ANSI escape code constants and helpers.
+ * Low-level terminal control — chalk doesn't cover cursor movement or screen control.
+ */
+const ESC = '\x1b';
+const CSI = `${ESC}[`;
+// ── Screen control ──────────────────────────────────────────
+export const ALT_SCREEN_ENTER = `${CSI}?1049h`;
+export const ALT_SCREEN_LEAVE = `${CSI}?1049l`;
+export const CURSOR_HIDE = `${CSI}?25l`;
+export const CURSOR_SHOW = `${CSI}?25h`;
+export const CLEAR_SCREEN = `${CSI}2J`;
+export const CURSOR_HOME = `${CSI}H`;
+// ── Cursor movement (1-based row/col) ───────────────────────
+export function moveTo(row, col) {
+    return `${CSI}${row};${col}H`;
+}
+export function moveUp(n) {
+    return n > 0 ? `${CSI}${n}A` : '';
+}
+export function moveDown(n) {
+    return n > 0 ? `${CSI}${n}B` : '';
+}
+export function moveRight(n) {
+    return n > 0 ? `${CSI}${n}C` : '';
+}
+export function moveLeft(n) {
+    return n > 0 ? `${CSI}${n}D` : '';
+}
+// ── Erase ───────────────────────────────────────────────────
+export const ERASE_LINE = `${CSI}2K`;
+export const ERASE_TO_END = `${CSI}0J`;
+// ── Text attributes ─────────────────────────────────────────
+export const RESET = `${CSI}0m`;
+export const BOLD = `${CSI}1m`;
+export const DIM = `${CSI}2m`;
+export const ITALIC = `${CSI}3m`;
+export const UNDERLINE = `${CSI}4m`;
+export const BLINK = `${CSI}5m`;
+export const REVERSE = `${CSI}7m`;
+// ── True Color (24-bit RGB) ─────────────────────────────────
+export function fg(r, g, b) {
+    return `${CSI}38;2;${r};${g};${b}m`;
+}
+export function bg(r, g, b) {
+    return `${CSI}48;2;${r};${g};${b}m`;
+}
+// ── Synchronized output (DEC Mode 2026) ─────────────────────
+// Prevents tearing on supported terminals; ignored on unsupported ones.
+export const SYNC_BEGIN = `${CSI}?2026h`;
+export const SYNC_END = `${CSI}?2026l`;

package/dist/src/tui/boot-sequence.d.ts

@@ -0,0 +1,11 @@
+/**
+ * NERV-style boot sequence animation.
+ * Displays a UNIX bootstrap dump before the main TUI layout appears.
+ */
+export interface BootSequenceOptions {
+    write: (s: string) => void;
+    cols: number;
+    rows: number;
+    skipAnimation?: boolean;
+}
+export declare function runBootSequence(options: BootSequenceOptions): Promise<void>;

package/dist/src/tui/boot-sequence.js

@@ -0,0 +1,98 @@
+/**
+ * NERV-style boot sequence animation.
+ * Displays a UNIX bootstrap dump before the main TUI layout appears.
+ */
+import { ALT_SCREEN_ENTER, CURSOR_HIDE, CLEAR_SCREEN, CURSOR_HOME, fg, bg, RESET, BOLD, DIM, REVERSE } from './ansi.js';
+import { EVA_PALETTE } from './colors.js';
+const READY_BOX_WIDTH = 38;
+// ── Boot lines ──────────────────────────────────────────────
+const BOOT_LINES = [
+    { text: '', delay: 100 },
+    { text: 'MAGI SYSTEM v0.1.0 (Build 2015-EVA)', delay: 60, color: 'orange' },
+    { text: 'Copyright (c) GEHIRN / NERV — Not for distribution', delay: 40, color: 'dim' },
+    { text: '', delay: 80 },
+    { text: 'POST: Memory test .............. 262144K OK', delay: 50 },
+    { text: 'POST: Persona matrix check ..... 3 units found', delay: 50 },
+    { text: '', delay: 60 },
+    { text: 'Initializing MELCHIOR-1 ........ ', delay: 70 },
+    { text: '  [ONLINE] Scientist persona loaded', delay: 40, color: 'green' },
+    { text: 'Initializing BALTHASAR-2 ....... ', delay: 70 },
+    { text: '  [ONLINE] Pragmatist persona loaded', delay: 40, color: 'green' },
+    { text: 'Initializing CASPER-3 .......... ', delay: 70 },
+    { text: '  [ONLINE] Reviewer persona loaded', delay: 40, color: 'green' },
+    { text: '', delay: 80 },
+    { text: 'Loading consensus protocol ...... ACTIVE', delay: 50 },
+    { text: 'Synchronization rate ........... NOMINAL (50.0%)', delay: 50 },
+    { text: 'A.T. Field barrier ............. ACTIVE (Level 1)', delay: 50, color: 'green' },
+    { text: 'Umbilical cable ................ ALL CONNECTED', delay: 50, color: 'green' },
+    { text: 'Gospel chronicle ............... INITIALIZED', delay: 40 },
+    { text: 'Dummy plug system .............. STANDBY', delay: 40, color: 'dim' },
+    { text: '', delay: 60 },
+    { text: 'WARNING: Berserk threshold set to 4.0', delay: 30, color: 'red' },
+    { text: '', delay: 80 },
+    { text: renderReadyBoxBorder('╔', '╗'), delay: 50, color: 'orange' },
+    { text: renderReadyBoxLine('M A G I  S Y S T E M'), delay: 50, color: 'orange' },
+    { text: renderReadyBoxLine('MELCHIOR-1 / BALTHASAR-2'), delay: 50, color: 'orange' },
+    { text: renderReadyBoxLine('/ CASPER-3 ONLINE /'), delay: 50, color: 'orange' },
+    { text: renderReadyBoxBorder('╚', '╝'), delay: 50, color: 'orange' },
+    { text: '', delay: 100 },
+    { text: '                     提 訴   /   決 議', delay: 80, color: 'orange' },
+    { text: '', delay: 80 },
+    { text: 'MAGI SYSTEM READY', delay: 80, color: 'green' },
+    { text: '', delay: 300 },
+];
+// ── Boot sequence runner ────────────────────────────────────
+export async function runBootSequence(options) {
+    const { write, skipAnimation } = options;
+    // Enter alternate screen
+    write(ALT_SCREEN_ENTER + CURSOR_HIDE + CLEAR_SCREEN + CURSOR_HOME);
+    if (skipAnimation)
+        return;
+    const gc = EVA_PALETTE.scanline;
+    const oc = EVA_PALETTE.frame;
+    const rc = EVA_PALETTE.warning;
+    for (const line of BOOT_LINES) {
+        let colored;
+        switch (line.color) {
+            case 'green':
+                colored = `${fg(gc.r, gc.g, gc.b)}${line.text}${RESET}`;
+                break;
+            case 'orange':
+                colored = `${fg(oc.r, oc.g, oc.b)}${BOLD}${line.text}${RESET}`;
+                break;
+            case 'dim':
+                colored = `${DIM}${line.text}${RESET}`;
+                break;
+            case 'red':
+                colored = `${fg(rc.r, rc.g, rc.b)}${line.text}${RESET}`;
+                break;
+            default:
+                colored = `${fg(gc.r, gc.g, gc.b)}${DIM}${line.text}${RESET}`;
+                break;
+        }
+        write(colored + '\r\n');
+        // Random jitter on delay for realism
+        const jitter = Math.floor(Math.random() * 30) - 15;
+        await sleep(Math.max(10, line.delay + jitter));
+    }
+    await flashTransition(write);
+    // Brief pause, then clear for main layout
+    await sleep(200);
+    write(CLEAR_SCREEN + CURSOR_HOME);
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function renderReadyBoxBorder(left, right) {
+    return `  ${left}${'═'.repeat(READY_BOX_WIDTH)}${right}`;
+}
+function renderReadyBoxLine(text) {
+    return `  ║${text.padStart(Math.floor((READY_BOX_WIDTH + text.length) / 2)).padEnd(READY_BOX_WIDTH)}║`;
+}
+async function flashTransition(write) {
+    const c = EVA_PALETTE.frame;
+    const bgc = EVA_PALETTE.background;
+    write(`${REVERSE}${fg(c.r, c.g, c.b)}${bg(bgc.r, bgc.g, bgc.b)}MAGI SYSTEM READY${RESET}\r\n`);
+    await sleep(80);
+    write(`${fg(c.r, c.g, c.b)}${BOLD}提 訴 / 決 議${RESET}\r\n`);
+}

package/dist/src/tui/colors.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Evangelion-inspired color palette and utilities.
+ */
+import chalk from 'chalk';
+export interface RGBColor {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+}
+export declare const EVA_PALETTE: {
+    readonly melchior: {
+        readonly r: 232;
+        readonly g: 66;
+        readonly b: 28;
+    };
+    readonly balthasar: {
+        readonly r: 86;
+        readonly g: 216;
+        readonly b: 126;
+    };
+    readonly casper: {
+        readonly r: 86;
+        readonly g: 171;
+        readonly b: 248;
+    };
+    readonly frame: {
+        readonly r: 255;
+        readonly g: 153;
+        readonly b: 52;
+    };
+    readonly background: {
+        readonly r: 6;
+        readonly g: 8;
+        readonly b: 11;
+    };
+    readonly scanline: {
+        readonly r: 118;
+        readonly g: 255;
+        readonly b: 168;
+    };
+    readonly textPrimary: {
+        readonly r: 255;
+        readonly g: 183;
+        readonly b: 74;
+    };
+    readonly textSecondary: {
+        readonly r: 255;
+        readonly g: 239;
+        readonly b: 214;
+    };
+    readonly warning: {
+        readonly r: 255;
+        readonly g: 88;
+        readonly b: 48;
+    };
+    readonly approve: {
+        readonly r: 132;
+        readonly g: 255;
+        readonly b: 138;
+    };
+    readonly reject: {
+        readonly r: 255;
+        readonly g: 112;
+        readonly b: 92;
+    };
+    readonly abstain: {
+        readonly r: 151;
+        readonly g: 159;
+        readonly b: 173;
+    };
+    readonly magi: {
+        readonly r: 255;
+        readonly g: 191;
+        readonly b: 72;
+    };
+    readonly grid: {
+        readonly r: 53;
+        readonly g: 33;
+        readonly b: 18;
+    };
+    readonly panelShade: {
+        readonly r: 18;
+        readonly g: 12;
+        readonly b: 10;
+    };
+    readonly stampGhost: {
+        readonly r: 92;
+        readonly g: 62;
+        readonly b: 36;
+    };
+};
+export declare function unitColor(unit: string): RGBColor;
+export declare function unitChalk(unit: string): ReturnType<typeof chalk.rgb>;
+export declare function voteColor(vote: string): RGBColor;
+export declare function colorFg(text: string, color: RGBColor): string;
+export declare function colorBg(text: string, fgColor: RGBColor, bgColor: RGBColor): string;
+/**
+ * Adjust brightness of a color (0.0 = black, 1.0 = original, >1.0 = brighter).
+ */
+export declare function adjustBrightness(color: RGBColor, factor: number): RGBColor;
+export declare function mixColors(base: RGBColor, accent: RGBColor, ratio: number): RGBColor;

package/dist/src/tui/colors.js

@@ -0,0 +1,71 @@
+/**
+ * Evangelion-inspired color palette and utilities.
+ */
+import chalk from 'chalk';
+import { fg, bg, RESET } from './ansi.js';
+export const EVA_PALETTE = {
+    melchior: { r: 232, g: 66, b: 28 }, // #E8421C — 赤
+    balthasar: { r: 86, g: 216, b: 126 }, // #56D87E — 緑
+    casper: { r: 86, g: 171, b: 248 }, // #56ABF8 — 青
+    frame: { r: 255, g: 153, b: 52 }, // #FF9934 — 橙
+    background: { r: 6, g: 8, b: 11 }, // #06080B — 深い黒
+    scanline: { r: 118, g: 255, b: 168 }, // #76FFA8 — 緑
+    textPrimary: { r: 255, g: 183, b: 74 }, // #FFB74A — 明橙
+    textSecondary: { r: 255, g: 239, b: 214 }, // #FFEFD6 — 温白
+    warning: { r: 255, g: 88, b: 48 }, // #FF5830 — 警告赤
+    approve: { r: 132, g: 255, b: 138 }, // #84FF8A — 承認緑
+    reject: { r: 255, g: 112, b: 92 }, // #FF705C — 否決赤
+    abstain: { r: 151, g: 159, b: 173 }, // #979FAD — 保留灰
+    magi: { r: 255, g: 191, b: 72 }, // #FFBF48 — MAGI node
+    grid: { r: 53, g: 33, b: 18 }, // #352112 — 暗い橙
+    panelShade: { r: 18, g: 12, b: 10 }, // #120C0A — 面の陰影
+    stampGhost: { r: 92, g: 62, b: 36 }, // #5C3E24 — 点滅時の残像
+};
+// ── Unit → Color mapping ────────────────────────────────────
+const UNIT_COLOR_MAP = {
+    MELCHIOR: EVA_PALETTE.melchior,
+    BALTHASAR: EVA_PALETTE.balthasar,
+    CASPER: EVA_PALETTE.casper,
+};
+export function unitColor(unit) {
+    return UNIT_COLOR_MAP[unit] ?? EVA_PALETTE.frame;
+}
+export function unitChalk(unit) {
+    const c = unitColor(unit);
+    return chalk.rgb(c.r, c.g, c.b);
+}
+// ── Vote → Color mapping ────────────────────────────────────
+export function voteColor(vote) {
+    switch (vote) {
+        case 'APPROVE': return EVA_PALETTE.approve;
+        case 'REJECT': return EVA_PALETTE.reject;
+        case 'ABSTAIN': return EVA_PALETTE.abstain;
+        default: return EVA_PALETTE.textSecondary;
+    }
+}
+// ── Colorize helpers (raw ANSI for ScreenBuffer) ────────────
+export function colorFg(text, color) {
+    return `${fg(color.r, color.g, color.b)}${text}${RESET}`;
+}
+export function colorBg(text, fgColor, bgColor) {
+    return `${fg(fgColor.r, fgColor.g, fgColor.b)}${bg(bgColor.r, bgColor.g, bgColor.b)}${text}${RESET}`;
+}
+/**
+ * Adjust brightness of a color (0.0 = black, 1.0 = original, >1.0 = brighter).
+ */
+export function adjustBrightness(color, factor) {
+    return {
+        r: Math.max(0, Math.min(255, Math.round(color.r * factor))),
+        g: Math.max(0, Math.min(255, Math.round(color.g * factor))),
+        b: Math.max(0, Math.min(255, Math.round(color.b * factor))),
+    };
+}
+export function mixColors(base, accent, ratio) {
+    const clamped = Math.max(0, Math.min(1, ratio));
+    const inv = 1 - clamped;
+    return {
+        r: Math.round(base.r * inv + accent.r * clamped),
+        g: Math.round(base.g * inv + accent.g * clamped),
+        b: Math.round(base.b * inv + accent.b * clamped),
+    };
+}

package/dist/src/tui/header.d.ts

@@ -0,0 +1,24 @@
+/**
+ * NERV-style header panel renderer.
+ * Displays deliberation metadata in Evangelion aesthetic.
+ */
+import type { ScreenBuffer } from './screen-buffer.js';
+import type { Rect } from './layout.js';
+export interface HeaderData {
+    taskTitle: string;
+    taskType: string;
+    deliberationId: string;
+    sourceLabel?: string;
+    priorityLabel?: string;
+    modeLabel?: string;
+    codeLabel?: string;
+}
+export interface VerdictStampData {
+    text: string;
+    tone: 'pending' | 'approve' | 'reject' | 'deadlock' | 'warning';
+    blink?: boolean;
+}
+export declare class HeaderRenderer {
+    drawHeader(buf: ScreenBuffer, rect: Rect, data: HeaderData): void;
+    drawVerdictStamp(buf: ScreenBuffer, rect: Rect, data: VerdictStampData): void;
+}

package/dist/src/tui/header.js

@@ -0,0 +1,122 @@
+/**
+ * NERV-style header panel renderer.
+ * Displays deliberation metadata in Evangelion aesthetic.
+ */
+import { BOX_DOUBLE } from './layout.js';
+import { EVA_PALETTE, mixColors } from './colors.js';
+import { ATTR_BOLD, stringDisplayWidth, truncateToDisplayWidth } from './screen-buffer.js';
+import { deriveSourceLabel as sharedDeriveSourceLabel, derivePriorityLabel as sharedDerivePriorityLabel } from './tui-helpers.js';
+// ── Header Renderer ─────────────────────────────────────────
+export class HeaderRenderer {
+    drawHeader(buf, rect, data) {
+        const fc = EVA_PALETTE.frame;
+        const tc = EVA_PALETTE.textPrimary;
+        const tw = EVA_PALETTE.textSecondary;
+        const { row, col, width } = rect;
+        const reservedStamp = width >= 72 ? 18 : 0;
+        const usableWidth = Math.max(16, width - reservedStamp - 4);
+        // Line 1: 「提 訴」 (left) and 「決 議」 (right)
+        const leftLabel = '提　訴';
+        const rightLabel = '決　議';
+        buf.writeAt(row, col + 2, leftLabel, fc.r, fc.g, fc.b, 0, 0, 0, ATTR_BOLD);
+        buf.writeAt(row, col + width - stringDisplayWidth(rightLabel) - 2, rightLabel, fc.r, fc.g, fc.b, 0, 0, 0, ATTR_BOLD);
+        // Line 2: Double-line separator
+        for (let x = col + 2; x < col + width - 2; x++) {
+            buf.writeAt(row + 1, x, BOX_DOUBLE.h, fc.r, fc.g, fc.b);
+        }
+        // Line 3: CODE + FILE + TYPE
+        const code = data.codeLabel ?? generateCode(data.deliberationId);
+        const idShort = data.deliberationId.slice(0, 8);
+        const source = data.sourceLabel ?? truncateToDisplayWidth(sharedDeriveSourceLabel(data.taskType, data.taskTitle), 18);
+        const meta = truncateToDisplayWidth(`CODE ${code}  •  FILE ${source}  •  TYPE ${data.taskType.toUpperCase()}`, usableWidth);
+        buf.writeAt(row + 2, col + 2, meta, tc.r, tc.g, tc.b);
+        // Line 4: PRIORITY + MODE + ID
+        const priority = data.priorityLabel ?? sharedDerivePriorityLabel(data.taskType);
+        const mode = data.modeLabel ?? 'NORMAL';
+        const instrumentation = truncateToDisplayWidth(`PRIORITY ${priority}  •  MODE ${mode}  •  ID ${idShort}`, usableWidth);
+        buf.writeAt(row + 3, col + 2, instrumentation, tc.r, tc.g, tc.b);
+        // Line 5: Task title (normalize whitespace from shell line-wrapping, then truncate)
+        const title = truncateToDisplayWidth(normalizeTitle(data.taskTitle), width - 6);
+        buf.writeAt(row + 4, col + 2, title, tw.r, tw.g, tw.b);
+    }
+    drawVerdictStamp(buf, rect, data) {
+        const c = verdictToneColor(data.tone);
+        const label = truncateToDisplayWidth(data.text, rect.width - 2);
+        const innerWidth = Math.max(1, rect.width - 2);
+        const leftPad = Math.max(0, Math.floor((innerWidth - stringDisplayWidth(label)) / 2));
+        const border = data.blink ? mixColors(EVA_PALETTE.background, EVA_PALETTE.stampGhost, 0.8) : c;
+        const fill = stampFillColor(data.tone);
+        for (let y = rect.row; y < rect.row + rect.height; y++) {
+            for (let x = rect.col; x < rect.col + rect.width; x++) {
+                buf.writeAt(y, x, ' ', EVA_PALETTE.textSecondary.r, EVA_PALETTE.textSecondary.g, EVA_PALETTE.textSecondary.b, fill.r, fill.g, fill.b);
+            }
+        }
+        if (rect.height >= 3 && rect.width >= 4) {
+            for (let x = rect.col; x < rect.col + rect.width; x++) {
+                buf.writeAt(rect.row, x, BOX_DOUBLE.h, border.r, border.g, border.b, fill.r, fill.g, fill.b);
+                buf.writeAt(rect.row + rect.height - 1, x, BOX_DOUBLE.h, border.r, border.g, border.b, fill.r, fill.g, fill.b);
+            }
+            buf.writeAt(rect.row, rect.col, BOX_DOUBLE.tl, border.r, border.g, border.b, fill.r, fill.g, fill.b);
+            buf.writeAt(rect.row, rect.col + rect.width - 1, BOX_DOUBLE.tr, border.r, border.g, border.b, fill.r, fill.g, fill.b);
+            buf.writeAt(rect.row + rect.height - 1, rect.col, BOX_DOUBLE.bl, border.r, border.g, border.b, fill.r, fill.g, fill.b);
+            buf.writeAt(rect.row + rect.height - 1, rect.col + rect.width - 1, BOX_DOUBLE.br, border.r, border.g, border.b, fill.r, fill.g, fill.b);
+            for (let y = rect.row + 1; y < rect.row + rect.height - 1; y++) {
+                buf.writeAt(y, rect.col, BOX_DOUBLE.v, border.r, border.g, border.b, fill.r, fill.g, fill.b);
+                buf.writeAt(y, rect.col + rect.width - 1, BOX_DOUBLE.v, border.r, border.g, border.b, fill.r, fill.g, fill.b);
+            }
+        }
+        if (!data.blink) {
+            buf.writeAt(rect.row + Math.floor(rect.height / 2), rect.col + 1 + leftPad, label, c.r, c.g, c.b, fill.r, fill.g, fill.b, ATTR_BOLD);
+        }
+    }
+}
+// CJK character range regex for detecting CJK-to-CJK spurious spaces
+const CJK = '\\u3000-\\u9FFF\\uF900-\\uFAFF\\u{20000}-\\u{2FA1F}';
+const CJK_SPACE_RE = new RegExp(`([${CJK}])\\s+([${CJK}])`, 'gu');
+/** Normalize title text for display: strip zero-width chars, collapse whitespace, remove CJK-internal spaces. */
+function normalizeTitle(raw) {
+    return raw
+        .replace(/[\u200B-\u200D\u2060\uFEFF]/g, '') // zero-width chars
+        .replace(/[\u00A0\u3000]/g, ' ') // NBSP + ideographic space → ASCII space
+        .replace(/\s+/g, ' ') // collapse whitespace
+        .replace(CJK_SPACE_RE, '$1$2') // remove space between CJK chars
+        .trim();
+}
+/**
+ * Generate a 3-digit code from deliberation ID hash (Eva aesthetic).
+ * Deterministic: same ID always produces same code.
+ */
+function generateCode(id) {
+    let hash = 0;
+    for (let i = 0; i < id.length; i++) {
+        hash = ((hash << 5) - hash + id.charCodeAt(i)) | 0;
+    }
+    const num = Math.abs(hash) % 1000;
+    return String(num).padStart(3, '0');
+}
+function verdictToneColor(tone) {
+    switch (tone) {
+        case 'approve':
+            return EVA_PALETTE.approve;
+        case 'reject':
+            return EVA_PALETTE.reject;
+        case 'deadlock':
+        case 'warning':
+            return EVA_PALETTE.warning;
+        default:
+            return EVA_PALETTE.frame;
+    }
+}
+function stampFillColor(tone) {
+    switch (tone) {
+        case 'approve':
+            return mixColors(EVA_PALETTE.background, EVA_PALETTE.approve, 0.16);
+        case 'reject':
+            return mixColors(EVA_PALETTE.background, EVA_PALETTE.reject, 0.18);
+        case 'deadlock':
+        case 'warning':
+            return mixColors(EVA_PALETTE.background, EVA_PALETTE.frame, 0.18);
+        default:
+            return mixColors(EVA_PALETTE.background, EVA_PALETTE.grid, 0.42);
+    }
+}

package/dist/src/tui/index.d.ts

@@ -0,0 +1,3 @@
+export { MagiTui, type MagiTuiOptions } from './magi-tui.js';
+export { detectCapabilities, isTuiCapable, tuiCheckFailure } from './terminal-detect.js';
+export { getTuiProfile, type TuiProfile } from './layout.js';