4runr-os 2.0.40 → 2.0.41

package/dist/ui/v5/debug/debugCommands.d.ts

@@ -0,0 +1,20 @@
+/**
+ * V5 Debug Commands
+ *
+ * dbg:size - Print size info to Operations panel (NOT stdout)
+ * dbg:layout - Toggle layout debug overlay
+ */
+import type { Widgets } from 'neo-blessed';
+import type { UIKernel } from '../kernel/kernel.js';
+import type { ResizeController } from '../resize/resizeController.js';
+export interface DebugCommandsContext {
+    screen: Widgets.Screen;
+    kernel: UIKernel;
+    resizeController: ResizeController;
+    operationsPanel?: Widgets.Box;
+}
+/**
+ * Handle debug command
+ */
+export declare function handleDebugCommand(command: string, context: DebugCommandsContext): boolean;
+//# sourceMappingURL=debugCommands.d.ts.map

package/dist/ui/v5/debug/debugCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugCommands.d.ts","sourceRoot":"","sources":["../../../../src/ui/v5/debug/debugCommands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;IACvB,MAAM,EAAE,QAAQ,CAAC;IACjB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAYT"}

package/dist/ui/v5/debug/debugCommands.js

@@ -0,0 +1,104 @@
+/**
+ * V5 Debug Commands
+ *
+ * dbg:size - Print size info to Operations panel (NOT stdout)
+ * dbg:layout - Toggle layout debug overlay
+ */
+import { getViewport } from '../viewport/getViewport.js';
+import { safeRender, getLayoutVersion } from '../renderGate.js';
+/**
+ * Handle debug command
+ */
+export function handleDebugCommand(command, context) {
+    if (command === 'dbg:size') {
+        handleDbgSize(context);
+        return true;
+    }
+    if (command === 'dbg:layout') {
+        handleDbgLayout(context);
+        return true;
+    }
+    return false;
+}
+/**
+ * Handle dbg:size command
+ *
+ * Print to Operations panel (NOT stdout):
+ * - screen.cols/rows
+ * - process.stdout.columns/rows
+ * - safeCols/safeRows
+ * - margins
+ * - TERM / platform
+ * - browserDetected true/false
+ */
+function handleDbgSize(context) {
+    const { screen, resizeController } = context;
+    const vp = getViewport(screen);
+    const stdoutCols = process.stdout.columns || 'N/A';
+    const stdoutRows = process.stdout.rows || 'N/A';
+    const term = process.env.TERM || 'N/A';
+    const platform = process.platform;
+    const lastCommitted = resizeController.getLastCommitted();
+    const burstCount = resizeController.getBurstCount();
+    const lastSource = resizeController.getLastSource();
+    const lastResizeTs = resizeController.getLastResizeTs();
+    const info = [
+        '=== V5 Size Debug ===',
+        `screen.cols: ${vp.cols}`,
+        `screen.rows: ${vp.rows}`,
+        `process.stdout.columns: ${stdoutCols}`,
+        `process.stdout.rows: ${stdoutRows}`,
+        `safeCols: ${vp.safeCols}`,
+        `safeRows: ${vp.safeRows}`,
+        `margins: R=${vp.marginRight}, B=${vp.marginBottom}`,
+        `TERM: ${term}`,
+        `platform: ${platform}`,
+        `browserDetected: ${vp.isBrowserTerminal}`,
+        `last committed: ${lastCommitted.cols}x${lastCommitted.rows}`,
+        `burstCount: ${burstCount}`,
+        `lastResizeTs: ${lastResizeTs ? new Date(lastResizeTs).toISOString() : 'N/A'}`,
+        `last source: ${lastSource}`,
+    ].join('\n');
+    // Print to operations panel if available, otherwise to stderr
+    if (context.operationsPanel) {
+        const currentContent = context.operationsPanel.content || '';
+        context.operationsPanel.setContent((currentContent ? currentContent + '\n\n' : '') + info);
+        // Show the panel when content is added
+        context.operationsPanel.hidden = false;
+        const currentVersion = getLayoutVersion();
+        safeRender(screen, currentVersion);
+    }
+    else {
+        // Fallback to stderr (not stdout!)
+        process.stderr.write(info + '\n');
+    }
+}
+/**
+ * Handle dbg:layout command
+ *
+ * Overlay mode:
+ * - shows mode normal/narrow
+ * - prints each rect: x,y,w,h, rightEdge, bottomEdge
+ * - prints burstCount + lastResizeTs
+ */
+function handleDbgLayout(context) {
+    const { kernel, resizeController, screen } = context;
+    const vp = getViewport(screen);
+    const layout = kernel.getLayout();
+    const version = resizeController.getLayoutVersion();
+    const burstCount = resizeController.getBurstCount();
+    const lastResizeTs = resizeController.getLastResizeTs();
+    const lastSource = resizeController.getLastSource();
+    // Build overlay content
+    const lines = [
+        `mode: ${layout.mode} | v${version} | burst: ${burstCount} | ts: ${lastResizeTs ? new Date(lastResizeTs).toISOString() : 'N/A'} | ${lastSource}`,
+    ];
+    // Print each rect
+    for (const [id, rect] of Object.entries(layout.rects)) {
+        const rightEdge = rect.x + rect.w;
+        const bottomEdge = rect.y + rect.h;
+        lines.push(`${id}: x=${rect.x} y=${rect.y} w=${rect.w} h=${rect.h} rightEdge=${rightEdge} bottomEdge=${bottomEdge}`);
+    }
+    kernel.toggleDebugOverlay(lines.join('\n'));
+}
+//# sourceMappingURL=debugCommands.js.map

package/dist/ui/v5/debug/debugCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugCommands.js","sourceRoot":"","sources":["../../../../src/ui/v5/debug/debugCommands.ts"],"names":[],"mappings":"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"}

package/dist/ui/v5/guardrails/stdoutGuard.d.ts

@@ -0,0 +1,23 @@
+/**
+ * V5 Stdout Guard - Hard Enforcement
+ *
+ * Monkeypatches process.stdout.write and console.log to prevent
+ * raw box-drawing characters from corrupting the TUI.
+ *
+ * During TUI runtime: block stdout writes (or redirect to stderr/file).
+ *
+ * Env escape hatch: TUI_ALLOW_STDOUT=1 disables blocking (default OFF).
+ */
+/**
+ * Initialize stdout guard
+ */
+export declare function initStdoutGuard(): void;
+/**
+ * Restore original stdout behavior
+ */
+export declare function restoreStdout(): void;
+/**
+ * Check if stdout guard is active
+ */
+export declare function isStdoutGuardActive(): boolean;
+//# sourceMappingURL=stdoutGuard.d.ts.map

package/dist/ui/v5/guardrails/stdoutGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdoutGuard.d.ts","sourceRoot":"","sources":["../../../../src/ui/v5/guardrails/stdoutGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAyCtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAiBpC;AAsBD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C"}

package/dist/ui/v5/guardrails/stdoutGuard.js

@@ -0,0 +1,94 @@
+/**
+ * V5 Stdout Guard - Hard Enforcement
+ *
+ * Monkeypatches process.stdout.write and console.log to prevent
+ * raw box-drawing characters from corrupting the TUI.
+ *
+ * During TUI runtime: block stdout writes (or redirect to stderr/file).
+ *
+ * Env escape hatch: TUI_ALLOW_STDOUT=1 disables blocking (default OFF).
+ */
+let stdoutGuardActive = false;
+let originalStdoutWrite;
+let originalConsoleLog;
+let warningLogged = false;
+let warningTimer = null;
+/**
+ * Initialize stdout guard
+ */
+export function initStdoutGuard() {
+    if (stdoutGuardActive) {
+        return; // Already active
+    }
+    // Check escape hatch
+    if (process.env.TUI_ALLOW_STDOUT === '1') {
+        return; // Guard disabled
+    }
+    stdoutGuardActive = true;
+    // Store originals
+    originalStdoutWrite = process.stdout.write.bind(process.stdout);
+    originalConsoleLog = console.log;
+    // Monkeypatch process.stdout.write
+    process.stdout.write = function (chunk, encoding, callback) {
+        // Log warning (debounced)
+        logWarningOnce();
+        // Redirect to stderr or file
+        const str = typeof chunk === 'string' ? chunk : chunk.toString();
+        process.stderr.write(`[V5 BLOCKED stdout.write] ${str}`);
+        // Call callback if provided
+        if (typeof callback === 'function') {
+            callback(null);
+        }
+        return true; // Pretend write succeeded
+    };
+    // Monkeypatch console.log
+    console.log = (...args) => {
+        // Log warning (debounced)
+        logWarningOnce();
+        // Redirect to stderr
+        const message = args.map(a => String(a)).join(' ');
+        process.stderr.write(`[V5 BLOCKED console.log] ${message}\n`);
+    };
+}
+/**
+ * Restore original stdout behavior
+ */
+export function restoreStdout() {
+    if (!stdoutGuardActive) {
+        return;
+    }
+    stdoutGuardActive = false;
+    // Restore originals
+    process.stdout.write = originalStdoutWrite;
+    console.log = originalConsoleLog;
+    // Clear warning timer
+    if (warningTimer) {
+        clearTimeout(warningTimer);
+        warningTimer = null;
+    }
+    warningLogged = false;
+}
+/**
+ * Log warning once (debounced)
+ */
+function logWarningOnce() {
+    if (warningLogged) {
+        return;
+    }
+    if (warningTimer) {
+        clearTimeout(warningTimer);
+    }
+    warningTimer = setTimeout(() => {
+        if (!warningLogged) {
+            process.stderr.write('[V5] Stdout guard active - stdout writes blocked. Set TUI_ALLOW_STDOUT=1 to disable.\n');
+            warningLogged = true;
+        }
+    }, 1000); // Debounce 1 second
+}
+/**
+ * Check if stdout guard is active
+ */
+export function isStdoutGuardActive() {
+    return stdoutGuardActive;
+}
+//# sourceMappingURL=stdoutGuard.js.map

package/dist/ui/v5/guardrails/stdoutGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdoutGuard.js","sourceRoot":"","sources":["../../../../src/ui/v5/guardrails/stdoutGuard.ts"],"names":[],"mappings":"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"}

package/dist/ui/v5/guardrails/terminalRestore.d.ts

@@ -0,0 +1,17 @@
+/**
+ * V5 Terminal Restore
+ *
+ * Ensures terminal is restored to usable state on exit.
+ *
+ * On exit (SIGINT, uncaughtException, unhandledRejection):
+ * - call screen.destroy()
+ * - show cursor
+ * - reset colors if needed
+ * - ensure input echo returns
+ */
+import type { Widgets } from 'neo-blessed';
+/**
+ * Restore terminal to normal state
+ */
+export declare function restoreTerminal(screen: Widgets.Screen | null): void;
+//# sourceMappingURL=terminalRestore.d.ts.map

package/dist/ui/v5/guardrails/terminalRestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalRestore.d.ts","sourceRoot":"","sources":["../../../../src/ui/v5/guardrails/terminalRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAkCnE"}

package/dist/ui/v5/guardrails/terminalRestore.js

@@ -0,0 +1,47 @@
+/**
+ * V5 Terminal Restore
+ *
+ * Ensures terminal is restored to usable state on exit.
+ *
+ * On exit (SIGINT, uncaughtException, unhandledRejection):
+ * - call screen.destroy()
+ * - show cursor
+ * - reset colors if needed
+ * - ensure input echo returns
+ */
+/**
+ * Restore terminal to normal state
+ */
+export function restoreTerminal(screen) {
+    if (!screen) {
+        return;
+    }
+    try {
+        const program = screen.program;
+        // Show cursor
+        if (program && typeof program.showCursor === 'function') {
+            program.showCursor();
+        }
+        // Reset colors
+        if (program && typeof program.reset === 'function') {
+            program.reset();
+        }
+        // Destroy screen
+        if (typeof screen.destroy === 'function') {
+            screen.destroy();
+        }
+    }
+    catch (e) {
+        // Ignore errors during cleanup
+    }
+    // Restore stdin
+    try {
+        if (process.stdin.isTTY && process.stdin.isRaw) {
+            process.stdin.setRawMode(false);
+        }
+    }
+    catch (e) {
+        // Ignore errors
+    }
+}
+//# sourceMappingURL=terminalRestore.js.map

package/dist/ui/v5/guardrails/terminalRestore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalRestore.js","sourceRoot":"","sources":["../../../../src/ui/v5/guardrails/terminalRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAI,MAAc,CAAC,OAAO,CAAC;QAExC,cAAc;QACd,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACxD,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,CAAC;QAED,eAAe;QACf,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,+BAA+B;IACjC,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,gBAAgB;IAClB,CAAC;AACH,CAAC"}

package/dist/ui/v5/index.d.ts

@@ -2,11 +2,21 @@
 /**
  * V5 TUI - Display Kernel Entry Point
  *
- * Phase 1: Runtime Guardrails + Atomic Resize
+ * Phase A: Hard Guardrails
  * - Stdout guard (prevents glyph soup)
- * - Keep-alive (prevents black screen)
  * - Terminal restore (always restores terminal)
- * - Atomic resize (no duplicate borders, no ghosts)
+ *
+ * Phase B: Safe Viewport (scrollbar killer)
+ * - Proper browser terminal detection
+ * - Safe margins with env override
+ *
+ * Phase C: Layout Engine
+ * - Normal/narrow modes
+ * - Clamped rects (no overflow ever)
+ *
+ * Phase D: Atomic Resize
+ * - Debounced resize handling
+ * - Atomic rebuild (no ghosts/duplicates)
  *
  * Boot with: TUI_V5=1
  */

package/dist/ui/v5/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/v5/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAeH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,2BAA2B,EAAE,OAAO,GAAG,SAAS,CAAC;CACtD;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAoKlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/v5/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAcH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,2BAA2B,EAAE,OAAO,GAAG,SAAS,CAAC;CACtD;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAqKlD"}

package/dist/ui/v5/index.js

@@ -2,52 +2,55 @@
 /**
  * V5 TUI - Display Kernel Entry Point
  *
- * Phase 1: Runtime Guardrails + Atomic Resize
+ * Phase A: Hard Guardrails
  * - Stdout guard (prevents glyph soup)
- * - Keep-alive (prevents black screen)
  * - Terminal restore (always restores terminal)
- * - Atomic resize (no duplicate borders, no ghosts)
+ *
+ * Phase B: Safe Viewport (scrollbar killer)
+ * - Proper browser terminal detection
+ * - Safe margins with env override
+ *
+ * Phase C: Layout Engine
+ * - Normal/narrow modes
+ * - Clamped rects (no overflow ever)
+ *
+ * Phase D: Atomic Resize
+ * - Debounced resize handling
+ * - Atomic rebuild (no ghosts/duplicates)
  *
  * Boot with: TUI_V5=1
  */
 import blessed from 'neo-blessed';
-import { initStdoutGuard, restoreStdout } from './runtime/stdoutGuard.js';
+import { initStdoutGuard, restoreStdout } from './guardrails/stdoutGuard.js';
+import { restoreTerminal } from './guardrails/terminalRestore.js';
 import { attachRuntime, detachRuntime } from './runtime/keepAlive.js';
-import { restoreTerminal } from './runtime/restoreTerminal.js';
-import { safeStderrWrite } from './runtime/stdoutGuard.js';
-import { UIKernel } from './kernel.js';
-import { ResizeController } from './resizeController.js';
+import { UIKernel } from './kernel/kernel.js';
+import { ResizeController } from './resize/resizeController.js';
 import { safeRender, getLayoutVersion } from './renderGate.js';
-import { handleDebugCommand } from './debugCommands.js';
+import { handleDebugCommand } from './debug/debugCommands.js';
 /**
  * Start V5 TUI Display Kernel
  */
 export async function startV5Shell() {
     // Check TTY before booting
     if (!process.stdout.isTTY) {
-        console.log('V5 TUI requires a TTY. Exiting.');
+        process.stderr.write('V5 TUI requires a TTY. Exiting.\n');
         process.exit(1);
     }
     // Singleton guard - prevent multiple instances
     if (globalThis.__FOURRUNR_V5_TUI_RUNNING__) {
-        safeStderrWrite('[V5] Already running - ignoring\n');
+        process.stderr.write('[V5] Already running - ignoring\n');
         return;
     }
     // Mark as running BEFORE any UI code executes
     globalThis.__FOURRUNR_V5_TUI_RUNNING__ = true;
-    // CRITICAL: Initialize stdout guard BEFORE creating screen
-    // This prevents any stdout pollution from corrupting the TUI
-    // TUI_DEBUG=1 -> redirects to /tmp/tui_v5.log
-    initStdoutGuard({
-        strict: process.env.TUI_STRICT === '1',
-        logFile: process.env.TUI_V5_LOG_FILE,
-    });
+    // Phase A1: Initialize stdout guard BEFORE creating screen
+    initStdoutGuard();
     let screen = null;
     let kernel = null;
     let resizeController = null;
     try {
         // CRITICAL: Prepare stdin BEFORE creating screen
-        // This ensures stdin owns the event loop
         process.stdin.resume();
         if (process.stdin.isTTY && !process.stdin.isRaw) {
             process.stdin.setRawMode(true);
@@ -56,13 +59,12 @@ export async function startV5Shell() {
         screen = blessed.screen({
             smartCSR: true,
             fastCSR: false,
-            title: '4Runr OS - V5 Kernel (Phase 1)',
-            fullUnicode: false, // Start conservative
-            autoPadding: false, // CRITICAL: No padding - use full width
+            title: '4Runr OS - V5 Kernel',
+            fullUnicode: false,
+            autoPadding: false,
             dockBorders: false,
         });
         // CRITICAL: Attach runtime keep-alive AFTER screen creation
-        // This sets up signal handlers and event loop anchor
         attachRuntime(screen);
         // Hide cursor initially
         const program = screen.program;
@@ -78,8 +80,7 @@ export async function startV5Shell() {
         resizeController.start();
         // Boot kernel (initial mount)
         kernel.boot();
-        safeStderrWrite('[V5] Kernel started - guardrails active\n');
-        safeStderrWrite('[V5] Screen rendered - check for glyph corruption\n');
+        process.stderr.write('[V5] Kernel started - guardrails active\n');
         // Setup debug commands context
         const debugContext = {
             screen,
@@ -89,45 +90,42 @@ export async function startV5Shell() {
         };
         // Handle input - debug commands and Ctrl+C
         screen.key(['C-c'], () => {
-            safeStderrWrite('\n[V5] Ctrl+C pressed - exiting...\n');
+            process.stderr.write('\n[V5] Ctrl+C pressed - exiting...\n');
             cleanup();
             process.exit(0);
         });
         // Handle command input (for future use)
         const widgets = kernel.getWidgets();
-        if (widgets?.commandInput) {
-            // For now, handle input via key events since we're using Box instead of Textbox
-            widgets.commandInput.on('keypress', (ch, key) => {
+        if (widgets?.command) {
+            // For now, handle input via key events
+            widgets.command.on('keypress', (ch, key) => {
                 if (key.name === 'enter') {
-                    const value = widgets.commandInput.content || '';
+                    const value = widgets.command.content || '';
                     const command = String(value).trim();
                     // Handle debug commands
                     if (handleDebugCommand(command, debugContext)) {
                         // Command handled
-                        widgets.commandInput.setContent('');
+                        widgets.command.setContent('');
                         const currentVersion = getLayoutVersion();
                         safeRender(screen, currentVersion);
                         return;
                     }
                     // Future: handle other commands here
-                    widgets.commandInput.setContent('');
+                    widgets.command.setContent('');
                     const currentVersion = getLayoutVersion();
                     safeRender(screen, currentVersion);
                 }
             });
             // Focus command input
-            widgets.commandInput.focus();
+            widgets.command.focus?.();
         }
-        // All async renders must use safeRender
-        // Example: if you have eventBus or timers, they should call:
-        // safeRender(screen, getLayoutVersion());
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
         const errorStack = error instanceof Error ? error.stack : '';
-        safeStderrWrite(`\n[V5 INIT ERROR] ${errorMsg}\n`);
+        process.stderr.write(`\n[V5 INIT ERROR] ${errorMsg}\n`);
         if (errorStack) {
-            safeStderrWrite(`[V5 INIT ERROR] Stack: ${errorStack.split('\n').slice(0, 10).join('\n')}\n`);
+            process.stderr.write(`[V5 INIT ERROR] Stack: ${errorStack.split('\n').slice(0, 10).join('\n')}\n`);
         }
         cleanup();
         process.exit(1);
@@ -148,7 +146,7 @@ export async function startV5Shell() {
         if (screen) {
             detachRuntime(screen);
         }
-        // Restore terminal
+        // Phase A2: Restore terminal
         restoreTerminal(screen);
         // Restore stdout
         restoreStdout();
@@ -157,5 +155,16 @@ export async function startV5Shell() {
     process.on('exit', () => {
         cleanup();
     });
+    // Handle uncaught errors
+    process.on('uncaughtException', (error) => {
+        process.stderr.write(`[V5] Uncaught exception: ${error.message}\n`);
+        cleanup();
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        process.stderr.write(`[V5] Unhandled rejection: ${String(reason)}\n`);
+        cleanup();
+        process.exit(1);
+    });
 }
 //# sourceMappingURL=index.js.map

package/dist/ui/v5/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/v5/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/v5/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,OAAO,MAAM,aAAa,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAS9D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,2BAA2B;IAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,IAAK,UAAkB,CAAC,2BAA2B,EAAE,CAAC;QACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IAED,8CAA8C;IAC7C,UAAkB,CAAC,2BAA2B,GAAG,IAAI,CAAC;IAEvD,2DAA2D;IAC3D,eAAe,EAAE,CAAC;IAElB,IAAI,MAAM,GAA0B,IAAI,CAAC;IACzC,IAAI,MAAM,GAAoB,IAAI,CAAC;IACnC,IAAI,gBAAgB,GAA4B,IAAI,CAAC;IAErD,IAAI,CAAC;QACH,iDAAiD;QACjD,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAChD,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,gBAAgB;QAChB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YACtB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,KAAK;SACZ,CAAmB,CAAC;QAE5B,4DAA4D;QAC5D,aAAa,CAAC,MAAM,CAAC,CAAC;QAEtB,wBAAwB;QACxB,MAAM,OAAO,GAAI,MAAc,CAAC,OAAO,CAAC;QACxC,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACxD,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,CAAC;QAED,uCAAuC;QACvC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QAEpD,gBAAgB;QAChB,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE9B,2BAA2B;QAC3B,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxD,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAEzB,8BAA8B;QAC9B,MAAM,CAAC,IAAI,EAAE,CAAC;QAEd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAElE,+BAA+B;QAC/B,MAAM,YAAY,GAAyB;YACzC,MAAM;YACN,MAAM;YACN,gBAAgB;YAChB,eAAe,EAAE,MAAM,CAAC,kBAAkB,EAAE;SAC7C,CAAC;QAEF,2CAA2C;QAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC7D,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,wCAAwC;QACxC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,uCAAuC;YACtC,OAAO,CAAC,OAAe,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAU,EAAE,GAAQ,EAAE,EAAE;gBAC/D,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACzB,MAAM,KAAK,GAAI,OAAO,CAAC,OAAe,CAAC,OAAO,IAAI,EAAE,CAAC;oBACrD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;oBAErC,wBAAwB;oBACxB,IAAI,kBAAkB,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;wBAC9C,kBAAkB;wBACjB,OAAO,CAAC,OAAe,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;wBACxC,MAAM,cAAc,GAAG,gBAAgB,EAAE,CAAC;wBAC1C,UAAU,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;wBACnC,OAAO;oBACT,CAAC;oBAED,qCAAqC;oBACpC,OAAO,CAAC,OAAe,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;oBACxC,MAAM,cAAc,GAAG,gBAAgB,EAAE,CAAC;oBAC1C,UAAU,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,sBAAsB;YACrB,OAAO,CAAC,OAAe,CAAC,KAAK,EAAE,EAAE,CAAC;QACrC,CAAC;IAEH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAE7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,QAAQ,IAAI,CAAC,CAAC;QACxD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrG,CAAC;QAED,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,mBAAmB;IACnB,SAAS,OAAO;QACd,wBAAwB;QACvB,UAAkB,CAAC,2BAA2B,GAAG,KAAK,CAAC;QAExD,yBAAyB;QACzB,IAAI,gBAAgB,EAAE,CAAC;YACrB,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,iBAAiB;QACjB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;QAED,iBAAiB;QACjB,IAAI,MAAM,EAAE,CAAC;YACX,aAAa,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,6BAA6B;QAC7B,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,iBAAiB;QACjB,aAAa,EAAE,CAAC;IAClB,CAAC;IAED,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACpE,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ui/v5/kernel/kernel.d.ts

@@ -0,0 +1,80 @@
+/**
+ * V5 UI Kernel
+ *
+ * Owns the screen and all widgets. Provides atomic rebuild capability.
+ *
+ * HARD RULE: Never resize/move existing widgets.
+ * On every committed resize: destroy all widgets and recreate them.
+ */
+import type { Widgets } from 'neo-blessed';
+import { type Layout } from '../layout/layoutEngine.js';
+export interface RebuildOptions {
+    cols: number;
+    rows: number;
+    version: number;
+    source: string;
+    burstCount: number;
+}
+export interface UIWidgets {
+    [key: string]: Widgets.Box;
+}
+export declare class UIKernel {
+    private screen;
+    private widgets;
+    private layout;
+    private layoutVersion;
+    private isRebuilding;
+    private pendingRebuild;
+    private debugOverlayVisible;
+    private debugOverlay;
+    constructor(screen: Widgets.Screen);
+    /**
+     * Get current layout version (for render gating)
+     */
+    getLayoutVersion(): number;
+    /**
+     * Get current layout
+     */
+    getLayout(): Layout;
+    /**
+     * Get operations panel (for debug commands)
+     */
+    getOperationsPanel(): Widgets.Box | undefined;
+    /**
+     * Get current widgets (for external access)
+     */
+    getWidgets(): UIWidgets | null;
+    /**
+     * Boot the kernel - initial mount
+     */
+    boot(): void;
+    /**
+     * Rebuild the UI - atomic destroy and recreate
+     */
+    rebuild(options: RebuildOptions): void;
+    /**
+     * Destroy the kernel and all widgets
+     */
+    destroy(): void;
+    /**
+     * Toggle debug overlay
+     */
+    toggleDebugOverlay(content?: string): void;
+    /**
+     * Update debug overlay with new info
+     */
+    private updateDebugOverlay;
+    /**
+     * Build debug overlay content
+     */
+    private buildDebugOverlayContent;
+    /**
+     * Destroy all children widgets (hard destroy)
+     */
+    private destroyAllChildren;
+    /**
+     * Create all widgets fresh from layout
+     */
+    private createWidgets;
+}
+//# sourceMappingURL=kernel.d.ts.map