4runr-os 1.4.2 → 2.0.2

package/dist/ui/v3/tui/geometry.js

@@ -0,0 +1,124 @@
+/**
+ * TUI Geometry - Single Source of Truth for Terminal Dimensions
+ *
+ * RULES (NEVER VIOLATE):
+ * 1. Always return integers
+ * 2. Clamp to minimums (prevents 0/undefined during resize)
+ * 3. Account for margins/borders
+ * 4. Never exceed these dimensions in any widget
+ */
+// Absolute minimums (below this, TUI is unusable)
+const MIN_COLS = 40;
+const MIN_ROWS = 15;
+// Margins (space reserved for borders/padding)
+const HORIZONTAL_MARGIN = 0; // Blessed handles borders internally
+const VERTICAL_MARGIN = 0; // Blessed handles borders internally
+let lastGeometry = null;
+/**
+ * Get current terminal geometry
+ *
+ * Priority:
+ * 1. Blessed screen object (most accurate)
+ * 2. process.stdout (fallback)
+ * 3. Clamped minimums (safety)
+ */
+export function getTerminalGeometry(screen) {
+    let cols;
+    let rows;
+    let source;
+    // Try blessed screen first (most accurate)
+    if (screen && typeof screen.width === 'number' && typeof screen.height === 'number') {
+        cols = screen.width;
+        rows = screen.height;
+        source = 'screen';
+    }
+    // Fallback to stdout
+    else if (process.stdout.columns && process.stdout.rows) {
+        cols = process.stdout.columns;
+        rows = process.stdout.rows;
+        source = 'stdout';
+    }
+    // Safety fallback
+    else {
+        cols = MIN_COLS;
+        rows = MIN_ROWS;
+        source = 'clamped';
+    }
+    // Clamp to minimums (prevents transient 0/undefined during resize)
+    cols = Math.max(MIN_COLS, Math.floor(cols));
+    rows = Math.max(MIN_ROWS, Math.floor(rows));
+    // Calculate safe dimensions (accounting for margins)
+    const safeCols = Math.max(MIN_COLS, cols - HORIZONTAL_MARGIN);
+    const safeRows = Math.max(MIN_ROWS, rows - VERTICAL_MARGIN);
+    const geometry = {
+        cols,
+        rows,
+        safeCols,
+        safeRows,
+        source,
+        timestamp: Date.now(),
+    };
+    lastGeometry = geometry;
+    return geometry;
+}
+/**
+ * Get last known geometry (useful for comparisons)
+ */
+export function getLastGeometry() {
+    return lastGeometry;
+}
+/**
+ * Check if geometry has changed significantly
+ */
+export function hasGeometryChanged(screen) {
+    if (!lastGeometry)
+        return true;
+    const current = getTerminalGeometry(screen);
+    return (current.cols !== lastGeometry.cols ||
+        current.rows !== lastGeometry.rows);
+}
+/**
+ * Validate geometry is stable (not in resize storm)
+ */
+export function isGeometryStable(screen) {
+    const geo = getTerminalGeometry(screen);
+    // Reject impossible sizes (transient during resize)
+    if (geo.cols < 20 || geo.rows < 10) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Fit text to width (truncate with ellipsis, never exceed)
+ */
+export function fitText(text, width) {
+    if (width <= 0)
+        return '';
+    if (text.length <= width)
+        return text;
+    // Reserve 3 chars for ellipsis
+    if (width <= 3)
+        return text.substring(0, width);
+    return text.substring(0, width - 3) + '...';
+}
+/**
+ * Clamp panel width to safe bounds
+ */
+export function clampPanelWidth(width, minWidth = 10) {
+    const geo = lastGeometry || getTerminalGeometry();
+    return Math.max(minWidth, Math.min(width, geo.safeCols));
+}
+/**
+ * Clamp panel height to safe bounds
+ */
+export function clampPanelHeight(height, minHeight = 3) {
+    const geo = lastGeometry || getTerminalGeometry();
+    return Math.max(minHeight, Math.min(height, geo.safeRows));
+}
+/**
+ * Format geometry for debug output
+ */
+export function formatGeometry(geo) {
+    return `cols=${geo.cols} rows=${geo.rows} safeCols=${geo.safeCols} safeRows=${geo.safeRows} source=${geo.source}`;
+}
+//# sourceMappingURL=geometry.js.map

package/dist/ui/v3/tui/geometry.js.map

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

package/dist/ui/v3/ui/debugUtils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Debug utilities for TUI lifecycle investigation
+ *
+ * Enable with TUI_DEBUG=1
+ * All debug output goes to Operations/eventBus, never stdout
+ */
+import type { Widgets } from 'neo-blessed';
+export declare const BOOT_ID: string;
+export declare const isDebugMode: () => boolean;
+/**
+ * Step 1A: Track widget creation
+ */
+export declare function trackWidget(widget: any, type: string): void;
+/**
+ * Step 1B: UI inventory dump
+ */
+export declare function dumpUIInventory(screen: Widgets.Screen): void;
+/**
+ * Step 2A: Track listener binding
+ */
+export declare function trackListenerBinding(type: string): void;
+/**
+ * Step 2B: Dump listener bindings
+ */
+export declare function dumpListenerBindings(): void;
+/**
+ * Step 3A: Track blocked stdout/stderr writes
+ */
+export declare function trackBlockedWrite(stream: 'stdout' | 'stderr', content: string): void;
+/**
+ * Step 3B: Dump blocked writes
+ */
+export declare function dumpBlockedWrites(): void;
+/**
+ * Monkeypatch stdout/stderr to catch writes
+ */
+export declare function installStdoutMonkeypatch(): () => void;
+export interface ResizeStats {
+    eventCount: number;
+    applyCount: number;
+    handlerBound: boolean;
+}
+/**
+ * Update resize stats (called from phase1RuntimeClean)
+ */
+export declare function updateResizeStats(stats: Partial<ResizeStats>): void;
+/**
+ * Get resize stats (exported for debug commands)
+ */
+export declare function getResizeStats(): ResizeStats;
+/**
+ * Get current statistics
+ */
+export declare function getDebugStats(): {
+    bootId: string;
+    widgetCount: number;
+    listenerCount: number;
+    blockedWriteCount: number;
+    resizeStats: ResizeStats;
+};
+//# sourceMappingURL=debugUtils.d.ts.map

package/dist/ui/v3/ui/debugUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugUtils.d.ts","sourceRoot":"","sources":["../../../../src/ui/v3/ui/debugUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,OAAO,QAAgE,CAAC;AAkCrF,eAAO,MAAM,WAAW,QAAO,OAE9B,CAAC;AAUF;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAsB3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAqC5D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAqBvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CA2B3C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAsBpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAcxC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,IAAI,CAkCrD;AAGD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;CAC1B,CAQA"}

package/dist/ui/v3/ui/debugUtils.js

@@ -0,0 +1,226 @@
+/**
+ * Debug utilities for TUI lifecycle investigation
+ *
+ * Enable with TUI_DEBUG=1
+ * All debug output goes to Operations/eventBus, never stdout
+ */
+import { eventBus } from '../core/eventBus.js';
+// Step 5: Single source of truth boot marker
+export const BOOT_ID = `${Math.random().toString(36).substring(2, 8).toUpperCase()}`;
+const widgetRegistry = new Map();
+const listenerBindings = [];
+let resizeHandlerCount = 0;
+const blockedWrites = [];
+const MAX_BLOCKED_WRITES = 50;
+export const isDebugMode = () => {
+    return process.env.TUI_DEBUG === '1';
+};
+const log = (msg, level = 'INFO') => {
+    eventBus.emit({
+        tag: 'DBG',
+        msg: `[boot=${BOOT_ID}] ${msg}`,
+        level
+    });
+};
+/**
+ * Step 1A: Track widget creation
+ */
+export function trackWidget(widget, type) {
+    if (!isDebugMode())
+        return;
+    const id = Math.random().toString(36).substring(2, 8);
+    const stack = new Error().stack || '';
+    const createdBy = stack.split('\n').slice(2, 5).join('\n    ');
+    const meta = {
+        __id: id,
+        __createdAt: Date.now(),
+        __createdBy: createdBy,
+        __type: type
+    };
+    widget.__id = id;
+    widget.__createdAt = meta.__createdAt;
+    widget.__createdBy = meta.__createdBy;
+    widget.__type = type;
+    widgetRegistry.set(id, meta);
+    log(`created ${type} id=${id}`);
+}
+/**
+ * Step 1B: UI inventory dump
+ */
+export function dumpUIInventory(screen) {
+    const children = screen.children || [];
+    const totalChildren = children.length;
+    log(`=== UI INVENTORY ===`);
+    log(`Total children: ${totalChildren}`);
+    // Count widgets by type
+    const typeCounts = new Map();
+    for (const child of children) {
+        const type = child.__type || 'unknown';
+        const id = child.__id || 'no-id';
+        const createdAt = child.__createdAt || 0;
+        const createdBy = child.__createdBy || 'unknown';
+        if (!typeCounts.has(type)) {
+            typeCounts.set(type, []);
+        }
+        typeCounts.get(type).push({ id, createdAt, createdBy });
+    }
+    // Report counts and duplicates
+    for (const [type, instances] of typeCounts.entries()) {
+        const count = instances.length;
+        log(`${type}: ${count} instance(s)`);
+        if (count > 1) {
+            log(`  ⚠️ DUPLICATE DETECTED for ${type}:`, 'WARN');
+            for (const inst of instances) {
+                log(`    - id=${inst.id} created at ${new Date(inst.createdAt).toISOString()}`);
+                log(`      stack: ${inst.createdBy}`);
+            }
+        }
+    }
+    log(`=== END INVENTORY ===`);
+}
+/**
+ * Step 2A: Track listener binding
+ */
+export function trackListenerBinding(type) {
+    if (!isDebugMode())
+        return;
+    if (type === 'resize') {
+        resizeHandlerCount++;
+    }
+    const stack = new Error().stack || '';
+    const boundBy = stack.split('\n').slice(2, 5).join('\n    ');
+    const binding = {
+        type,
+        handlerNum: type === 'resize' ? resizeHandlerCount : listenerBindings.filter(b => b.type === type).length + 1,
+        boundAt: Date.now(),
+        stack: boundBy
+    };
+    listenerBindings.push(binding);
+    log(`bound ${type} handler#${binding.handlerNum} at ${new Date(binding.boundAt).toISOString()}`);
+    log(`  stack: ${boundBy}`);
+}
+/**
+ * Step 2B: Dump listener bindings
+ */
+export function dumpListenerBindings() {
+    log(`=== LISTENER BINDINGS ===`);
+    log(`Total bindings: ${listenerBindings.length}`);
+    // Group by type
+    const byType = new Map();
+    for (const binding of listenerBindings) {
+        if (!byType.has(binding.type)) {
+            byType.set(binding.type, []);
+        }
+        byType.get(binding.type).push(binding);
+    }
+    for (const [type, bindings] of byType.entries()) {
+        log(`${type}: ${bindings.length} binding(s)`);
+        if (bindings.length > 1) {
+            log(`  ⚠️ MULTIPLE BINDINGS for ${type}:`, 'WARN');
+        }
+        for (const binding of bindings) {
+            log(`  - handler#${binding.handlerNum} at ${new Date(binding.boundAt).toISOString()}`);
+            log(`    stack: ${binding.stack}`);
+        }
+    }
+    log(`=== END LISTENER BINDINGS ===`);
+}
+/**
+ * Step 3A: Track blocked stdout/stderr writes
+ */
+export function trackBlockedWrite(stream, content) {
+    const stack = new Error().stack || '';
+    const caller = stack.split('\n').slice(2, 5).join('\n    ');
+    const blocked = {
+        ts: Date.now(),
+        content: content.substring(0, 120),
+        stack: caller,
+        stream
+    };
+    blockedWrites.push(blocked);
+    // Keep only last MAX_BLOCKED_WRITES
+    if (blockedWrites.length > MAX_BLOCKED_WRITES) {
+        blockedWrites.shift();
+    }
+    // Emit to operations (rate limited to prevent spam)
+    if (isDebugMode()) {
+        log(`[${stream.toUpperCase()} BLOCKED] "${blocked.content}" from: ${caller}`, 'WARN');
+    }
+}
+/**
+ * Step 3B: Dump blocked writes
+ */
+export function dumpBlockedWrites() {
+    log(`=== BLOCKED STDOUT/STDERR WRITES ===`);
+    log(`Total tracked: ${blockedWrites.length} (showing last 10)`);
+    const recent = blockedWrites.slice(-10);
+    for (let i = 0; i < recent.length; i++) {
+        const write = recent[i];
+        log(`${i + 1}. [${write.stream}] at ${new Date(write.ts).toISOString()}`);
+        log(`   content: "${write.content}"`);
+        log(`   stack: ${write.stack}`);
+    }
+    log(`=== END BLOCKED WRITES ===`);
+}
+/**
+ * Monkeypatch stdout/stderr to catch writes
+ */
+export function installStdoutMonkeypatch() {
+    const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+    const originalStderrWrite = process.stderr.write.bind(process.stderr);
+    // Patch stdout
+    process.stdout.write = function (chunk, ...args) {
+        const content = String(chunk);
+        // Allow ANSI escape codes (cursor control) and blessed writes
+        const stack = new Error().stack || '';
+        const isBlessed = stack.includes('neo-blessed') || stack.includes('Program.prototype');
+        const isAnsiEscape = /^\x1b\[[\d;]*[A-Za-z]/.test(content);
+        if (isBlessed || isAnsiEscape) {
+            return originalStdoutWrite(chunk, ...args);
+        }
+        // Block and track
+        trackBlockedWrite('stdout', content);
+        return true; // Pretend success
+    };
+    // Patch stderr (less strict - allow it but track)
+    process.stderr.write = function (chunk, ...args) {
+        const content = String(chunk);
+        trackBlockedWrite('stderr', content);
+        return originalStderrWrite(chunk, ...args);
+    };
+    // Return cleanup function
+    return () => {
+        process.stdout.write = originalStdoutWrite;
+        process.stderr.write = originalStderrWrite;
+    };
+}
+let resizeStats = {
+    eventCount: 0,
+    applyCount: 0,
+    handlerBound: false
+};
+/**
+ * Update resize stats (called from phase1RuntimeClean)
+ */
+export function updateResizeStats(stats) {
+    resizeStats = { ...resizeStats, ...stats };
+}
+/**
+ * Get resize stats (exported for debug commands)
+ */
+export function getResizeStats() {
+    return { ...resizeStats };
+}
+/**
+ * Get current statistics
+ */
+export function getDebugStats() {
+    return {
+        bootId: BOOT_ID,
+        widgetCount: widgetRegistry.size,
+        listenerCount: listenerBindings.length,
+        blockedWriteCount: blockedWrites.length,
+        resizeStats: getResizeStats()
+    };
+}
+//# sourceMappingURL=debugUtils.js.map

package/dist/ui/v3/ui/debugUtils.js.map

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

package/dist/ui/v3/ui/layout/phase1Layout.d.ts

@@ -1,12 +1,22 @@
 /**
- * Phase 1 Layout Calculator
+ * Phase 1 Layout Calculator - FINAL BULLETPROOF EDITION
  *
  * Fixed hub layout with 7 boxes:
  * - Left column (3 stacked): POSTURE, RESOURCES, ASSETS
  * - Center (1): OPERATIONS
  * - Right column (2 stacked): NETWORK, CAPABILITIES
  * - Bottom bar (1): COMMAND LINE
+ *
+ * CRITICAL RULES (NEVER VIOLATE):
+ * 1. Use geometry.ts for all dimension queries
+ * 2. Total width MUST NOT exceed safeCols
+ * 3. Total height MUST NOT exceed safeRows
+ * 4. No floating point math - only integers
+ * 5. Right column width calculated as REMAINDER (prevents rounding errors)
+ * 6. All positions validated before return
+ * 7. All text must use fitText() to prevent overflow
  */
+import type { Widgets } from 'neo-blessed';
 export interface BoxRect {
     top: number;
     left: number;
@@ -27,10 +37,16 @@ export interface LayoutResult {
     errorMessage?: string;
     layout?: Phase1Layout;
 }
-export declare const MIN_WIDTH = 100;
-export declare const MIN_HEIGHT = 25;
+export declare const MIN_WIDTH = 80;
+export declare const MIN_HEIGHT = 24;
 /**
- * Compute Phase 1 layout
+ * Compute Phase 1 layout - FINAL BULLETPROOF IMPLEMENTATION
+ *
+ * This function GUARANTEES:
+ * - Never exceeds terminal dimensions
+ * - Works on ANY terminal size >= MIN_WIDTH x MIN_HEIGHT
+ * - Integer math only (no rounding errors)
+ * - Uses geometry.ts as single source of truth
  */
-export declare function computePhase1Layout(width: number, height: number): LayoutResult;
+export declare function computePhase1Layout(width: number, height: number, screen?: Widgets.Screen): LayoutResult;
 //# sourceMappingURL=phase1Layout.d.ts.map

package/dist/ui/v3/ui/layout/phase1Layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phase1Layout.d.ts","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/layout/phase1Layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAID,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AAQ7B;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAiG/E"}
+{"version":3,"file":"phase1Layout.d.ts","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/layout/phase1Layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAGD,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,UAAU,KAAK,CAAC;AAM7B;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,YAAY,CAwJxG"}