arbiter-ai 1.0.0

package/dist/tui/screens/GitignoreCheck-termkit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Gitignore Check Screen (terminal-kit version)
+ *
+ * Checks if Arbiter's generated files are gitignored in the user's project.
+ * If not, prompts user to add them. Skips silently if not in a git repo.
+ */
+/**
+ * Shows the gitignore check prompt using terminal-kit.
+ * Skips silently if not in a git repo or files are already ignored.
+ *
+ * @returns Promise<void> - Resolves when check is complete
+ */
+export declare function checkGitignore(): Promise<void>;
+export default checkGitignore;

package/dist/tui/screens/GitignoreCheck-termkit.js

@@ -0,0 +1,185 @@
+/**
+ * Gitignore Check Screen (terminal-kit version)
+ *
+ * Checks if Arbiter's generated files are gitignored in the user's project.
+ * If not, prompts user to add them. Skips silently if not in a git repo.
+ */
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import termKit from 'terminal-kit';
+const term = termKit.terminal;
+// ANSI codes
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+const YELLOW = '\x1b[33m';
+const GREEN = '\x1b[32m';
+// Files that Arbiter creates and should be gitignored
+const ARBITER_FILES = ['.claude/.arbiter-session.json', '.claude/arbiter.tmp.log'];
+// What to append to .gitignore
+const GITIGNORE_ENTRIES = `
+# Arbiter
+.claude/.arbiter-session.json
+.claude/arbiter.tmp.log
+`;
+/**
+ * Check if we're in a git repository
+ * @returns The git root path, or null if not in a repo
+ */
+function getGitRoot() {
+    try {
+        const root = execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return root;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a file is gitignored
+ * @param filePath - Path to check (relative to git root)
+ * @returns true if ignored, false if not
+ */
+function isGitignored(filePath) {
+    try {
+        execSync(`git check-ignore -q ${filePath}`, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true; // exit code 0 = ignored
+    }
+    catch {
+        return false; // exit code 1 = not ignored
+    }
+}
+/**
+ * Append entries to .gitignore file
+ * @param gitRoot - Git repository root path
+ */
+function addToGitignore(gitRoot) {
+    const gitignorePath = path.join(gitRoot, '.gitignore');
+    // Append to existing or create new
+    fs.appendFileSync(gitignorePath, GITIGNORE_ENTRIES, 'utf-8');
+}
+/**
+ * Shows the gitignore check prompt using terminal-kit.
+ * Skips silently if not in a git repo or files are already ignored.
+ *
+ * @returns Promise<void> - Resolves when check is complete
+ */
+export async function checkGitignore() {
+    // Check if we're in a git repo
+    const gitRoot = getGitRoot();
+    if (!gitRoot) {
+        return; // Not a git repo, skip silently
+    }
+    // Check which files are not gitignored
+    const unignoredFiles = ARBITER_FILES.filter((file) => !isGitignored(file));
+    if (unignoredFiles.length === 0) {
+        return; // All files already ignored, skip silently
+    }
+    return new Promise((resolve) => {
+        // Initialize terminal
+        term.fullscreen(true);
+        term.hideCursor();
+        term.grabInput({ mouse: 'button' });
+        // Get terminal dimensions
+        let width = 180;
+        let height = 50;
+        if (typeof term.width === 'number' && Number.isFinite(term.width) && term.width > 0) {
+            width = term.width;
+        }
+        if (typeof term.height === 'number' && Number.isFinite(term.height) && term.height > 0) {
+            height = term.height;
+        }
+        // Content lines
+        const lines = [
+            "The Arbiter creates files that shouldn't be committed:",
+            '',
+            ...unignoredFiles.map((f) => `  ${f}`),
+            '',
+            'Add to .gitignore? [y/n]',
+        ];
+        // Calculate centering
+        const maxLineWidth = Math.max(...lines.map((l) => l.length));
+        const contentHeight = lines.length;
+        const startX = Math.max(1, Math.floor((width - maxLineWidth) / 2));
+        const startY = Math.max(1, Math.floor((height - contentHeight) / 2));
+        // Clear screen
+        term.clear();
+        // Draw content
+        lines.forEach((line, idx) => {
+            term.moveTo(startX, startY + idx);
+            if (idx === 0) {
+                // Header in yellow
+                process.stdout.write(`${YELLOW}${line}${RESET}`);
+            }
+            else if (line.startsWith('  ')) {
+                // File paths dimmed
+                process.stdout.write(`${DIM}${line}${RESET}`);
+            }
+            else if (line.includes('[y/n]')) {
+                // Prompt
+                process.stdout.write(line);
+            }
+            else {
+                process.stdout.write(line);
+            }
+        });
+        /**
+         * Cleanup and restore terminal
+         */
+        function cleanup() {
+            term.removeAllListeners('key');
+            term.grabInput(false);
+            term.fullscreen(false);
+            term.hideCursor(false);
+        }
+        /**
+         * Show brief success message
+         */
+        function showSuccess() {
+            const msg = 'Added to .gitignore';
+            const msgX = Math.max(1, Math.floor((width - msg.length) / 2));
+            const msgY = startY + lines.length + 1;
+            term.moveTo(msgX, msgY);
+            process.stdout.write(`${GREEN}${msg}${RESET}`);
+            // Brief pause so user sees the message
+            setTimeout(() => {
+                cleanup();
+                resolve();
+            }, 800);
+        }
+        // Handle key press
+        term.on('key', (key) => {
+            // Exit on quit keys
+            if (key === 'CTRL_C' || key === 'CTRL_Z') {
+                cleanup();
+                process.exit(0);
+            }
+            // Yes - add to gitignore
+            if (key === 'y' || key === 'Y') {
+                try {
+                    addToGitignore(gitRoot);
+                    showSuccess();
+                }
+                catch {
+                    // Failed to write, just continue
+                    cleanup();
+                    resolve();
+                }
+                return;
+            }
+            // No - skip
+            if (key === 'n' || key === 'N') {
+                cleanup();
+                resolve();
+                return;
+            }
+            // Ignore other keys - wait for y/n
+        });
+    });
+}
+export default checkGitignore;

package/dist/tui/screens/TitleScreen-termkit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Title Screen (terminal-kit version)
+ *
+ * Displays ASCII art title "The Arbiter" and continues on any key press.
+ * Uses terminal-kit for fullscreen rendering.
+ */
+/**
+ * Shows the title screen using terminal-kit.
+ * Continues to character select on any key press.
+ *
+ * @returns Promise<void> - Resolves when user presses any key
+ */
+export declare function showTitleScreen(): Promise<void>;
+export default showTitleScreen;

package/dist/tui/screens/TitleScreen-termkit.js

@@ -0,0 +1,132 @@
+/**
+ * Title Screen (terminal-kit version)
+ *
+ * Displays ASCII art title "The Arbiter" and continues on any key press.
+ * Uses terminal-kit for fullscreen rendering.
+ */
+import termKit from 'terminal-kit';
+import { playSfx } from '../../sound.js';
+const term = termKit.terminal;
+// ANSI codes
+const _BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+// Fire gradient colors (top = bright, bottom = dark)
+const FIRE_COLORS = [
+    '\x1b[97;1m', // bright white
+    '\x1b[93;1m', // bright yellow
+    '\x1b[93;1m', // bright yellow
+    '\x1b[33;1m', // yellow
+    '\x1b[33m', // dark yellow
+    '\x1b[38;5;208m', // orange
+    '\x1b[38;5;208m', // orange
+    '\x1b[38;5;202m', // dark orange
+    '\x1b[91m', // bright red
+    '\x1b[91m', // bright red
+    '\x1b[31m', // red
+    '\x1b[31m', // red
+    '\x1b[38;5;124m', // dark red
+    '\x1b[38;5;124m', // dark red
+];
+// ASCII art title (raw lines)
+const TITLE_ART = [
+    '                                                                                                                 ',
+    '  /###           /  /                            ##                     /                                        ',
+    ' /  ############/ #/                          /####                   #/          #                              ',
+    '/     #########   ##                         /  ###                   ##         ###     #                       ',
+    '#     /  #        ##                            /##                   ##          #     ##                       ',
+    ' ##  /  ##        ##                           /  ##                  ##                ##                       ',
+    '    /  ###        ##  /##      /##             /  ##     ###  /###    ## /###   ###   ######## /##  ###  /###    ',
+    '   ##   ##        ## / ###    / ###           /    ##     ###/ #### / ##/ ###  / ### ######## / ###  ###/ #### / ',
+    '   ##   ##        ##/   ###  /   ###          /    ##      ##   ###/  ##   ###/   ##    ##   /   ###  ##   ###/  ',
+    '   ##   ##        ##     ## ##    ###        /      ##     ##         ##    ##    ##    ##  ##    ### ##         ',
+    '   ##   ##        ##     ## ########         /########     ##         ##    ##    ##    ##  ########  ##         ',
+    '    ##  ##        ##     ## #######         /        ##    ##         ##    ##    ##    ##  #######   ##         ',
+    '     ## #      /  ##     ## ##              #        ##    ##         ##    ##    ##    ##  ##        ##         ',
+    '      ###     /   ##     ## ####    /      /####      ##   ##         ##    /#    ##    ##  ####    / ##         ',
+    '       ######/    ##     ##  ######/      /   ####    ## / ###         ####/      ### / ##   ######/  ###        ',
+    '         ###       ##    ##   #####      /     ##      #/   ###         ###        ##/   ##   #####    ###       ',
+    '                         /               #                                                                       ',
+    '                        /                 ##                                                                     ',
+    '                       /                                                                                         ',
+    '                      /                                                                                          ',
+];
+/**
+ * Shows the title screen using terminal-kit.
+ * Continues to character select on any key press.
+ *
+ * @returns Promise<void> - Resolves when user presses any key
+ */
+export async function showTitleScreen() {
+    return new Promise((resolve) => {
+        // Initialize terminal
+        term.fullscreen(true);
+        term.hideCursor();
+        term.grabInput({ mouse: 'button' });
+        // Get terminal dimensions
+        let width = 180;
+        let height = 50;
+        if (typeof term.width === 'number' && Number.isFinite(term.width) && term.width > 0) {
+            width = term.width;
+        }
+        if (typeof term.height === 'number' && Number.isFinite(term.height) && term.height > 0) {
+            height = term.height;
+        }
+        // Calculate centering
+        const artWidth = TITLE_ART[0].length;
+        const artHeight = TITLE_ART.length;
+        const contentHeight = artHeight + 4; // art + spacing + prompt
+        const startX = Math.max(1, Math.floor((width - artWidth) / 2));
+        const startY = Math.max(1, Math.floor((height - contentHeight) / 2));
+        // Clear screen
+        term.clear();
+        // Draw title art (diagonal fire gradient - ~25 degrees, top-left to bottom-right)
+        // Weight row more than col for shallower angle (row * 3 ≈ 25 degrees)
+        const rowWeight = 6;
+        const maxDiagonal = TITLE_ART.length * rowWeight + TITLE_ART[0].length;
+        for (let row = 0; row < TITLE_ART.length; row++) {
+            term.moveTo(startX, startY + row);
+            let line = '';
+            let lastColorIdx = -1;
+            for (let col = 0; col < TITLE_ART[row].length; col++) {
+                const diagonal = row * rowWeight + col;
+                const colorIdx = Math.min(Math.floor((diagonal / maxDiagonal) * FIRE_COLORS.length), FIRE_COLORS.length - 1);
+                // Only add color code when it changes
+                if (colorIdx !== lastColorIdx) {
+                    line += FIRE_COLORS[colorIdx];
+                    lastColorIdx = colorIdx;
+                }
+                line += TITLE_ART[row][col];
+            }
+            process.stdout.write(line + RESET);
+        }
+        // Draw prompt (dim, centered below art)
+        const prompt = 'Press any key to continue...';
+        const promptX = Math.max(1, Math.floor((width - prompt.length) / 2));
+        const promptY = startY + artHeight + 3;
+        term.moveTo(promptX, promptY);
+        process.stdout.write(`${DIM}${prompt}${RESET}`);
+        /**
+         * Cleanup and restore terminal
+         */
+        function cleanup() {
+            term.removeAllListeners('key');
+            term.grabInput(false);
+            term.fullscreen(false);
+            term.hideCursor(false);
+        }
+        // Handle any key press
+        term.on('key', (key) => {
+            // Exit on quit keys
+            if (key === 'CTRL_C' || key === 'CTRL_Z') {
+                cleanup();
+                process.exit(0);
+            }
+            // Any other key continues to character select
+            playSfx('menuSelect');
+            cleanup();
+            resolve();
+        });
+    });
+}
+export default showTitleScreen;

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

@@ -0,0 +1,9 @@
+/**
+ * Screen components re-export
+ *
+ * Terminal-kit based screen components for the TUI.
+ */
+export { showCharacterSelect } from './CharacterSelect-termkit.js';
+export { showForestIntro } from './ForestIntro-termkit.js';
+export { checkGitignore } from './GitignoreCheck-termkit.js';
+export { showTitleScreen } from './TitleScreen-termkit.js';

package/dist/tui/screens/index.js

@@ -0,0 +1,10 @@
+/**
+ * Screen components re-export
+ *
+ * Terminal-kit based screen components for the TUI.
+ */
+export { showCharacterSelect } from './CharacterSelect-termkit.js';
+export { showForestIntro } from './ForestIntro-termkit.js';
+export { checkGitignore } from './GitignoreCheck-termkit.js';
+// Terminal-kit screen components
+export { showTitleScreen } from './TitleScreen-termkit.js';

package/dist/tui/tileset.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Tileset loading and rendering utilities for the Arbiter TUI
+ *
+ * Provides functions for loading PNG tilesets, extracting individual tiles,
+ * compositing tiles together, and rendering them to ANSI terminal output.
+ */
+export declare const TILE_SIZE = 16;
+export declare const TILES_PER_ROW = 10;
+export declare const CHAR_HEIGHT = 8;
+export declare const RESET = "\u001B[0m";
+export declare const CLEAR_SCREEN = "\u001B[2J";
+export declare const CURSOR_HOME = "\u001B[H";
+export declare const HIDE_CURSOR = "\u001B[?25l";
+export declare const SHOW_CURSOR = "\u001B[?25h";
+export declare const TILE: {
+    readonly GRASS: 50;
+    readonly GRASS_SPARSE: 51;
+    readonly PINE_TREE: 57;
+    readonly BARE_TREE: 58;
+    readonly CAULDRON: 86;
+    readonly CAMPFIRE: 87;
+    readonly SMOKE: 90;
+    readonly SPELLBOOK: 102;
+    readonly HUMAN_1: 190;
+    readonly HUMAN_2: 191;
+    readonly HUMAN_3: 192;
+    readonly HUMAN_4: 193;
+    readonly HUMAN_5: 194;
+    readonly HUMAN_6: 195;
+    readonly HUMAN_7: 196;
+    readonly HUMAN_8: 197;
+    readonly ARBITER: 205;
+    readonly DEMON_1: 220;
+    readonly DEMON_2: 221;
+    readonly DEMON_3: 222;
+    readonly DEMON_4: 223;
+    readonly DEMON_5: 224;
+    readonly FOCUS: 270;
+    readonly CHAT_BUBBLE_QUARTERS: 267;
+    readonly ALERT_QUARTERS: 268;
+    readonly SCROLL: 124;
+};
+export type QuarterPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export interface Tileset {
+    width: number;
+    height: number;
+    data: Buffer;
+}
+/**
+ * Load the tileset PNG and return cached data
+ */
+export declare function loadTileset(): Promise<Tileset>;
+/**
+ * Extract a 16x16 tile by index from the tileset
+ */
+export declare function extractTile(tileset: Tileset, index: number): RGB[][];
+/**
+ * Composite foreground tile on background tile using alpha threshold
+ * Pixels with alpha below threshold use the background pixel
+ */
+export declare function compositeTiles(fg: RGB[][], bg: RGB[][], alphaThreshold: number): RGB[][];
+/**
+ * Composite focus overlay on character tile
+ * The focus overlay has transparent center, only the corner brackets show
+ */
+export declare function compositeWithFocus(charPixels: RGB[][], focusPixels: RGB[][], alphaThreshold?: number): RGB[][];
+/**
+ * Mirror a tile horizontally (flip left-right)
+ */
+export declare function mirrorTile(pixels: RGB[][]): RGB[][];
+/**
+ * Extract an 8x8 quarter from a 16x16 tile
+ * @param pixels The full 16x16 tile pixels
+ * @param quarter Which quarter to extract
+ * @returns 8x8 pixel array
+ */
+export declare function extractQuarterTile(pixels: RGB[][], quarter: QuarterPosition): RGB[][];
+/**
+ * Composite an 8x8 quarter tile onto a specific corner of a 16x16 tile
+ * @param base The full 16x16 tile pixels (will be cloned, not mutated)
+ * @param quarter The 8x8 quarter tile to overlay
+ * @param position Where to place the quarter tile
+ * @param alphaThreshold Pixels with alpha below this use the base pixel
+ * @returns New 16x16 pixel array with quarter composited
+ */
+export declare function compositeQuarterTile(base: RGB[][], quarter: RGB[][], position: QuarterPosition, alphaThreshold?: number): RGB[][];
+/**
+ * Render a tile to ANSI string array (16 chars wide x 8 rows)
+ * Uses half-block characters for 2:1 vertical compression
+ */
+export declare function renderTile(pixels: RGB[][]): string[];