specmem-hardwicksoftware 3.5.99

package/dist/utils/sessionInjector.js

@@ -0,0 +1,189 @@
+/**
+ * Session Injector - Inject text into the current  screen session
+ *
+ * Uses the STY environment variable to reliably identify the current screen session.
+ * Supports text injection + Enter key submission.
+ *
+ * This WORKS because:
+ * - STY env var is set by screen and inherited by all child processes
+ * - screen -X stuff injects into the terminal input buffer
+ * - $'\r' sends actual carriage return which triggers Enter in ink UI
+ */
+import { execSync } from 'child_process';
+import { logger } from './logger.js';
+/**
+ * Get the current screen session name from STY environment variable
+ * Returns null if not running inside a screen session
+ */
+export function getCurrentScreenSession() {
+    const sty = process.env.STY;
+    if (!sty) {
+        logger.debug({ env: 'STY' }, 'Not running in screen session');
+        return null;
+    }
+    return sty;
+}
+/**
+ * Inject text into the current  session's terminal input
+ *
+ * @param text - Text to inject
+ * @param pressEnter - Whether to send Enter key after text (default: false)
+ * @returns true if injection succeeded
+ *
+ * @example
+ * // Type text without submitting
+ * injectToCurrentSession("Hello world");
+ *
+ * // Type text and submit
+ * injectToCurrentSession("Hello world", true);
+ */
+export function injectToCurrentSession(text, pressEnter = false) {
+    const session = getCurrentScreenSession();
+    if (!session) {
+        logger.warn({}, 'Cannot inject - not running in screen session');
+        return false;
+    }
+    return injectToSession(session, text, pressEnter);
+}
+/**
+ * Inject text into a specific screen session
+ *
+ * @param sessionName - Screen session name (e.g., "4184682.pts-7.srv815833")
+ * @param text - Text to inject
+ * @param pressEnter - Whether to send Enter key after text
+ * @returns true if injection succeeded
+ */
+export function injectToSession(sessionName, text, pressEnter = false) {
+    try {
+        // Escape special characters for screen stuff command
+        // Note: screen -X stuff uses different escaping than shell
+        const escapedText = text
+            .replace(/\\/g, '\\\\')
+            .replace(/"/g, '\\"')
+            .replace(/\$/g, '\\$')
+            .replace(/`/g, '\\`');
+        // Send the text
+        execSync(`screen -S "${sessionName}" -p 0 -X stuff "${escapedText}"`, {
+            encoding: 'utf-8',
+            timeout: 5000
+        });
+        // Send Enter key if requested
+        // CRITICAL: Use $'\r' syntax for actual carriage return byte
+        if (pressEnter) {
+            // Small delay to ensure text is in buffer
+            execSync('sleep 0.05');
+            execSync(`screen -S "${sessionName}" -p 0 -X stuff $'\\r'`, {
+                encoding: 'utf-8',
+                timeout: 5000
+            });
+        }
+        logger.info({
+            session: sessionName,
+            textLength: text.length,
+            pressEnter
+        }, 'Injected text to screen session');
+        return true;
+    }
+    catch (error) {
+        logger.error({
+            error: error instanceof Error ? error.message : 'Unknown error',
+            session: sessionName
+        }, 'Failed to inject to screen session');
+        return false;
+    }
+}
+/**
+ * Send a special key to the current session
+ *
+ * @param key - Special key name
+ * @returns true if sent successfully
+ */
+export function sendSpecialKey(key) {
+    const session = getCurrentScreenSession();
+    if (!session)
+        return false;
+    const keyMap = {
+        'enter': '\\r',
+        'tab': '\\t',
+        'escape': '\\e',
+        'backspace': '\\b',
+        'ctrl-c': '\\x03',
+        'ctrl-d': '\\x04',
+    };
+    const sequence = keyMap[key];
+    if (!sequence) {
+        logger.warn({ key }, 'Unknown special key');
+        return false;
+    }
+    try {
+        execSync(`screen -S "${session}" -p 0 -X stuff $'${sequence}'`, {
+            encoding: 'utf-8',
+            timeout: 5000
+        });
+        return true;
+    }
+    catch (error) {
+        logger.error({ error, key, session }, 'Failed to send special key');
+        return false;
+    }
+}
+/**
+ * Self-message: inject a message as user input and submit it
+ * This allows a  subprocess to "send itself" a message
+ *
+ * @param message - Message to inject as user input
+ * @returns true if injection and submission succeeded
+ */
+export function selfMessage(message) {
+    // Clear any existing input first (Ctrl+U clears line in most terminals)
+    const session = getCurrentScreenSession();
+    if (!session)
+        return false;
+    try {
+        // Send Ctrl+U to clear input line
+        execSync(`screen -S "${session}" -p 0 -X stuff $'\\x15'`, {
+            encoding: 'utf-8',
+            timeout: 5000
+        });
+        // Small delay
+        execSync('sleep 0.05');
+        // Now inject the message and submit
+        return injectToCurrentSession(message, true);
+    }
+    catch (error) {
+        logger.error({ error }, 'Failed to self-message');
+        return false;
+    }
+}
+/**
+ * Check if we're running inside a screen session
+ */
+export function isInScreenSession() {
+    return !!process.env.STY;
+}
+/**
+ * Get info about all available screen sessions
+ */
+export function listScreenSessions() {
+    try {
+        const output = execSync('screen -ls 2>&1', { encoding: 'utf-8' });
+        const sessions = [];
+        const lines = output.split('\n');
+        for (const line of lines) {
+            // Match: "4184682.pts-7.srv815833	(01/03/26 18:03:05)	(Attached)"
+            const match = line.match(/(\d+)\.([^\s]+)\s+.*\((Attached|Detached)\)/i);
+            if (match) {
+                sessions.push({
+                    name: `${match[1]}.${match[2]}`,
+                    pid: parseInt(match[1], 10),
+                    attached: match[3].toLowerCase() === 'attached'
+                });
+            }
+        }
+        return sessions;
+    }
+    catch (error) {
+        return [];
+    }
+}
+//# sourceMappingURL=sessionInjector.js.map

package/dist/utils/sessionInjector.js.map

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

package/dist/utils/statsCache.d.ts

@@ -0,0 +1,134 @@
+/**
+ * statsCache.ts - In-Memory Cache with TTL for Dashboard Stats
+ *
+ * yo this cache keeps dashboard stats FAST
+ * no more hammering the database every second
+ * TTL-based invalidation fr fr
+ *
+ * Issue #39 fix - caching for dashboard stats
+ */
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    oldestEntry: number | null;
+    newestEntry: number | null;
+}
+/**
+ * StatsCache - TTL-based in-memory cache
+ *
+ * Features that GO CRAZY:
+ * - TTL-based expiration
+ * - Hit/miss tracking
+ * - Auto-cleanup
+ * - Type-safe generics
+ */
+export declare class StatsCache<T = unknown> {
+    private cache;
+    private defaultTtlMs;
+    private maxEntries;
+    private hits;
+    private misses;
+    private cleanupIntervalId;
+    constructor(options?: {
+        defaultTtlMs?: number;
+        maxEntries?: number;
+        cleanupIntervalMs?: number;
+    });
+    /**
+     * Get a value from cache
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set a value in cache
+     */
+    set(key: string, value: T, ttlMs?: number): void;
+    /**
+     * Get or set - returns cached value or calls factory and caches result
+     */
+    getOrSet(key: string, factory: () => Promise<T>, ttlMs?: number): Promise<T>;
+    /**
+     * Get or set (sync version)
+     */
+    getOrSetSync(key: string, factory: () => T, ttlMs?: number): T;
+    /**
+     * Delete a specific key
+     */
+    delete(key: string): boolean;
+    /**
+     * Delete all keys matching a pattern
+     */
+    deleteMatching(pattern: RegExp): number;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Remove expired entries
+     */
+    cleanup(): number;
+    /**
+     * Evict oldest entry to make room
+     */
+    private evictOldest;
+    /**
+     * Get all keys
+     */
+    keys(): string[];
+    /**
+     * Shutdown - stop cleanup interval
+     */
+    shutdown(): void;
+}
+/**
+ * Specialized cache for dashboard stats
+ */
+export declare class DashboardStatsCache {
+    private cache;
+    constructor(ttlSeconds?: number);
+    /**
+     * Get cached stats or compute them
+     */
+    getStats<T>(key: string, fetcher: () => Promise<T>, ttlSeconds?: number): Promise<T>;
+    /**
+     * Invalidate specific stats
+     */
+    invalidate(key: string): void;
+    /**
+     * Invalidate all stats matching pattern
+     */
+    invalidatePattern(pattern: string): number;
+    /**
+     * Invalidate all stats
+     */
+    invalidateAll(): void;
+    /**
+     * Get cache stats
+     */
+    getCacheStats(): CacheStats;
+    /**
+     * Shutdown
+     */
+    shutdown(): void;
+}
+/**
+ * Get the global dashboard stats cache
+ */
+export declare function getDashboardCache(ttlSeconds?: number): DashboardStatsCache;
+/**
+ * Reset the global dashboard cache
+ */
+export declare function resetDashboardCache(): void;
+//# sourceMappingURL=statsCache.d.ts.map

package/dist/utils/statsCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statsCache.d.ts","sourceRoot":"","sources":["../../src/utils/statsCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO;IACjC,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,iBAAiB,CAA+B;gBAE5C,OAAO,GAAE;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACvB;IAeN;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAqB/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBhD;;OAEG;IACG,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC;IAYb;;OAEG;IACH,YAAY,CACV,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,CAAC;IAWJ;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAWvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUzB;;OAEG;IACH,QAAQ,IAAI,UAAU;IAwBtB;;OAEG;IACH,OAAO,IAAI,MAAM;IAkBjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,QAAQ,IAAI,IAAI;CAOjB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAa;gBAEd,UAAU,GAAE,MAAW;IAQnC;;OAEG;IACG,QAAQ,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,CAAC;IAQb;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI1C;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,aAAa,IAAI,UAAU;IAI3B;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGjB;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAK1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C"}

package/dist/utils/statsCache.js

@@ -0,0 +1,285 @@
+/**
+ * statsCache.ts - In-Memory Cache with TTL for Dashboard Stats
+ *
+ * yo this cache keeps dashboard stats FAST
+ * no more hammering the database every second
+ * TTL-based invalidation fr fr
+ *
+ * Issue #39 fix - caching for dashboard stats
+ */
+import { logger } from './logger.js';
+/**
+ * StatsCache - TTL-based in-memory cache
+ *
+ * Features that GO CRAZY:
+ * - TTL-based expiration
+ * - Hit/miss tracking
+ * - Auto-cleanup
+ * - Type-safe generics
+ */
+export class StatsCache {
+    cache = new Map();
+    defaultTtlMs;
+    maxEntries;
+    hits = 0;
+    misses = 0;
+    cleanupIntervalId = null;
+    constructor(options = {}) {
+        this.defaultTtlMs = options.defaultTtlMs ?? 30000; // 30 seconds default
+        this.maxEntries = options.maxEntries ?? 1000;
+        // Start cleanup interval if specified
+        const cleanupInterval = options.cleanupIntervalMs ?? 60000; // 1 minute
+        if (cleanupInterval > 0) {
+            this.cleanupIntervalId = setInterval(() => {
+                this.cleanup();
+            }, cleanupInterval);
+            // Don't let cleanup interval prevent process exit
+            this.cleanupIntervalId.unref?.();
+        }
+    }
+    /**
+     * Get a value from cache
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return undefined;
+        }
+        // Check expiration
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            this.misses++;
+            return undefined;
+        }
+        // Cache hit!
+        entry.hits++;
+        this.hits++;
+        return entry.value;
+    }
+    /**
+     * Set a value in cache
+     */
+    set(key, value, ttlMs) {
+        // Enforce max entries
+        if (this.cache.size >= this.maxEntries && !this.cache.has(key)) {
+            this.evictOldest();
+        }
+        const now = Date.now();
+        const ttl = ttlMs ?? this.defaultTtlMs;
+        this.cache.set(key, {
+            value,
+            createdAt: now,
+            expiresAt: now + ttl,
+            hits: 0
+        });
+    }
+    /**
+     * Get or set - returns cached value or calls factory and caches result
+     */
+    async getOrSet(key, factory, ttlMs) {
+        const cached = this.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Not in cache - call factory
+        const value = await factory();
+        this.set(key, value, ttlMs);
+        return value;
+    }
+    /**
+     * Get or set (sync version)
+     */
+    getOrSetSync(key, factory, ttlMs) {
+        const cached = this.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const value = factory();
+        this.set(key, value, ttlMs);
+        return value;
+    }
+    /**
+     * Delete a specific key
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Delete all keys matching a pattern
+     */
+    deleteMatching(pattern) {
+        let deleted = 0;
+        for (const key of this.cache.keys()) {
+            if (pattern.test(key)) {
+                this.cache.delete(key);
+                deleted++;
+            }
+        }
+        return deleted;
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.cache.clear();
+        logger.debug('stats cache cleared');
+    }
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const total = this.hits + this.misses;
+        let oldest = null;
+        let newest = null;
+        for (const entry of this.cache.values()) {
+            if (oldest === null || entry.createdAt < oldest) {
+                oldest = entry.createdAt;
+            }
+            if (newest === null || entry.createdAt > newest) {
+                newest = entry.createdAt;
+            }
+        }
+        return {
+            size: this.cache.size,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: total > 0 ? this.hits / total : 0,
+            oldestEntry: oldest,
+            newestEntry: newest
+        };
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            logger.debug({ removed }, 'cleaned up expired cache entries');
+        }
+        return removed;
+    }
+    /**
+     * Evict oldest entry to make room
+     */
+    evictOldest() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.cache) {
+            if (entry.createdAt < oldestTime) {
+                oldestTime = entry.createdAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            logger.debug({ key: oldestKey }, 'evicted oldest cache entry');
+        }
+    }
+    /**
+     * Get all keys
+     */
+    keys() {
+        return Array.from(this.cache.keys());
+    }
+    /**
+     * Shutdown - stop cleanup interval
+     */
+    shutdown() {
+        if (this.cleanupIntervalId) {
+            clearInterval(this.cleanupIntervalId);
+            this.cleanupIntervalId = null;
+        }
+        this.cache.clear();
+    }
+}
+/**
+ * Specialized cache for dashboard stats
+ */
+export class DashboardStatsCache {
+    cache;
+    constructor(ttlSeconds = 30) {
+        this.cache = new StatsCache({
+            defaultTtlMs: ttlSeconds * 1000,
+            maxEntries: 100,
+            cleanupIntervalMs: 60000
+        });
+    }
+    /**
+     * Get cached stats or compute them
+     */
+    async getStats(key, fetcher, ttlSeconds) {
+        return this.cache.getOrSet(`stats:${key}`, fetcher, ttlSeconds ? ttlSeconds * 1000 : undefined);
+    }
+    /**
+     * Invalidate specific stats
+     */
+    invalidate(key) {
+        this.cache.delete(`stats:${key}`);
+    }
+    /**
+     * Invalidate all stats matching pattern
+     */
+    invalidatePattern(pattern) {
+        return this.cache.deleteMatching(new RegExp(`^stats:.*${pattern}.*`));
+    }
+    /**
+     * Invalidate all stats
+     */
+    invalidateAll() {
+        this.cache.deleteMatching(/^stats:/);
+    }
+    /**
+     * Get cache stats
+     */
+    getCacheStats() {
+        return this.cache.getStats();
+    }
+    /**
+     * Shutdown
+     */
+    shutdown() {
+        this.cache.shutdown();
+    }
+}
+// Singleton for dashboard stats
+let dashboardCacheInstance = null;
+/**
+ * Get the global dashboard stats cache
+ */
+export function getDashboardCache(ttlSeconds) {
+    if (!dashboardCacheInstance) {
+        dashboardCacheInstance = new DashboardStatsCache(ttlSeconds);
+    }
+    return dashboardCacheInstance;
+}
+/**
+ * Reset the global dashboard cache
+ */
+export function resetDashboardCache() {
+    if (dashboardCacheInstance) {
+        dashboardCacheInstance.shutdown();
+    }
+    dashboardCacheInstance = null;
+}
+//# sourceMappingURL=statsCache.js.map

package/dist/utils/statsCache.js.map

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