@liangjie559567/ultrapower 5.5.20 → 5.5.21

package/dist/hud/omc-state.js

@@ -0,0 +1,254 @@
+/**
+ * OMC HUD - State Readers
+ *
+ * Read ralph, ultrawork, and PRD state from existing OMC files.
+ * These are read-only functions that don't modify the state files.
+ */
+import { existsSync, readFileSync, statSync, readdirSync } from 'fs';
+import { join } from 'path';
+/**
+ * Maximum age for state files to be considered "active".
+ * Files older than this are treated as stale/abandoned.
+ */
+const MAX_STATE_AGE_MS = 2 * 60 * 60 * 1000; // 2 hours
+/**
+ * Check if a state file is stale based on file modification time.
+ */
+function isStateFileStale(filePath) {
+    try {
+        const stat = statSync(filePath);
+        const age = Date.now() - stat.mtimeMs;
+        return age > MAX_STATE_AGE_MS;
+    }
+    catch {
+        return true; // Treat errors as stale
+    }
+}
+/**
+ * Resolve state file path with fallback chain:
+ * 1. Session-scoped paths (.omc/state/sessions/{id}/{filename}) - newest first
+ * 2. Standard path (.omc/state/{filename})
+ * 3. Legacy path (.omc/{filename})
+ *
+ * Returns the most recently modified matching path, or null if none found.
+ * This ensures the HUD displays state from any active session (Issue #456).
+ */
+function resolveStatePath(directory, filename) {
+    let bestPath = null;
+    let bestMtime = 0;
+    // Check session-scoped paths first (most likely location after Issue #456 fix)
+    const sessionsDir = join(directory, '.omc', 'state', 'sessions');
+    if (existsSync(sessionsDir)) {
+        try {
+            const entries = readdirSync(sessionsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const sessionFile = join(sessionsDir, entry.name, filename);
+                if (existsSync(sessionFile)) {
+                    try {
+                        const mtime = statSync(sessionFile).mtimeMs;
+                        if (mtime > bestMtime) {
+                            bestMtime = mtime;
+                            bestPath = sessionFile;
+                        }
+                    }
+                    catch {
+                        // Skip on stat error
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore readdir errors
+        }
+    }
+    // Check standard path
+    const newPath = join(directory, '.omc', 'state', filename);
+    if (existsSync(newPath)) {
+        try {
+            const mtime = statSync(newPath).mtimeMs;
+            if (mtime > bestMtime) {
+                bestMtime = mtime;
+                bestPath = newPath;
+            }
+        }
+        catch {
+            if (!bestPath)
+                bestPath = newPath;
+        }
+    }
+    // Check legacy path
+    const legacyPath = join(directory, '.omc', filename);
+    if (existsSync(legacyPath)) {
+        try {
+            const mtime = statSync(legacyPath).mtimeMs;
+            if (mtime > bestMtime) {
+                bestPath = legacyPath;
+            }
+        }
+        catch {
+            if (!bestPath)
+                bestPath = legacyPath;
+        }
+    }
+    return bestPath;
+}
+/**
+ * Read Ralph Loop state for HUD display.
+ * Returns null if no state file exists or on error.
+ */
+export function readRalphStateForHud(directory) {
+    const stateFile = resolveStatePath(directory, 'ralph-state.json');
+    if (!stateFile) {
+        return null;
+    }
+    // Check for stale state file (abandoned session)
+    if (isStateFileStale(stateFile)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(stateFile, 'utf-8');
+        const state = JSON.parse(content);
+        if (!state.active) {
+            return null;
+        }
+        return {
+            active: state.active,
+            iteration: state.iteration,
+            maxIterations: state.max_iterations,
+            prdMode: state.prd_mode,
+            currentStoryId: state.current_story_id,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read Ultrawork state for HUD display.
+ * Checks only local .omc/state location.
+ */
+export function readUltraworkStateForHud(directory) {
+    // Check local state only (with new path fallback)
+    const localFile = resolveStatePath(directory, 'ultrawork-state.json');
+    if (!localFile || isStateFileStale(localFile)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(localFile, 'utf-8');
+        const state = JSON.parse(content);
+        if (!state.active) {
+            return null;
+        }
+        return {
+            active: state.active,
+            reinforcementCount: state.reinforcement_count,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read PRD state for HUD display.
+ * Checks both root prd.json and .omc/prd.json.
+ */
+export function readPrdStateForHud(directory) {
+    // Check root first
+    let prdPath = join(directory, 'prd.json');
+    if (!existsSync(prdPath)) {
+        // Check .omc
+        prdPath = join(directory, '.omc', 'prd.json');
+        if (!existsSync(prdPath)) {
+            return null;
+        }
+    }
+    try {
+        const content = readFileSync(prdPath, 'utf-8');
+        const prd = JSON.parse(content);
+        if (!prd.userStories || !Array.isArray(prd.userStories)) {
+            return null;
+        }
+        const stories = prd.userStories;
+        const completed = stories.filter((s) => s.passes).length;
+        const total = stories.length;
+        // Find current story (first incomplete, sorted by priority)
+        const incomplete = stories
+            .filter((s) => !s.passes)
+            .sort((a, b) => a.priority - b.priority);
+        return {
+            currentStoryId: incomplete[0]?.id || null,
+            completed,
+            total,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read Autopilot state for HUD display.
+ * Returns shape matching AutopilotStateForHud from elements/autopilot.ts.
+ */
+export function readAutopilotStateForHud(directory) {
+    const stateFile = resolveStatePath(directory, 'autopilot-state.json');
+    if (!stateFile) {
+        return null;
+    }
+    // Check for stale state file (abandoned session)
+    if (isStateFileStale(stateFile)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(stateFile, 'utf-8');
+        const state = JSON.parse(content);
+        if (!state.active) {
+            return null;
+        }
+        return {
+            active: state.active,
+            phase: state.phase,
+            iteration: state.iteration,
+            maxIterations: state.max_iterations,
+            tasksCompleted: state.execution?.tasks_completed,
+            tasksTotal: state.execution?.tasks_total,
+            filesCreated: state.execution?.files_created?.length
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Combined State Check
+// ============================================================================
+/**
+ * Check if any OMC mode is currently active
+ */
+export function isAnyModeActive(directory) {
+    const ralph = readRalphStateForHud(directory);
+    const ultrawork = readUltraworkStateForHud(directory);
+    const autopilot = readAutopilotStateForHud(directory);
+    return (ralph?.active ?? false) || (ultrawork?.active ?? false) || (autopilot?.active ?? false);
+}
+/**
+ * Get active skill names for display
+ */
+export function getActiveSkills(directory) {
+    const skills = [];
+    const autopilot = readAutopilotStateForHud(directory);
+    if (autopilot?.active) {
+        skills.push('autopilot');
+    }
+    const ralph = readRalphStateForHud(directory);
+    if (ralph?.active) {
+        skills.push('ralph');
+    }
+    const ultrawork = readUltraworkStateForHud(directory);
+    if (ultrawork?.active) {
+        skills.push('ultrawork');
+    }
+    return skills;
+}
+//# sourceMappingURL=omc-state.js.map

package/dist/hud/omc-state.js.map

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

package/dist/hud/sanitize.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OMC HUD - Output Sanitizer
+ *
+ * Sanitizes HUD output to prevent terminal rendering corruption
+ * when Claude Code's Ink renderer is concurrently updating the display.
+ *
+ * Issue #346: Terminal rendering corruption during AI generation with HUD enabled.
+ *
+ * Root cause: Multi-line output containing ANSI escape sequences and
+ * variable-width Unicode characters (progress bar blocks) can interfere
+ * with Claude Code's terminal cursor positioning during active rendering.
+ *
+ * This module provides:
+ * - Terminal control sequence stripping (preserving color/style codes)
+ * - Unicode block character replacement with ASCII equivalents
+ * - Line count enforcement (collapse to single line if needed)
+ */
+/**
+ * Strip terminal control ANSI sequences while preserving color/style (SGR) codes.
+ *
+ * SGR (Select Graphic Rendition) sequences end with 'm' and control text appearance:
+ * - Colors: \x1b[32m (green), \x1b[31m (red), etc.
+ * - Styles: \x1b[1m (bold), \x1b[0m (reset), etc.
+ *
+ * Other CSI sequences are stripped as they can interfere with terminal rendering:
+ * - Cursor positioning: \x1b[H, \x1b[10;20H
+ * - Erase commands: \x1b[2J (clear screen), \x1b[K (erase line)
+ * - Cursor movement: \x1b[A (up), \x1b[B (down), etc.
+ * - Cursor visibility: \x1b[?25l (hide), \x1b[?25h (show)
+ */
+export declare function stripAnsi(text: string): string;
+/**
+ * Replace variable-width Unicode block characters with fixed-width ASCII equivalents.
+ * Targets characters commonly used in progress bars that have inconsistent
+ * terminal width across different terminal emulators.
+ */
+export declare function replaceUnicodeBlocks(text: string): string;
+/**
+ * Sanitize HUD output for safe terminal rendering.
+ *
+ * Processing steps:
+ * 1. Strips terminal control sequences while preserving color/style SGR codes
+ * 2. Replaces Unicode block characters with ASCII (prevents width miscalculation)
+ * 3. Preserves multi-line output (newlines are kept for proper HUD rendering)
+ * 4. Trims excessive whitespace within lines
+ *
+ * Note: Multi-line output is preserved to maintain HUD tree structure display.
+ * The original single-line collapse was too aggressive and broke readability.
+ *
+ * @param output - Raw HUD output (may contain ANSI codes and newlines)
+ * @returns Sanitized output safe for concurrent terminal rendering
+ */
+export declare function sanitizeOutput(output: string): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/hud/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/hud/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C;AASD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBrD"}

package/dist/hud/sanitize.js

@@ -0,0 +1,87 @@
+/**
+ * OMC HUD - Output Sanitizer
+ *
+ * Sanitizes HUD output to prevent terminal rendering corruption
+ * when Claude Code's Ink renderer is concurrently updating the display.
+ *
+ * Issue #346: Terminal rendering corruption during AI generation with HUD enabled.
+ *
+ * Root cause: Multi-line output containing ANSI escape sequences and
+ * variable-width Unicode characters (progress bar blocks) can interfere
+ * with Claude Code's terminal cursor positioning during active rendering.
+ *
+ * This module provides:
+ * - Terminal control sequence stripping (preserving color/style codes)
+ * - Unicode block character replacement with ASCII equivalents
+ * - Line count enforcement (collapse to single line if needed)
+ */
+// Cached compiled regexes
+const CSI_NON_SGR_REGEX = /\x1b\[\??[0-9;]*[A-LN-Za-ln-z]/g;
+const OSC_REGEX = /\x1b\][^\x07]*\x07/g;
+const SIMPLE_ESC_REGEX = /\x1b[^[\]]/g;
+const UNICODE_BLOCKS_REGEX = /[█░▓▒]/g;
+const LEADING_TRAILING_NEWLINES_REGEX = /^\n+|\n+$/g;
+/**
+ * Strip terminal control ANSI sequences while preserving color/style (SGR) codes.
+ *
+ * SGR (Select Graphic Rendition) sequences end with 'm' and control text appearance:
+ * - Colors: \x1b[32m (green), \x1b[31m (red), etc.
+ * - Styles: \x1b[1m (bold), \x1b[0m (reset), etc.
+ *
+ * Other CSI sequences are stripped as they can interfere with terminal rendering:
+ * - Cursor positioning: \x1b[H, \x1b[10;20H
+ * - Erase commands: \x1b[2J (clear screen), \x1b[K (erase line)
+ * - Cursor movement: \x1b[A (up), \x1b[B (down), etc.
+ * - Cursor visibility: \x1b[?25l (hide), \x1b[?25h (show)
+ */
+export function stripAnsi(text) {
+    return text
+        .replace(CSI_NON_SGR_REGEX, '') // Strip non-SGR CSI sequences
+        .replace(OSC_REGEX, '') // Strip OSC sequences
+        .replace(SIMPLE_ESC_REGEX, ''); // Strip simple escape sequences
+}
+const UNICODE_MAP = {
+    '█': '#',
+    '░': '-',
+    '▓': '=',
+    '▒': '-'
+};
+/**
+ * Replace variable-width Unicode block characters with fixed-width ASCII equivalents.
+ * Targets characters commonly used in progress bars that have inconsistent
+ * terminal width across different terminal emulators.
+ */
+export function replaceUnicodeBlocks(text) {
+    return text.replace(UNICODE_BLOCKS_REGEX, (match) => UNICODE_MAP[match] || match);
+}
+/**
+ * Sanitize HUD output for safe terminal rendering.
+ *
+ * Processing steps:
+ * 1. Strips terminal control sequences while preserving color/style SGR codes
+ * 2. Replaces Unicode block characters with ASCII (prevents width miscalculation)
+ * 3. Preserves multi-line output (newlines are kept for proper HUD rendering)
+ * 4. Trims excessive whitespace within lines
+ *
+ * Note: Multi-line output is preserved to maintain HUD tree structure display.
+ * The original single-line collapse was too aggressive and broke readability.
+ *
+ * @param output - Raw HUD output (may contain ANSI codes and newlines)
+ * @returns Sanitized output safe for concurrent terminal rendering
+ */
+export function sanitizeOutput(output) {
+    // Step 1: Strip terminal control sequences (preserving color/style SGR codes)
+    let sanitized = stripAnsi(output);
+    // Step 2: Replace variable-width Unicode with ASCII
+    sanitized = replaceUnicodeBlocks(sanitized);
+    // Step 3: Preserve multi-line output, just trim each line
+    // Do NOT collapse to single line - HUD needs proper line breaks for tree display
+    const lines = sanitized.split('\n');
+    const trimmedLines = [];
+    for (let i = 0; i < lines.length; i++) {
+        trimmedLines.push(lines[i].trimEnd());
+    }
+    // Step 4: Remove leading/trailing empty lines
+    return trimmedLines.join('\n').replace(LEADING_TRAILING_NEWLINES_REGEX, '');
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/hud/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/hud/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,0BAA0B;AAC1B,MAAM,iBAAiB,GAAG,iCAAiC,CAAC;AAC5D,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AACvC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AACvC,MAAM,+BAA+B,GAAG,YAAY,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,8BAA8B;SAC7D,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,sBAAsB;SAC7C,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,gCAAgC;AACpE,CAAC;AAED,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;CACT,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,8EAA8E;IAC9E,IAAI,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAElC,oDAAoD;IACpD,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAE5C,0DAA0D;IAC1D,iFAAiF;IACjF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,8CAA8C;IAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/hud/state.d.ts

@@ -0,0 +1,49 @@
+/**
+ * OMC HUD - State Management
+ *
+ * Manages HUD state file for background task tracking.
+ * Follows patterns from ultrawork-state.
+ */
+import type { OmcHudState, BackgroundTask, HudConfig } from './types.js';
+/**
+ * Read HUD state from disk (checks new local and legacy local only)
+ */
+export declare function readHudState(directory?: string): OmcHudState | null;
+/**
+ * Write HUD state to disk (local only)
+ */
+export declare function writeHudState(state: OmcHudState, directory?: string): boolean;
+/**
+ * Create a new empty HUD state
+ */
+export declare function createEmptyHudState(): OmcHudState;
+/**
+ * Get running background tasks from state
+ */
+export declare function getRunningTasks(state: OmcHudState | null): BackgroundTask[];
+/**
+ * Get background task count string (e.g., "3/5")
+ */
+export declare function getBackgroundTaskCount(state: OmcHudState | null): {
+    running: number;
+    max: number;
+};
+/**
+ * Read HUD configuration from disk.
+ * Priority: settings.json > hud-config.json (legacy) > defaults
+ */
+export declare function readHudConfig(): HudConfig;
+/**
+ * Write HUD configuration to ~/.claude/settings.json (omcHud key)
+ */
+export declare function writeHudConfig(config: HudConfig): boolean;
+/**
+ * Apply a preset to the configuration
+ */
+export declare function applyPreset(preset: HudConfig['preset']): HudConfig;
+/**
+ * Initialize HUD state with cleanup of stale/orphaned tasks.
+ * Should be called on HUD startup.
+ */
+export declare function initializeHUDState(): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/hud/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/hud/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAgDzE;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAyBnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAKjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,cAAc,EAAE,CAG3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAMA;AAMD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,SAAS,CA8BzC;AA4BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAkBzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAelE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQxD"}