Common 🧑🏻‍🏭

The Pure Abstract Foundation for Land 🏞️

VS Code's codebase imports concrete implementations directly. Testing a single component means mocking entire subsystems. There is no dependency injection at the architecture level.

"Mock any service and test any element in isolation, no running editor required."

Rust API Documentation 📖

Overview

Common is the architectural core of the Land Code Editor's native backend. It contains no working code — only abstract definitions. Think of it as the shared vocabulary that every other native component speaks.

It defines several things that the rest of the system depends on:

Service traits — Abstract descriptions of what every editor service should be able to do (read files, open terminals, search code, show UI dialogs). Each trait says what needs to happen, never how.
ActionEffect system — Instead of calling functions that immediately do work, components construct descriptions of the work they want done (an "effect") and hand it to a runtime. This means effects can be inspected, tested, composed, and controlled before execution.
Data Transfer Objects (DTOs) — The data structures that flow between components. All types work with serde so they serialize cleanly for IPC between Mountain ⛰️, Cocoon 🦋, Grove 🌳, and all sidecars.
CommonError — One error type for every possible failure across every service. File system errors, terminal errors, language feature errors — all reported the same way.
Transport layer — A TransportStrategy trait that defines how components talk to each other, without committing to any specific protocol. Concrete transports (gRPC, IPC, WASM, Mist) are implemented in Grove 🌳.
Telemetry — A shared pipeline for sending events to PostHog and traces to any OTLP-compatible backend.

Everything in Mountain ⛰️ — and any future native component — is built by implementing these traits and consuming these effects. The crate itself knows nothing about Tauri, gRPC, or application startup. That separation is what lets you test any component in isolation by providing mock implementations of the traits it needs.

Common is engineered to:

Define Pure Abstractions — Every application capability is expressed as an async trait with zero concrete implementation logic.
Enable Compile-Time DI — The Environment and Requires traits let components declare what services they need without hard-coding where those services come from.
Stabilize Data Contracts — All DTOs and error types form the stable IPC contract between Mountain ⛰️, Cocoon 🦋, Grove 🌳, and all sidecars.
Provide Transport-Agnostic Communication — The TransportStrategy trait abstracts the wire protocol so the same handler code works over gRPC, IPC, WASM, or Mist without changes.

Key Features ⚙️

Declarative ActionEffect System — Instead of calling functions that immediately perform work, components construct an ActionEffect — a value that describes what should happen — and hand it to the ApplicationRunTime for execution. This makes operations inspectable, composable, and testable before they ever touch the filesystem or network. For example, instead of writing a function that opens a file, you call a function that returns a description of opening that file. The runtime decides when and how to execute it.

Compile-Time Dependency Injection — The Environment and Requires traits let components declare what services they need without hard-coding where those services come from. A component that needs a file system just says "I require a FileSystemReader" — it doesn't care whether that's a real disk, a mock for testing, or a virtual filesystem. All core services are defined as async traits, keeping the entire system asynchronous-first.

DTO Library for IPC - Every data structure used for IPC communication with Cocoon and internal state management in Mountain is defined here. All types are serde-compatible, forming the stable contract between all Land components.

Unified Error Handling - A single CommonError enum covers every possible failure across all service domains - FileSystem, Terminal, SCM, LanguageFeature, Transport, and more. Error handling is consistent and predictable everywhere.

Transport-Agnostic Communication - The Transport/ layer defines a TransportStrategy trait. Concrete implementations (gRPCTransport, IPCTransport, WASMTransport, MistTransport) live in Grove.

Dual-Pipe Telemetry - The Telemetry/ module provides a shared PostHog + OTLP emit surface consumed by all Rust sidecars.

Minimal Dependencies - This crate depends only on serde, tokio, async-trait, and a handful of foundational crates. It has zero knowledge of Tauri, gRPC, or any specific application logic.

Core Architecture Principles 🏗️

Principle	Description	Key Components
Abstraction	Define every application capability as an abstract `async trait`. Never include concrete implementation logic.	All `Provider.rs` and `Manager.rs` files
Declarativism	Represent every operation as an `ActionEffect` value. The crate provides constructor functions for these effects.	`Effect/*`, all effect constructor files
Composability	The `ActionEffect` system and trait-based DI are designed to be composed, allowing complex workflows to be built from simple, reusable pieces.	`Environment/`, `Effect/`
Contract-First	Define all data structures (`DTO/`) and error types (`Error/`) first. These form the stable contract for all other components.	`DTO/`, `Error/`
Purity	This crate has minimal dependencies and is completely independent of `Tauri`, `gRPC`, or any specific application logic.	`Cargo.toml`

System Architecture

graph LR
    classDef common   fill:#d4f5d4,stroke:#27ae60,stroke-width:2px,color:#0a3a0a;
    classDef mountain fill:#f0d0ff,stroke:#9b59b6,stroke-width:2px,color:#2c0050;
    classDef consumer fill:#cce8ff,stroke:#2980b9,stroke-width:1px,color:#00304a;

    classDef transport fill:#fff3c0,stroke:#f39c12,stroke-width:1px,stroke-dasharray:5 5,color:#5a3e00;

    subgraph COMMON["Common - Pure Abstract Foundation (no Tauri / gRPC deps)"]
        direction TB
        subgraph CORE["Effect System"]
            Traits["async trait per service domain\nFileSystem · Terminal · SCM · Storage\nUI · Search · Document · TreeView…"]:::common
            Effects["ActionEffect - operations as values\nConstructors per domain"]:::common
            Effects -. depends on .-> Traits
        end
        subgraph DATA["Data Layer"]
            DTOs["DTO/ - serde-compatible structs\nfor IPC + internal state"]:::common
            Errors["CommonError - unified error enum"]:::common
        end
        subgraph INFRA["Infrastructure"]
            Transport["Transport/ - TransportStrategy\ntrait + config types"]:::transport
            Telemetry["Telemetry/ - PostHog + OTLP\ndual-pipe emit surface"]:::common
            Env["Environment/ + Effect/\nApplicationRunTime trait\nDI via Requires / HasEnvironment"]:::common
        end
    end

    subgraph MOUNTAIN["Mountain ⛰️ - Primary Consumer"]
        MountainEnv["Environment/ Providers\n(concrete trait impls)"]:::mountain
        AppRunTime["ApplicationRunTime\n(executes ActionEffects)"]:::mountain
        MountainEnv -.implements.-> Traits
        AppRunTime -.executes.-> Effects
        AppRunTime -.uses.-> DTOs
    end

    subgraph TESTS["Tests"]
        MockImpls["Mock trait implementations"]:::consumer
        MockImpls -.mocks.-> Traits
    end

    Air["Air 🪁 daemon\n(uses Transport + Telemetry)"]:::consumer
    Air -.uses.-> Transport
    Air -.uses.-> Telemetry

Connection paths:

Path	Relationship	Use Case
`Mountain` → `Common`	Implements traits, consumes effects	Primary consumer of all service definitions
`Grove` → `Common` transport layer	Implements `TransportStrategy`	`gRPC`, `IPC`, `WASM`, `Mist` transports
`Air` → `Common` transport + telemetry	Uses `Transport` and `Telemetry` modules	Background daemon communication
Sidecars → `Common` telemetry	Consumes `PostHog` + `OTLP` emit surface	Shared telemetry across all `Rust` sidecars
Mock tests → `Common` traits	Implements mock providers	Fast, isolated unit tests
`Cocoon` ↔ `Common`	Shares DTOs via `serde`	IPC data contract compatibility

Key Components

Component	Path	Description
Library Root	`Source/Library.rs`	Crate root, declares all modules.
Environment	`Source/Environment/`	The core DI system (Environment, Requires, HasEnvironment traits).
Effect	`Source/Effect/`	The ActionEffect system (ActionEffect, ApplicationRunTime traits).
Error	`Source/Error/`	The universal CommonError enum.
DTO	`Source/DTO/`	Shared Data Transfer Objects (re-exports from service modules).
Utility	`Source/Utility/`	Utility functions (e.g., Serialization).
Command	`Source/Command/`	Command management service.
Configuration	`Source/Configuration/`	Configuration provider service.
CustomEditor	`Source/CustomEditor/`	Custom editor provider service.
Debug	`Source/Debug/`	Debug service.
Diagnostic	`Source/Diagnostic/`	Diagnostic manager service.
Document	`Source/Document/`	Document provider service.
ExtensionManagement	`Source/ExtensionManagement/`	Extension management service.
FileSystem	`Source/FileSystem/`	File system read/write service.
IPC	`Source/IPC/`	Inter-process communication service.
Keybinding	`Source/Keybinding/`	Keybinding provider service.
LanguageFeature	`Source/LanguageFeature/`	Language feature provider registry.
Output	`Source/Output/`	Output channel manager service.
Search	`Source/Search/`	Search provider service.
Secret	`Source/Secret/`	Secret storage provider service.
SourceControlManagement	`Source/SourceControlManagement/`	Source control management service.
StatusBar	`Source/StatusBar/`	Status bar provider service.
Storage	`Source/Storage/`	Storage provider service.
Synchronization	`Source/Synchronization/`	Synchronization provider service.
Telemetry	`Source/Telemetry/`	Telemetry service (dual-pipe PostHog + OTLP).
Terminal	`Source/Terminal/`	Terminal provider service.
Testing	`Source/Testing/`	Test controller service.
Transport	`Source/Transport/`	Transport-agnostic communication layer.
TreeView	`Source/TreeView/`	Tree view provider service.
UserInterface	`Source/UserInterface/`	User interface provider service.
Webview	`Source/Webview/`	Webview provider service.
Workspace	`Source/Workspace/`	Workspace provider service.

Project Structure 🗺️

Element/Common/
├── Source/
│   ├── Library.rs                       # Crate root, declares all modules
│   ├── Command/                         # Command management service
│   │   ├── mod.rs
│   │   ├── CommandExecutor.rs
│   │   ├── ExecuteCommand.rs
│   │   ├── GetAllCommands.rs
│   │   ├── RegisterCommand.rs
│   │   └── UnregisterCommand.rs
│   ├── Configuration/                   # Configuration provider service
│   │   ├── mod.rs
│   │   ├── ConfigurationProvider.rs
│   │   ├── ConfigurationInspector.rs
│   │   ├── GetConfiguration.rs
│   │   ├── InspectConfiguration.rs
│   │   ├── UpdateConfiguration.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       ├── ConfigurationInitializationDTO.rs
│   │       ├── ConfigurationOverridesDTO.rs
│   │       ├── ConfigurationScope.rs
│   │       ├── ConfigurationTarget.rs
│   │       └── InspectResultDataDTO.rs
│   ├── CustomEditor/                    # Custom editor provider service
│   │   ├── mod.rs
│   │   └── CustomEditorProvider.rs
│   ├── Debug/                           # Debug service
│   │   ├── mod.rs
│   │   └── DebugService.rs
│   ├── Diagnostic/                      # Diagnostic manager service
│   │   ├── mod.rs
│   │   ├── DiagnosticManager.rs
│   │   ├── ClearDiagnostics.rs
│   │   ├── GetAllDiagnostics.rs
│   │   └── SetDiagnostics.rs
│   ├── Document/                        # Document provider service
│   │   ├── mod.rs
│   │   ├── DocumentProvider.rs
│   │   ├── ApplyDocumentChanges.rs
│   │   ├── OpenDocument.rs
│   │   ├── SaveAllDocuments.rs
│   │   ├── SaveDocument.rs
│   │   └── SaveDocumentAs.rs
│   ├── DTO/                             # Shared Data Transfer Objects
│   │   ├── mod.rs
│   │   └── WorkspaceEditDTO.rs
│   ├── Effect/                          # ActionEffect system
│   │   ├── mod.rs
│   │   ├── ActionEffect.rs
│   │   ├── ApplicationRunTime.rs
│   │   └── ExecuteEffect.rs
│   ├── Environment/                     # Dependency injection system
│   │   ├── mod.rs
│   │   ├── Environment.rs
│   │   ├── HasEnvironment.rs
│   │   └── Requires.rs
│   ├── Error/                           # Unified error handling
│   │   ├── mod.rs
│   │   └── CommonError.rs
│   ├── ExtensionManagement/             # Extension management service
│   │   ├── mod.rs
│   │   └── ExtensionManagementService.rs
│   ├── FileSystem/                      # File system read/write service
│   │   ├── mod.rs
│   │   ├── FileSystemReader.rs
│   │   ├── FileSystemWriter.rs
│   │   ├── FileWatcherProvider.rs
│   │   ├── Copy.rs
│   │   ├── CreateDirectory.rs
│   │   ├── CreateFile.rs
│   │   ├── Delete.rs
│   │   ├── ReadDirectory.rs
│   │   ├── ReadFile.rs
│   │   ├── Rename.rs
│   │   ├── StatFile.rs
│   │   ├── WriteFileBytes.rs
│   │   ├── WriteFileString.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       ├── FileSystemStatDTO.rs
│   │       └── FileTypeDTO.rs
│   ├── IPC/                             # Inter-process communication service
│   │   ├── mod.rs
│   │   ├── Channel.rs
│   │   ├── IPCProvider.rs
│   │   ├── EstablishHostConnection.rs
│   │   ├── ProxyCallToSideCar.rs
│   │   ├── SendNotificationToSideCar.rs
│   │   ├── SendRequestToSideCar.rs
│   │   ├── SkyEvent.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       └── ProxyTarget.rs
│   ├── Keybinding/                      # Keybinding provider service
│   │   ├── mod.rs
│   │   └── KeybindingProvider.rs
│   ├── LanguageFeature/                 # Language feature provider registry
│   │   ├── mod.rs
│   │   ├── LanguageFeatureProviderRegistry.rs
│   │   ├── RegisterProvider.rs
│   │   ├── UnregisterProvider.rs
│   │   ├── ProvideCallHierarchy.rs
│   │   ├── ProvideCodeActions.rs
│   │   ├── ProvideCodeLenses.rs
│   │   ├── ProvideCompletions.rs
│   │   ├── ProvideDefinition.rs
│   │   ├── ProvideDocumentFormatting.rs
│   │   ├── ProvideDocumentHighlights.rs
│   │   ├── ProvideDocumentSymbols.rs
│   │   ├── ProvideFoldingRanges.rs
│   │   ├── ProvideHover.rs
│   │   ├── ProvideInlayHints.rs
│   │   ├── ProvideLinkedEditingRanges.rs
│   │   ├── ProvideOnTypeFormatting.rs
│   │   ├── ProvideReferences.rs
│   │   ├── ProvideRenameEdits.rs
│   │   ├── ProvideSelectionRanges.rs
│   │   ├── ProvideSemanticTokens.rs
│   │   ├── ProvideSignatureHelp.rs
│   │   ├── ProvideTypeHierarchy.rs
│   │   ├── ProvideWorkspaceSymbols.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       ├── CompletionContextDTO.rs
│   │       ├── CompletionItemDTO.rs
│   │       ├── CompletionListDTO.rs
│   │       ├── HoverResultDTO.rs
│   │       ├── IMarkdownStringDTO.rs
│   │       ├── LocationDTO.rs
│   │       ├── PositionDTO.rs
│   │       ├── ProviderType.rs
│   │       ├── RangeDTO.rs
│   │       └── TextEditDTO.rs
│   ├── Output/                          # Output channel manager service
│   │   ├── mod.rs
│   │   ├── OutputChannelManager.rs
│   │   ├── AppendToOutputChannel.rs
│   │   ├── ClearOutputChannel.rs
│   │   ├── CloseOutputChannelView.rs
│   │   ├── DisposeOutputChannel.rs
│   │   ├── RegisterOutputChannel.rs
│   │   ├── ReplaceOutputChannelContent.rs
│   │   └── RevealOutputChannel.rs
│   ├── Search/                          # Search provider service
│   │   ├── mod.rs
│   │   └── SearchProvider.rs
│   ├── Secret/                          # Secret storage provider service
│   │   ├── mod.rs
│   │   ├── SecretProvider.rs
│   │   ├── DeleteSecret.rs
│   │   ├── GetSecret.rs
│   │   └── StoreSecret.rs
│   ├── SourceControlManagement/         # Source control management service
│   │   ├── mod.rs
│   │   ├── SourceControlManagementProvider.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       ├── SourceControlCreateDTO.rs
│   │       ├── SourceControlGroupUpdateDTO.rs
│   │       ├── SourceControlInputBoxDTO.rs
│   │       ├── SourceControlManagementGroupDTO.rs
│   │       ├── SourceControlManagementProviderDTO.rs
│   │       ├── SourceControlManagementResourceDTO.rs
│   │       └── SourceControlUpdateDTO.rs
│   ├── StatusBar/                       # Status bar provider service
│   │   ├── mod.rs
│   │   ├── StatusBarProvider.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       └── StatusBarEntryDTO.rs
│   ├── Storage/                         # Storage provider service
│   │   ├── mod.rs
│   │   ├── StorageProvider.rs
│   │   ├── GetStorageItem.rs
│   │   └── SetStorageItem.rs
│   ├── Synchronization/                 # Synchronization provider service
│   │   ├── mod.rs
│   │   └── SynchronizationProvider.rs
│   ├── Telemetry/                       # Telemetry service (PostHog + OTLP)
│   │   ├── mod.rs
│   │   ├── CaptureError.rs
│   │   ├── CaptureEvent.rs
│   │   ├── CaptureSession.rs
│   │   ├── Client.rs
│   │   ├── Configuration.rs
│   │   ├── DistinctId.rs
│   │   ├── EmitOTLPSpan.rs
│   │   ├── Initialize.rs
│   │   ├── IsAllowed.rs
│   │   ├── Tier.rs
│   │   └── Traceparent.rs
│   ├── Terminal/                        # Terminal provider service
│   │   ├── mod.rs
│   │   ├── TerminalProvider.rs
│   │   └── CreateTerminal.rs
│   ├── Testing/                         # Test controller service
│   │   ├── mod.rs
│   │   └── TestController.rs
│   ├── Transport/                       # Transport-agnostic communication layer
│   │   ├── mod.rs
│   │   ├── TransportStrategy.rs
│   │   ├── TransportConfig.rs
│   │   ├── TransportError.rs
│   │   ├── CircuitBreaker.rs
│   │   ├── Metrics.rs
│   │   ├── Retry.rs
│   │   ├── UnifiedRequest.rs
│   │   ├── UnifiedResponse.rs
│   │   ├── gRPC.rs
│   │   ├── IPC.rs
│   │   ├── WASM.rs
│   │   ├── Common/
│   │   │   └── mod.rs
│   │   ├── Registry/
│   │   │   └── mod.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       ├── Correlation.rs
│   │       ├── TransportError.rs
│   │       ├── UnifiedRequest.rs
│   │       └── UnifiedResponse.rs
│   ├── TreeView/                        # Tree view provider service
│   │   ├── mod.rs
│   │   ├── TreeViewProvider.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       ├── TreeItemDTO.rs
│   │       └── TreeViewOptionsDTO.rs
│   ├── UserInterface/                   # User interface provider service
│   │   ├── mod.rs
│   │   ├── UserInterfaceProvider.rs
│   │   ├── ShowInputBox.rs
│   │   ├── ShowMessage.rs
│   │   ├── ShowOpenDialog.rs
│   │   ├── ShowQuickPick.rs
│   │   ├── ShowSaveDialog.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       ├── DialogOptionsDTO.rs
│   │       ├── FileFilterDTO.rs
│   │       ├── InputBoxOptionsDTO.rs
│   │       ├── MessageOptionsDTO.rs
│   │       ├── MessageSeverity.rs
│   │       ├── OpenDialogOptionsDTO.rs
│   │       ├── QuickPickItemDTO.rs
│   │       ├── QuickPickOptionsDTO.rs
│   │       └── SaveDialogOptionsDTO.rs
│   ├── Utility/                         # Utility functions
│   │   ├── mod.rs
│   │   └── Serialization.rs
│   ├── Webview/                         # Webview provider service
│   │   ├── mod.rs
│   │   ├── WebviewProvider.rs
│   │   └── DTO/
│   │       ├── mod.rs
│   │       └── WebviewContentOptionsDTO.rs
│   ├── Workspace/                       # Workspace provider service
│   │   ├── mod.rs
│   │   ├── WorkspaceProvider.rs
│   │   ├── WorkspaceEditApplier.rs
│   │   ├── ApplyWorkspaceEdit.rs
│   │   ├── FindFilesInWorkspace.rs
│   │   ├── GetWorkspaceConfigurationPath.rs
│   │   ├── GetWorkspaceFolderInfo.rs
│   │   ├── GetWorkspaceFoldersInfo.rs
│   │   ├── GetWorkspaceName.rs
│   │   ├── IsWorkspaceTrusted.rs
│   │   ├── OpenFile.rs
│   │   └── RequestWorkspaceTrust.rs
│   ├── Container.ts                     # DI container (TypeScript)
│   ├── EffectSmol.ts                    # Lightweight effect runtime (TypeScript)
│   ├── Errors.ts                        # Error types (TypeScript)
│   ├── PubSub.ts                        # Pub/sub bus (TypeScript)
│   ├── Ref.ts                           # Mutable references (TypeScript)
│   └── Result.ts                        # Result type (TypeScript)
├── TypeScript/
│   ├── Function/                        # Effect constructors (TypeScript)
│   └── Interface/                       # Service interfaces (TypeScript)
├── Documentation/
│   └── GitHub/
│       ├── Architecture.md              # Internal architecture overview
│       └── DeepDive.md                  # ActionEffect system deep dive
├── build.rs                             # Cargo build script
├── Cargo.toml
├── CHANGELOG.md
├── LICENSE
└── README.md

In the Land Project

Common is the foundational layer upon which the entire native backend is built. It has no knowledge of its consumers, but they are entirely dependent on it.

Element	Relationship	Description
Mountain ⛰️	Primary consumer	Implements traits with concrete `Environment/` providers, executes `ActionEffect`s via `ApplicationRunTime`
Grove 🌳	Transport consumer	Implements `TransportStrategy` trait for `gRPC`, `IPC`, `WASM`, `Mist` transports
Cocoon 🦋	DTO consumer	Shares DTOs via `serde` for IPC data contract compatibility
Air 🪁	Module consumer	Uses `Transport` and `Telemetry` modules for daemon communication
Echo 📣	Telemetry consumer	Consumes the shared `PostHog` + `OTLP` telemetry pipe
Tests	Mock consumer	Implements mock trait providers for fast, isolated unit testing

Getting Started 🚀

Prerequisites

Rust 1.85 or later

Build

Common is intended to be used as a local path dependency within the Land workspace. In Mountain's Cargo.toml:

[dependencies]
Common = { path = "../Common" }

Usage

Implement a Trait: In Mountain/Source/Environment/, provide the concrete implementation for a Common trait.

// In Mountain/Source/Environment/FileSystemProvider.rs

use CommonLibrary::FileSystem::{FileSystemReader, FileSystemWriter};

#[async_trait]
impl FileSystemReader for MountainEnvironment {
    async fn ReadFile(&self, Path: &PathBuf) -> Result<Vec<u8>, CommonError> {
        // ... actual tokio::fs call ...
    }
    // ...
}

Create and Execute an Effect: In business logic, create and run an effect.

// In a Mountain service or command

use CommonLibrary::FileSystem;
use CommonLibrary::Effect::ApplicationRunTime;

async fn SomeLogic(Runtime: Arc<impl ApplicationRunTime>) {
    let Path = PathBuf::from("/my/file.txt");
    let ReadEffect = FileSystem::ReadFile(Path);

    match Runtime.Run(ReadEffect).await {
        Ok(Content) => info!("File content length: {}", Content.len()),
        Err(Error) => error!("Failed to read file: {:?}", Error),
    }
}

Key Dependencies

Crate	Purpose
`serde`	Serialization/deserialization for all DTOs
`tokio`	Async runtime for trait definitions
`async-trait`	Enables `async fn` in trait definitions
`thiserror`	Derive macro for `CommonError`
`posthog-rs`	Shared PostHog telemetry client
`uuid`	Transport correlation IDs
`prometheus`	Transport metrics

Security 🔒

Common enforces security at the architectural level:

Layer	Mechanism
Architecture	No concrete implementations - consumers cannot bypass trait boundaries
Type system	All capabilities are abstract `async trait`s with explicit type signatures
Error model	Single `CommonError` enum prevents information leakage through ad-hoc error types
Dependencies	Zero dependency on `Tauri`, `gRPC`, or any networking crate - no ambient authority
Testing	Mock implementations allow security-critical paths to be tested in isolation
Data contracts	`serde`-compatible DTOs with explicit schemas prevent deserialization attacks

Compatibility

Common is designed to be compatible with:

Target	Integration
Mountain ⛰️	Primary consumer - implements all traits, executes effects
Grove 🌳	Implements `TransportStrategy` trait for `gRPC`, `IPC`, `WASM`, `Mist` transports
Cocoon 🦋	Shares DTOs via `serde` for IPC data contract compatibility
Air 🪁	Consumes `Transport` and `Telemetry` modules for daemon communication
Sidecars	All `Rust` sidecars consume the shared `PostHog` + `OTLP` telemetry pipe
Tests	Mock implementations of all traits enable fast, isolated unit testing

API Reference

Rust API Documentation 📖
Architecture Overview
Deep Dive - The ActionEffect system, trait-based DI model, and guide for adding new services

Funding & Acknowledgements 🙏🏻

This project is funded through NGI0 Commons Fund, a fund established by NLnet with financial support from the European Commission's Next Generation Internet program, under grant agreement No 101135429.

The project is operated by PlayForm, based in Sofia, Bulgaria. PlayForm acts as the open-source steward for Code Editor Land under the NGI0 Commons Fund grant.

Name		Name	Last commit message	Last commit date
Latest commit History 1,758 Commits
.cargo		.cargo
.github		.github
Documentation		Documentation
Source		Source
TypeScript		TypeScript
tests		tests
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md
build.rs		build.rs
package.json		package.json
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

Common 🧑🏻‍🏭

Overview

Key Features ⚙️

Core Architecture Principles 🏗️

System Architecture

Key Components

Project Structure 🗺️

In the Land Project

Getting Started 🚀

Prerequisites

Build

Usage

Key Dependencies

Security 🔒

Compatibility

API Reference

Related Documentation

Funding & Acknowledgements 🙏🏻

About

Uh oh!

Releases 6

Packages

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Common 🧑🏻‍🏭

Overview

Key Features ⚙️

Core Architecture Principles 🏗️

System Architecture

Key Components

Project Structure 🗺️

In the Land Project

Getting Started 🚀

Prerequisites

Build

Usage

Key Dependencies

Security 🔒

Compatibility

API Reference

Related Documentation

Funding & Acknowledgements 🙏🏻

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 6

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages