4runr-os 1.0.23 → 1.0.28

package/dist/events.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Event Ring Buffer
+ * Phase 2: Track meaningful operational events for Live Operations Feed
+ */
+import type { OperationEvent } from './models.js';
+/**
+ * Add event to operations feed
+ * Events are structured objects, not strings
+ */
+export declare function addOperationEvent(event: OperationEvent): void;
+/**
+ * Helper: Create event for run started
+ */
+export declare function eventRunStarted(agentName: string, runId: string): OperationEvent;
+/**
+ * Helper: Create event for run completed
+ */
+export declare function eventRunCompleted(agentName: string, runId: string, status: 'SUCCESS' | 'FAILED'): OperationEvent;
+/**
+ * Helper: Create event for error detected
+ */
+export declare function eventErrorDetected(description: string, metadata?: Record<string, any>, severity?: 'warning' | 'critical'): OperationEvent;
+/**
+ * Helper: Create event for connection established
+ */
+export declare function eventConnectionEstablished(target: string): OperationEvent;
+/**
+ * Helper: Create event for connection lost
+ */
+export declare function eventConnectionLost(): OperationEvent;
+/**
+ * Helper: Create event for system state change
+ */
+export declare function eventSystemStateChange(description: string, metadata?: Record<string, any>): OperationEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAQ7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAQhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,cAAc,CAQhH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,GAAE,SAAS,GAAG,UAAsB,GAAG,cAAc,CAQpJ;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAQzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAOpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAQ1G"}

package/dist/events.js

@@ -0,0 +1,89 @@
+/**
+ * Event Ring Buffer
+ * Phase 2: Track meaningful operational events for Live Operations Feed
+ */
+import { updateAppState, getState } from './store.js';
+const MAX_EVENTS = 10; // Ring buffer size
+/**
+ * Add event to operations feed
+ * Events are structured objects, not strings
+ */
+export function addOperationEvent(event) {
+    const state = getState();
+    const events = [...state.operationEvents, event];
+    // Keep only last MAX_EVENTS
+    const trimmedEvents = events.slice(-MAX_EVENTS);
+    updateAppState({ operationEvents: trimmedEvents });
+}
+/**
+ * Helper: Create event for run started
+ */
+export function eventRunStarted(agentName, runId) {
+    return {
+        type: 'RUN_STARTED',
+        description: `Execution started: ${agentName}`,
+        timestamp: Date.now(),
+        severity: 'info',
+        metadata: { agentName, runId },
+    };
+}
+/**
+ * Helper: Create event for run completed
+ */
+export function eventRunCompleted(agentName, runId, status) {
+    return {
+        type: 'RUN_COMPLETED',
+        description: `Execution ${status.toLowerCase()}: ${agentName}`,
+        timestamp: Date.now(),
+        severity: status === 'FAILED' ? 'warning' : 'info',
+        metadata: { agentName, runId, status },
+    };
+}
+/**
+ * Helper: Create event for error detected
+ */
+export function eventErrorDetected(description, metadata, severity = 'warning') {
+    return {
+        type: 'ERROR_DETECTED',
+        description,
+        timestamp: Date.now(),
+        severity,
+        metadata,
+    };
+}
+/**
+ * Helper: Create event for connection established
+ */
+export function eventConnectionEstablished(target) {
+    return {
+        type: 'CONNECTION_ESTABLISHED',
+        description: `Connected to ${target}`,
+        timestamp: Date.now(),
+        severity: 'info',
+        metadata: { target },
+    };
+}
+/**
+ * Helper: Create event for connection lost
+ */
+export function eventConnectionLost() {
+    return {
+        type: 'CONNECTION_LOST',
+        description: 'Connection lost',
+        timestamp: Date.now(),
+        severity: 'warning',
+    };
+}
+/**
+ * Helper: Create event for system state change
+ */
+export function eventSystemStateChange(description, metadata) {
+    return {
+        type: 'SYSTEM_STATE_CHANGE',
+        description,
+        timestamp: Date.now(),
+        severity: 'info',
+        metadata,
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,UAAU,GAAG,EAAE,CAAC,CAAC,mBAAmB;AAE1C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAEjD,4BAA4B;IAC5B,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;IAEhD,cAAc,CAAC,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,KAAa;IAC9D,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sBAAsB,SAAS,EAAE;QAC9C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,KAAa,EAAE,MAA4B;IAC9F,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,aAAa,MAAM,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE;QAC9D,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QAClD,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE;KACvC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,QAA8B,EAAE,WAAmC,SAAS;IAClI,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW;QACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ;QACR,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,gBAAgB,MAAM,EAAE;QACrC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,EAAE,MAAM,EAAE;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,iBAAiB;QAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,SAAS;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,QAA8B;IACxF,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,WAAW;QACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM;QAChB,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -17,7 +17,9 @@ import { getLastAgent, setLastAgent, setLastConnectionTarget, setLastMode, } fro
 import { Copy } from './copy.js';
 import { createProgress, stopAllAnimations } from './animations.js';
 import { getState, updateAppState } from './store.js';
-import { renderHomeView } from './ui/home-view.js';
+import { renderIntelligencePostureView } from './ui/intelligence-posture-view.js';
+import { systemStateProvider } from './system-state.js';
+import { addOperationEvent, eventConnectionEstablished, } from './events.js';
 // Legacy color aliases for backward compatibility during refactor
 const cyan = C_ACCENT;
 const green = C_SUCCESS;
@@ -212,6 +214,7 @@ async function bootSequence() {
             gatewayUrl = urlToUse;
             gatewayStatus = 'OK';
             setLastConnectionTarget(urlToUse);
+            addOperationEvent(eventConnectionEstablished(urlToUse));
         }
         catch {
             gatewayStatus = 'WARN';
@@ -287,9 +290,9 @@ async function bootSequence() {
     }
     // Save mode to state
     setLastMode(localMode ? 'LOCAL' : 'REMOTE');
-    // Auto transition to HOME
+    // Auto transition to Intelligence Posture View
     await sleep(200);
-    await showHomeView();
+    await showIntelligencePostureView();
 }
 /**
  * Start session expiry checker
@@ -412,11 +415,10 @@ function formatUptime() {
  *
  * This is the pattern all views should follow.
  */
-async function showHomeView() {
+async function showIntelligencePostureView() {
     // 1. Update state
-    currentView = 'HOME';
+    currentView = 'INTELLIGENCE_POSTURE';
     // 2. Sync legacy globals to state store
-    // TODO: Once all code uses state store, this sync won't be needed
     syncStateToStore();
     // 3. Sync customAgents and runHistory to store
     const state = getState();
@@ -424,10 +426,14 @@ async function showHomeView() {
         customAgents: customAgents,
         runHistory: runHistory,
     });
-    // 4. Call pure renderer (state → string)
-    const newState = getState();
-    const output = renderHomeView(newState);
-    // 5. Output result
+    // Phase 5: SystemState is computed on-demand, not stored
+    // The UI reads from SystemState, which is computed from AppState
+    // Invalidate cache to force fresh computation
+    systemStateProvider.invalidate();
+    // 5. Call pure renderer (state → string)
+    const finalState = getState();
+    const output = renderIntelligencePostureView(finalState);
+    // 6. Output result
     console.log();
     console.log(output);
 }
@@ -478,7 +484,7 @@ const commands = {
             else {
                 // Clean, precise help menu
                 const commandLines = [];
-                commandLines.push(`${C_LINK}home${RESET}     Mission control overview`);
+                commandLines.push(`${C_LINK}posture${RESET}  Intelligence briefing`);
                 commandLines.push(`${C_LINK}connect${RESET}  Connect to remote`);
                 commandLines.push(`${C_LINK}build${RESET}    Create or edit agent`);
                 commandLines.push(`${C_LINK}start${RESET}    Begin execution`);
@@ -692,7 +698,7 @@ const commands = {
                 }
                 console.log(Section('ACTIONS', actionLines));
                 console.log();
-                currentView = 'HOME';
+                currentView = 'INTELLIGENCE_POSTURE';
                 return;
             }
             // Handle edit action
@@ -701,7 +707,7 @@ const commands = {
                 if (!agent) {
                     console.log(Alert('error', `Agent not found: ${agentName}`, undefined, 'build'));
                     console.log();
-                    currentView = 'HOME';
+                    currentView = 'INTELLIGENCE_POSTURE';
                     return;
                 }
                 await showAgentConfig(agent);
@@ -725,14 +731,14 @@ const commands = {
                 console.log(`${red}Providers unavailable${reset}`);
                 console.log(`${dim}Reason: ${error.message}${reset}`);
                 console.log(`${dim}Next: ${cyan}config${reset}${dim} to configure providers${reset}\n`);
-                currentView = 'HOME';
+                currentView = 'INTELLIGENCE_POSTURE';
                 return;
             }
             if (providers.length === 0) {
                 console.log(`${red}No providers configured${reset}`);
                 console.log(`${dim}Reason: No API keys found${reset}`);
                 console.log(`${dim}Next: ${cyan}config${reset}${dim} to add API keys${reset}\n`);
-                currentView = 'HOME';
+                currentView = 'INTELLIGENCE_POSTURE';
                 return;
             }
             // Auto-select provider/model if not set
@@ -1053,11 +1059,11 @@ const commands = {
             // Show actions
             const actionLines = [];
             actionLines.push(`${C_LINK}start ${name}${RESET}  ${C_MUTED}Begin execution${RESET}`);
-            actionLines.push(`${C_LINK}home${RESET}  ${C_MUTED}Return to overview${RESET}`);
+            actionLines.push(`${C_LINK}posture${RESET}  ${C_MUTED}Intelligence briefing${RESET}`);
             console.log(Section('ACTIONS', actionLines));
             console.log();
-            // Transition: AGENT_LAB → HOME
-            currentView = 'HOME';
+            // Transition: AGENT_LAB → INTELLIGENCE_POSTURE
+            currentView = 'INTELLIGENCE_POSTURE';
         }
     },
     agents: {
@@ -1260,7 +1266,7 @@ const commands = {
                 lastAction: 'system',
             }));
             console.log();
-            currentView = 'HOME';
+            currentView = 'INTELLIGENCE_POSTURE';
         }
     },
     status: {
@@ -1362,6 +1368,135 @@ const commands = {
             console.log(`  Use ${cyan}start ${run.id}${reset} to execute\n`);
         }
     },
+    deploy: {
+        description: 'Promote assets to active operational state',
+        usage: 'deploy [asset-name]',
+        handler: async (args, rl) => {
+            // Phase 3: deploy command - future-safe placeholder
+            if (args.length === 0) {
+                console.log(Alert('error', 'Asset name required', undefined, 'deploy <asset-name>'));
+                console.log();
+                currentView = 'INTELLIGENCE_POSTURE';
+                return;
+            }
+            const assetName = args.join(' ').trim();
+            const asset = customAgents.get(assetName.toLowerCase());
+            if (!asset) {
+                console.log(Alert('error', `Asset not found: ${assetName}`, undefined, 'build'));
+                console.log();
+                currentView = 'INTELLIGENCE_POSTURE';
+                return;
+            }
+            // For v1, deploy is a no-op (future: promote to production/active state)
+            console.log(Alert('info', `Asset "${assetName}" is already operational`, undefined, 'start'));
+            console.log();
+            currentView = 'INTELLIGENCE_POSTURE';
+            await showIntelligencePostureView();
+        }
+    },
+    inspect: {
+        description: 'Drill into assets, runs, or system components',
+        usage: 'inspect [asset|run|system] [name|id]',
+        handler: async (args, rl) => {
+            // Phase 3: inspect command - drill into components
+            if (args.length === 0) {
+                console.log(Alert('error', 'Inspection target required', undefined, 'inspect [asset|run|system] [name|id]'));
+                console.log();
+                currentView = 'INTELLIGENCE_POSTURE';
+                return;
+            }
+            const target = args[0].toLowerCase();
+            if (target === 'asset' || target === 'assets') {
+                if (args.length < 2) {
+                    // List all assets
+                    if (customAgents.size === 0) {
+                        console.log(Alert('info', 'No assets available', undefined, 'build'));
+                        console.log();
+                        currentView = 'INTELLIGENCE_POSTURE';
+                        return;
+                    }
+                    console.log(Section('AVAILABLE ASSETS', []));
+                    Array.from(customAgents.values()).forEach(agent => {
+                        console.log(`  ${C_ACCENT}${agent.name}${RESET}  ${C_MUTED}${agent.description || 'No description'}${RESET}`);
+                    });
+                    console.log();
+                    currentView = 'INTELLIGENCE_POSTURE';
+                    return;
+                }
+                const assetName = args.slice(1).join(' ').trim();
+                const asset = customAgents.get(assetName.toLowerCase());
+                if (!asset) {
+                    console.log(Alert('error', `Asset not found: ${assetName}`, undefined, 'build'));
+                    console.log();
+                    currentView = 'INTELLIGENCE_POSTURE';
+                    return;
+                }
+                // Show asset details (read-only inspection)
+                const detailLines = [];
+                detailLines.push(`NAME: ${C_TEXT}${asset.name}${RESET}`);
+                if (asset.description) {
+                    detailLines.push(`DESCRIPTION: ${C_MUTED}${asset.description}${RESET}`);
+                }
+                detailLines.push(`BASE: ${C_ACCENT}${asset.baseAgent}${RESET}`);
+                if (asset.temperature !== undefined) {
+                    detailLines.push(`TEMPERATURE: ${C_ACCENT}${asset.temperature}${RESET}`);
+                }
+                if (asset.tools && asset.tools.length > 0) {
+                    detailLines.push(`TOOLS: ${C_ACCENT}${asset.tools.length}${RESET}`);
+                }
+                console.log(Section('ASSET INSPECTION', detailLines));
+                console.log();
+                currentView = 'INTELLIGENCE_POSTURE';
+            }
+            else if (target === 'run' || target === 'runs') {
+                if (args.length < 2) {
+                    // List recent runs
+                    if (runHistory.length === 0) {
+                        console.log(Alert('info', 'No runs available', undefined, 'start'));
+                        console.log();
+                        currentView = 'INTELLIGENCE_POSTURE';
+                        return;
+                    }
+                    console.log(Section('RECENT RUNS', []));
+                    runHistory.slice(-5).reverse().forEach(run => {
+                        const statusColor = run.status === 'SUCCESS' ? C_SUCCESS :
+                            run.status === 'FAILED' ? C_ERROR : C_ACCENT;
+                        console.log(`  ${statusColor}${run.status}${RESET}  ${C_TEXT}${run.agentName}${RESET}  ${C_MUTED}${truncateId(run.runId, 8)}${RESET}`);
+                    });
+                    console.log();
+                    currentView = 'INTELLIGENCE_POSTURE';
+                    return;
+                }
+                const runId = args[1];
+                const run = runHistory.find(r => r.runId.includes(runId));
+                if (!run) {
+                    console.log(Alert('error', `Run not found: ${runId}`, undefined, 'start'));
+                    console.log();
+                    currentView = 'INTELLIGENCE_POSTURE';
+                    return;
+                }
+                // Show run details
+                const runLines = [];
+                runLines.push(`ID: ${C_ACCENT}${run.runId}${RESET}`);
+                runLines.push(`ASSET: ${C_TEXT}${run.agentName}${RESET}`);
+                runLines.push(`STATUS: ${run.status === 'SUCCESS' ? C_SUCCESS : run.status === 'FAILED' ? C_ERROR : C_ACCENT}${run.status}${RESET}`);
+                runLines.push(`TIMESTAMP: ${C_MUTED}${new Date(run.timestamp).toISOString()}${RESET}`);
+                console.log(Section('RUN INSPECTION', runLines));
+                console.log();
+                currentView = 'INTELLIGENCE_POSTURE';
+            }
+            else if (target === 'system') {
+                // System inspection (same as system command)
+                currentView = 'SYSTEM';
+                await commands.system.handler([], rl);
+            }
+            else {
+                console.log(Alert('error', `Unknown inspection target: ${target}`, undefined, 'inspect [asset|run|system]'));
+                console.log();
+                currentView = 'INTELLIGENCE_POSTURE';
+            }
+        }
+    },
     start: {
         description: 'Begin execution',
         usage: 'start [agent]',
@@ -1410,7 +1545,7 @@ const commands = {
                         else {
                             console.log(Alert('error', Copy.error.invalidCommand, undefined, 'start'));
                             console.log();
-                            currentView = 'HOME';
+                            currentView = 'INTELLIGENCE_POSTURE';
                             return;
                         }
                     }
@@ -1422,7 +1557,7 @@ const commands = {
                 if (!agent) {
                     console.log(Alert('error', `Agent not found: ${agentName}`, undefined, 'build'));
                     console.log();
-                    currentView = 'HOME';
+                    currentView = 'INTELLIGENCE_POSTURE';
                     return;
                 }
             }
@@ -1472,7 +1607,7 @@ const commands = {
                 lastAction: `start ${agent.name}`,
             }));
             console.log();
-            currentView = 'HOME';
+            currentView = 'INTELLIGENCE_POSTURE';
         }
     },
     get: {
@@ -1617,7 +1752,7 @@ const commands = {
                 lastAction: 'metrics',
             }));
             console.log();
-            currentView = 'HOME';
+            currentView = 'INTELLIGENCE_POSTURE';
         }
     },
     clear: {
@@ -1625,7 +1760,7 @@ const commands = {
         usage: 'clear',
         handler: async () => {
             console.clear();
-            await showHomeView();
+            await showIntelligencePostureView();
         }
     },
     exit: {
@@ -1677,24 +1812,24 @@ const commands = {
                     setLastMode('REMOTE');
                     // Start session checker
                     startSessionChecker();
-                    // Transition: SYSTEM → HOME
+                    // Transition: SYSTEM → INTELLIGENCE_POSTURE
                     currentView = 'SYSTEM';
                     await sleep(200);
-                    await showHomeView();
+                    await showIntelligencePostureView();
                 }
                 catch (error) {
                     console.log(Alert('warn', 'Connected, but gateway unavailable', 'Local features only', 'system diagnose'));
                     console.log();
                     gatewayConnected = false;
                     setLastMode('LOCAL');
-                    await showHomeView();
+                    await showIntelligencePostureView();
                 }
             }
             else {
                 console.log(Alert('success', 'Connected', 'No gateway URL configured'));
                 console.log();
                 setLastMode('LOCAL');
-                await showHomeView();
+                await showIntelligencePostureView();
             }
         }
     },
@@ -2191,7 +2326,7 @@ async function startREPL() {
                 await cmd.handler(args, rl);
                 // Return to stable view after command (if not already in a view)
                 if (currentView === 'BOOT') {
-                    await showHomeView();
+                    await showIntelligencePostureView();
                 }
             }
             catch (error) {
@@ -2211,8 +2346,8 @@ async function startREPL() {
                     console.log(`${dim}Next: ${cyan}help${reset}${dim} for available commands${reset}\n`);
                 }
                 // Return to previous stable view
-                if (currentView !== 'HOME' && currentView !== 'BOOT') {
-                    await showHomeView();
+                if (currentView !== 'INTELLIGENCE_POSTURE' && currentView !== 'BOOT') {
+                    await showIntelligencePostureView();
                 }
             }
         }