Module IPC 

IPC Module

RESPONSIBILITIES

Inter-process communication (IPC) for the Mountain application, handling communication between the Tauri frontend and the Rust backend through various protocols including Tauri commands, WebSocket, and custom message formats.

Core Functions:

• Message Routing: Route IPC messages to appropriate handlers
• Connection Management: Manage IPC connections with health monitoring
• Security: Implement permission system for IPC access control
• Encryption: Provide secure message channels and compression
• Status Reporting: Report IPC system status and metrics
• Configuration Bridge: Bridge configuration across IPC boundaries
• Wind Sync: Advanced synchronization with Wind UI framework
• Advanced Features: Experimental/advanced IPC features

Architectural Role

The IPC module is the communication layer in Mountain’s architecture:

Sky (Frontend) ──► IPC (Communication) ──► Track (Dispatch) ──► Services
Wind (UI) ───────────────────────────────────────────────────────────────┘
Cocoon (Sidecar) ──► Vine (gRPC) ────────────────────────────┘

Design Principles:

1. Protocol Agnostic: Support multiple IPC protocols
2. Security First: All communications are secured and permission-gated
3. High Performance: Optimized for low-latency communication
4. Observable: Comprehensive logging and metrics

Key Components

• TauriIPCServer: Main IPC server orchestrator
• Message: Message types and routing
• Connection: Connection management and health
• Encryption: Message compression and secure channels
• Security: Permission system
• ConfigurationBridge: Configuration synchronization
• StatusReporter: Status and metrics reporting
• WindAdvancedSync: Wind framework integration
• AdvancedFeatures: Advanced/experimental features

TODOs

High Priority:

• Add comprehensive unit tests for all modules
• Implement connection pooling optimizations
• Add connection timeout handling

Medium Priority:

• Add message batching for efficiency
• Implement keep-alive packets
• Add connection retry logic

Low Priority:

• Add message persistence for offline mode
• Implement message compression ratio optimization
• Add connection encryption rotation

Modules

AdvancedFeatures

Advanced experimental features (collaboration, intelligent caching, performance monitoring). TODO: atomize this 648-LOC single file into a directory; for now consumers spell IPC::AdvancedFeatures::* directly.

Common

Common shared types and abstractions for IPC layer. Shared IPC abstractions used across IPC/. Each submodule owns one concept; callers spell the full path (IPC::Common::HealthStatus::Foo).

ConfigurationBridge

Configuration synchronization bridge.

Connection

Connection management and health monitoring. Connection lifecycle, pooling, and health monitoring for IPC. Submodules: Manager (pool + handles), Types (ConnectionHandle, Stats), Health (background checker). Callers spell the full path; no pub use.

DevLog

Tag-filtered development logging (Trace env var). Must be declared before WindServiceHandlers so the dev_log! macro is available.

EmitWithTraceparent

Outbound emit wrapper that stamps a W3C _traceparent field onto every JSON payload before forwarding to app_handle.emit(...). Sky’s Workbench/Electron/TraceparentBridge.ts extracts the header at the receiving end so spans emitted inside the handler attach to the same Jaeger trace. Release builds short-circuit to a plain emit(...) via cfg!(debug_assertions). Wrap app_handle.emit(name, payload) so every outbound Sky-side Tauri event carries a W3C _traceparent field on its JSON payload. Sky’s Workbench/Electron/TraceparentBridge.ts::ConsumeFromPayload strips the field at the receiving end, registers the trace context for the duration of the event handler, and Sky’s OTELBridge reads it so spans emitted inside the handler attach to the same trace.

Encryption

Message compression and secure channels.

Enhanced

Legacy Enhanced subdirectory.

Message

Message types and routing. Core message types and routing for the IPC layer between Wind and Mountain. Callers spell IPC::Message::Types::TauriIPCMessage (no pub use re-exports).

Permission

Legacy Permission subdirectory.

Security

Permission system for IPC access control.

SkyEmit

Central sky:// emit wrapper that logs under the sky-emit DevLog tag. Optional drop-in for any ApplicationHandle::emit(channel, …) call site; existing emits keep working unchanged.

StatusReporter

Status and metrics reporting (atomized; siblings live in StatusReporter/).

TauriIPCServer_Old

Main Tauri IPC server orchestrator.

UriComponents

Shared UriComponents emitter. Every handler that returns a URI to the renderer must route through this module so the $mid: 1 marshalling marker is never forgotten (without it VS Code’s IPC reviver skips the field and uri.with is not a function cascades through the sidebar).

WindAdvancedSync

Wind UI framework synchronization.

WindAirCommands

Legacy Wind Air Commands.

WindServiceAdapters

Legacy Wind Service Adapters.

WindServiceHandlers

Wind Service Handlers - dispatcher for every MountainIPCInvoke Tauri call from Wind/Output/Sky. The mod.rs inside is the central match that routes wire strings to per-domain atoms or handler files. Atoms live under WindServiceHandlers/<Domain>/<Atom>.rs following the one-export-per-file convention.