@pellux/goodvibes-tui 0.18.4

package/src/runtime/store/domains/index.ts

@@ -0,0 +1,222 @@
+/**
+ * Barrel export for all runtime store domain types and initial state factories.
+ */
+
+export type {
+  SessionRecoveryState,
+  SessionStatus,
+  SessionLineageEntry,
+  SessionDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/session';
+export { createInitialSessionState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/session';
+
+export type {
+  ReasoningEffort,
+  ProviderTier,
+  ModelTokenLimits,
+  FallbackChainEntry,
+  ModelDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/model';
+export { createInitialModelState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/model';
+
+export type {
+  TurnState,
+  ToolExecutionState,
+  ActiveToolCall,
+  TurnUsage,
+  StreamProgress,
+  ConversationDomainState,
+} from './conversation.ts';
+export { createInitialConversationState } from './conversation.ts';
+
+export type {
+  OverlayId,
+  OverlayInstance,
+  OverlayDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/overlays';
+export { createInitialOverlaysState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/overlays';
+
+export type {
+  PanelId,
+  PanelPosition,
+  PanelState,
+  PanelDomainState,
+} from './panels.ts';
+export { createInitialPanelsState } from './panels.ts';
+
+export type {
+  PermissionMode,
+  PermissionDecisionMachineState,
+  PermissionDecisionOutcome,
+  PermissionSourceLayer,
+  PermissionDecisionReason,
+  PermissionDecision,
+  PermissionDomainState,
+} from './permissions.ts';
+export { createInitialPermissionsState } from './permissions.ts';
+
+export type {
+  TaskLifecycleState,
+  TaskKind,
+  TaskRetryPolicy,
+  RuntimeTask,
+  TaskDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks';
+export { createInitialTasksState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks';
+
+export type {
+  AgentLifecycleState,
+  AgentRole,
+  AgentWrfcRef,
+  RuntimeAgent,
+  AgentDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/agents';
+export { createInitialAgentsState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/agents';
+
+export type {
+  OrchestrationMode,
+  OrchestrationNodeRole,
+  OrchestrationNodeState,
+  OrchestrationGraphState,
+  OrchestrationNodeRecord,
+  OrchestrationGraphRecord,
+  OrchestrationDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/orchestration';
+export { createInitialOrchestrationState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/orchestration';
+
+export type {
+  RuntimeCommunicationRecord,
+  CommunicationDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/communication';
+export { createInitialCommunicationState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/communication';
+
+export type {
+  ProviderStatus,
+  CompositeHealthStatus,
+  ProviderCallStats,
+  ProviderCacheMetrics,
+  ProviderHealthRecord,
+  ProviderHealthDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/provider-health';
+export { createInitialProviderHealthState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/provider-health';
+
+export type {
+  McpServerLifecycleState,
+  McpRegisteredTool,
+  McpServerRecord,
+  McpDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/mcp';
+export { createInitialMcpState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/mcp';
+
+export type {
+  PluginLifecycleState,
+  RuntimePlugin,
+  PluginDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/plugins';
+export { createInitialPluginsState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/plugins';
+
+export type {
+  DaemonTransportState,
+  DaemonProcessInfo,
+  DaemonJob,
+  DaemonDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/daemon';
+export { createInitialDaemonState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/daemon';
+
+export type {
+  AutomationDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/automation';
+export { createInitialAutomationState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/automation';
+
+export type {
+  RoutesDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/routes';
+export { createInitialRoutesState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/routes';
+
+export type {
+  ControlPlaneClientKind,
+  ControlPlaneTransportKind,
+  ControlPlaneConnectionState,
+  ControlPlaneClientRecord,
+  ControlPlaneDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/control-plane';
+export { createInitialControlPlaneState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/control-plane';
+
+export type {
+  DeliveryLifecycleState,
+  DeliveryDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/deliveries';
+export { createInitialDeliveryState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/deliveries';
+
+export type {
+  WatcherKind,
+  WatcherState,
+  WatcherSourceStatus,
+  WatcherRecord,
+  WatcherDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/watchers';
+export { createInitialWatcherState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/watchers';
+
+export type {
+  SurfaceConnectionState,
+  SurfaceRecord,
+  SurfaceDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/surfaces';
+export { createInitialSurfaceState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/surfaces';
+
+export type {
+  AcpTransportState,
+  AcpConnection,
+  AcpDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/acp';
+export { createInitialAcpState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/acp';
+
+export type {
+  IntegrationStatus,
+  IntegrationCategory,
+  IntegrationRecord,
+  IntegrationDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/integrations';
+export { createInitialIntegrationsState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/integrations';
+
+export type {
+  TelemetryEventRecord,
+  SessionMetrics,
+  TraceContext,
+  TelemetryDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/telemetry';
+export { createInitialTelemetryState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/telemetry';
+
+export type {
+  GitFileStatus,
+  GitFileRecord,
+  GitCommitSummary,
+  GitBranchInfo,
+  GitDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/git';
+export { createInitialGitState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/git';
+
+export type {
+  IndexStatus,
+  LanguageServerRecord,
+  FileWatcherStatus,
+  DiscoveryDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/discovery';
+export { createInitialDiscoveryState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/discovery';
+
+export type {
+  IntelligenceFeatureStatus,
+  LspDiagnostic,
+  WorkspaceSymbol,
+  IntelligenceHoverState,
+  IntelligenceDomainState,
+} from '@pellux/goodvibes-sdk/platform/runtime/store/domains/intelligence';
+export { createInitialIntelligenceState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/intelligence';
+
+export type {
+  RenderBudgetStatus,
+  RenderCycleRecord,
+  InputLatencySample,
+  UiPerfDomainState,
+} from './ui-perf.ts';
+export { createInitialUiPerfState } from './ui-perf.ts';

package/src/runtime/store/domains/panels.ts

@@ -0,0 +1,117 @@
+/**
+ * Panels domain state — tracks the panel-first operator UX surfaces:
+ * which panels are open, their layout, and focus state.
+ */
+
+/** All known panel identifiers in the TUI. */
+export type PanelId =
+  | 'main_conversation'
+  | 'agent_monitor'
+  | 'task_list'
+  | 'tool_trace'
+  | 'diff_viewer'
+  | 'file_explorer'
+  | 'git_status'
+  | 'mcp_inspector'
+  | 'plugin_manager'
+  | 'telemetry_dashboard'
+  | 'session_list';
+
+/** Layout position within a split-pane TUI layout. */
+export type PanelPosition = 'primary' | 'secondary' | 'sidebar' | 'footer';
+
+/** State of a single panel. */
+export interface PanelState {
+  /** Panel identifier. */
+  id: PanelId;
+  /** Whether the panel is currently open/visible. */
+  open: boolean;
+  /** Layout position assignment. */
+  position: PanelPosition;
+  /** Relative size weight within its position slot (1–100). */
+  sizeWeight: number;
+  /** Whether the panel currently has input focus. */
+  focused: boolean;
+  /** Epoch ms when the panel was last activated. */
+  lastActivatedAt?: number;
+  /**
+   * Scroll offset in lines (for scrollable panels).
+   */
+  scrollOffset: number;
+  /** Whether the panel content is collapsed. */
+  collapsed: boolean;
+}
+
+/**
+ * PanelDomainState — panel layout and focus management.
+ */
+export interface PanelDomainState {
+  // ── Domain metadata ────────────────────────────────────────────────────────
+  /** Monotonic revision counter; increments on every mutation. */
+  revision: number;
+  /** Timestamp of last mutation (Date.now()). */
+  lastUpdatedAt: number;
+  /** Subsystem that triggered the last mutation. */
+  source: string;
+
+  // ── Panel registry ─────────────────────────────────────────────────────────
+  /** All panels keyed by PanelId. */
+  panels: Map<PanelId, PanelState>;
+  /** The panel currently holding keyboard focus. */
+  focusedPanelId: PanelId;
+  /** Previously focused panel (for focus restoration). */
+  previousFocusedPanelId?: PanelId;
+
+  // ── Layout ─────────────────────────────────────────────────────────────────
+  /** Whether the sidebar is visible. */
+  sidebarVisible: boolean;
+  /** Whether the footer panel row is visible. */
+  footerVisible: boolean;
+  /** Current terminal width in columns. */
+  terminalColumns: number;
+  /** Current terminal height in rows. */
+  terminalRows: number;
+}
+
+/**
+ * Returns the default initial state for the panels domain.
+ */
+export function createInitialPanelsState(): PanelDomainState {
+  const defaultPanel = (id: PanelId, open: boolean, position: PanelPosition): PanelState => ({
+    id,
+    open,
+    position,
+    sizeWeight: 50,
+    focused: id === 'main_conversation',
+    lastActivatedAt: undefined,
+    scrollOffset: 0,
+    collapsed: false,
+  });
+
+  const panels = new Map<PanelId, PanelState>([
+    ['main_conversation', defaultPanel('main_conversation', true, 'primary')],
+    ['agent_monitor', defaultPanel('agent_monitor', false, 'secondary')],
+    ['task_list', defaultPanel('task_list', false, 'secondary')],
+    ['tool_trace', defaultPanel('tool_trace', false, 'footer')],
+    ['diff_viewer', defaultPanel('diff_viewer', false, 'secondary')],
+    ['file_explorer', defaultPanel('file_explorer', false, 'sidebar')],
+    ['git_status', defaultPanel('git_status', false, 'sidebar')],
+    ['mcp_inspector', defaultPanel('mcp_inspector', false, 'secondary')],
+    ['plugin_manager', defaultPanel('plugin_manager', false, 'secondary')],
+    ['telemetry_dashboard', defaultPanel('telemetry_dashboard', false, 'secondary')],
+    ['session_list', defaultPanel('session_list', false, 'sidebar')],
+  ]);
+
+  return {
+    revision: 0,
+    lastUpdatedAt: 0,
+    source: 'init',
+    panels,
+    focusedPanelId: 'main_conversation',
+    previousFocusedPanelId: undefined,
+    sidebarVisible: false,
+    footerVisible: false,
+    terminalColumns: 80,
+    terminalRows: 24,
+  };
+}

package/src/runtime/store/domains/permissions.ts

@@ -0,0 +1,143 @@
+/**
+ * Permissions domain state — tracks the permission mode, session approvals,
+ * and the most recent permission decision with full audit trail.
+ */
+
+import type { PermissionCategory } from '../../../permissions/manager.ts';
+import type { PermissionRiskLevel } from '@pellux/goodvibes-sdk/platform/permissions/types';
+
+/** Permission evaluation modes (maps to PermissionsToolConfig). */
+export type PermissionMode =
+  | 'default'
+  | 'plan'
+  | 'allow-all'
+  | 'custom'
+  | 'background-restricted';
+
+/** States for the permission decision machine. */
+export type PermissionDecisionMachineState =
+  | 'collect_rules'
+  | 'normalize_input'
+  | 'evaluate_policy'
+  | 'evaluate_runtime_mode'
+  | 'evaluate_session_override'
+  | 'final_safety_checks'
+  | 'decision_emitted';
+
+/** The outcome of a permission decision. */
+export type PermissionDecisionOutcome = 'approved' | 'denied' | 'deferred';
+
+/** Source layer that determined the permission outcome. */
+export type PermissionSourceLayer =
+  | 'config_policy'
+  | 'managed_policy'
+  | 'runtime_mode'
+  | 'session_override'
+  | 'safety_check'
+  | 'user_prompt';
+
+/** Reason codes for a permission decision. */
+export type PermissionDecisionReason =
+  | 'config_allow'
+  | 'config_deny'
+  | 'managed_policy_allow'
+  | 'managed_policy_deny'
+  | 'mode_allow_all'
+  | 'mode_denied'
+  | 'mode_plan_deny'
+  | 'mode_background_restricted'
+  | 'session_cached_approval'
+  | 'session_cached_denial'
+  | 'safety_guardrail'
+  | 'user_approved'
+  | 'user_denied';
+
+/** Full record of the most recent permission decision. */
+export interface PermissionDecision {
+  /** Tool call ID this decision is for. */
+  callId: string;
+  /** Tool name. */
+  toolName: string;
+  /** Permission category. */
+  category: PermissionCategory;
+  /** State machine state when the decision was emitted. */
+  machineState: PermissionDecisionMachineState;
+  /** Final outcome. */
+  outcome: PermissionDecisionOutcome;
+  /** Primary reason code. */
+  reason: PermissionDecisionReason;
+  /** Source layer that yielded the decision. */
+  sourceLayer: PermissionSourceLayer;
+  /** Whether the decision was persisted to session approvals. */
+  persisted: boolean;
+  /** Semantic classification surfaced with the decision. */
+  classification?: string;
+  /** Risk level surfaced with the decision. */
+  riskLevel?: PermissionRiskLevel;
+  /** Human-readable summary for operators and the prompt UI. */
+  summary?: string;
+  /** Epoch ms when the decision was emitted. */
+  decidedAt: number;
+}
+
+/**
+ * PermissionDomainState — permission configuration and decision state.
+ */
+export interface PermissionDomainState {
+  // ── Domain metadata ────────────────────────────────────────────────────────
+  /** Monotonic revision counter; increments on every mutation. */
+  revision: number;
+  /** Timestamp of last mutation (Date.now()). */
+  lastUpdatedAt: number;
+  /** Subsystem that triggered the last mutation. */
+  source: string;
+
+  // ── Mode ───────────────────────────────────────────────────────────────────
+  /** Current global permission mode. */
+  mode: PermissionMode;
+  /** Whether the user is currently being prompted for a permission decision. */
+  awaitingDecision: boolean;
+  /** Current state of the decision state machine (while a decision is in flight). */
+  decisionMachineState?: PermissionDecisionMachineState;
+
+  // ── Session approvals ──────────────────────────────────────────────────────
+  /**
+   * Per-session tool approval cache.
+   * Key format: "<toolName>:<argsHash>" → boolean (approved/denied).
+   */
+  sessionApprovals: Map<string, boolean>;
+  /** Number of approvals granted this session. */
+  approvalCount: number;
+  /** Number of denials issued this session. */
+  denialCount: number;
+
+  // ── Last decision ──────────────────────────────────────────────────────────
+  /** The most recent permission decision record. */
+  lastDecision?: PermissionDecision;
+
+  // ── Statistics ─────────────────────────────────────────────────────────────
+  /** Total permission checks performed this session. */
+  totalChecks: number;
+  /** Total checks that were served from session cache. */
+  cachedChecks: number;
+}
+
+/**
+ * Returns the default initial state for the permissions domain.
+ */
+export function createInitialPermissionsState(): PermissionDomainState {
+  return {
+    revision: 0,
+    lastUpdatedAt: 0,
+    source: 'init',
+    mode: 'default',
+    awaitingDecision: false,
+    decisionMachineState: undefined,
+    sessionApprovals: new Map(),
+    approvalCount: 0,
+    denialCount: 0,
+    lastDecision: undefined,
+    totalChecks: 0,
+    cachedChecks: 0,
+  };
+}

package/src/runtime/store/domains/ui-perf.ts

@@ -0,0 +1,103 @@
+/**
+ * UI performance domain state — tracks TUI render performance,
+ * frame rates, and input responsiveness metrics.
+ */
+
+/** Render budget status. */
+export type RenderBudgetStatus = 'ok' | 'warning' | 'critical';
+
+/** A single render cycle record. */
+export interface RenderCycleRecord {
+  /** Sequential render cycle ID. */
+  cycleId: number;
+  /** Epoch ms when the render was requested. */
+  requestedAt: number;
+  /** Epoch ms when the render completed. */
+  completedAt: number;
+  /** Render duration in ms. */
+  durationMs: number;
+  /** Whether the render exceeded the budget. */
+  overBudget: boolean;
+}
+
+/** Input latency sample. */
+export interface InputLatencySample {
+  /** Epoch ms when the key event was received. */
+  keyEventAt: number;
+  /** Epoch ms when the UI responded to the input. */
+  respondedAt: number;
+  /** Latency in ms. */
+  latencyMs: number;
+}
+
+/**
+ * UiPerfDomainState — TUI render and input performance metrics.
+ */
+export interface UiPerfDomainState {
+  // ── Domain metadata ────────────────────────────────────────────────────────
+  /** Monotonic revision counter; increments on every mutation. */
+  revision: number;
+  /** Timestamp of last mutation (Date.now()). */
+  lastUpdatedAt: number;
+  /** Subsystem that triggered the last mutation. */
+  source: string;
+
+  // ── Render metrics ─────────────────────────────────────────────────────────
+  /** Total render cycles since session start. */
+  totalRenderCycles: number;
+  /** Moving average render duration in ms (last 20 cycles). */
+  avgRenderMs: number;
+  /** Maximum render duration observed. */
+  maxRenderMs: number;
+  /** Number of render cycles that exceeded budget. */
+  overBudgetCount: number;
+  /** Current render budget status. */
+  budgetStatus: RenderBudgetStatus;
+  /** Target render budget in ms (default: 16ms for ~60fps). */
+  targetBudgetMs: number;
+  /** Ring buffer of recent render cycles. */
+  recentCycles: RenderCycleRecord[];
+  /** Maximum number of render cycles to keep. */
+  maxCycleBuffer: number;
+
+  // ── Input latency ─────────────────────────────────────────────────────────
+  /** Moving average input response latency in ms. */
+  avgInputLatencyMs: number;
+  /** Maximum observed input latency in ms. */
+  maxInputLatencyMs: number;
+  /** Ring buffer of recent input latency samples. */
+  recentInputLatency: InputLatencySample[];
+
+  // ── Memory ────────────────────────────────────────────────────────────────
+  /** Bun process heap usage in bytes (polled). */
+  heapUsedBytes: number;
+  /** Bun process RSS in bytes. */
+  rssBytes: number;
+  /** Epoch ms of the last memory sample. */
+  lastMemorySampleAt?: number;
+}
+
+/**
+ * Returns the default initial state for the UI performance domain.
+ */
+export function createInitialUiPerfState(): UiPerfDomainState {
+  return {
+    revision: 0,
+    lastUpdatedAt: 0,
+    source: 'init',
+    totalRenderCycles: 0,
+    avgRenderMs: 0,
+    maxRenderMs: 0,
+    overBudgetCount: 0,
+    budgetStatus: 'ok',
+    targetBudgetMs: 16,
+    recentCycles: [],
+    maxCycleBuffer: 60,
+    avgInputLatencyMs: 0,
+    maxInputLatencyMs: 0,
+    recentInputLatency: [],
+    heapUsedBytes: 0,
+    rssBytes: 0,
+    lastMemorySampleAt: undefined,
+  };
+}