Running windows programs under litebox on linux

.cargo/config.toml

@@ -0,0 +1,40 @@
+# Cargo configuration for faster builds and better development experience
+#
+# This configuration provides optional optimizations that can significantly
+# speed up compilation and linking times for local development.
+
+# =============================================================================
+# FAST LINKER CONFIGURATION (OPTIONAL BUT RECOMMENDED)
+# =============================================================================
+# Using a faster linker can reduce link times by 50-70% on large projects.
+# Uncomment ONE of the options below based on what you have installed:
+
+# Option 1: mold - Fastest linker for Linux (HIGHLY RECOMMENDED)
+# Install: sudo apt install mold  or  cargo install --locked mold
+# Typical speedup: 3-5x faster than GNU ld
+# [target.x86_64-unknown-linux-gnu]
+# linker = "clang"
+# rustflags = ["-C", "link-arg=-fuse-ld=mold"]
+
+# Option 2: lld - Fast cross-platform linker from LLVM
+# Install: sudo apt install lld
+# Typical speedup: 2-3x faster than GNU ld
+# [target.x86_64-unknown-linux-gnu]
+# linker = "clang"
+# rustflags = ["-C", "link-arg=-fuse-ld=lld"]
+
+# Option 3: System default linker (currently active)
+# No configuration needed - this is what you're using now
+
+# =============================================================================
+# CARGO ALIASES FOR COMMON TASKS
+# =============================================================================
+[alias]
+# Quick workspace check (excludes packages requiring special toolchains)
+check-fast = "check --workspace --exclude litebox_runner_lvbs --exclude litebox_runner_snp"
+
+# Build only default workspace members (faster than full workspace)
+build-default = "build"
+
+# Run tests with nextest if available (much faster than cargo test)
+test-fast = "nextest run"

.devcontainer/Dockerfile

@@ -0,0 +1,135 @@
+# Use Debian Bookworm as the base image for a stable, modern environment
+FROM debian:bookworm-slim
+
+# Install system dependencies including Node.js
+RUN apt-get update && apt-get install -y \
+    curl \
+    build-essential \
+    pkg-config \
+    libssl-dev \
+    mingw-w64 \
+    gdb \
+    git \
+    ca-certificates \
+    nodejs \
+    npm \
+    libvulkan1 \
+    mesa-vulkan-drivers \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set up Rust environment variables
+ENV RUSTUP_HOME=/usr/local/rustup \
+    CARGO_HOME=/usr/local/cargo \
+    PATH=/usr/local/cargo/bin:$PATH
+
+# Install rustup and the specific nightly toolchain
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain none \
+    && chmod -R a+w $RUSTUP_HOME $CARGO_HOME
+
+# Copy rust-toolchain.toml to install the correct toolchain version
+COPY rust-toolchain.toml /tmp/rust-toolchain.toml
+RUN cd /tmp && rustup show && rustup default nightly-2026-01-15 && rm /tmp/rust-toolchain.toml
+
+# Add Windows GNU target for cross-compilation
+RUN rustup target add x86_64-pc-windows-gnu
+
+# Install cargo-nextest for faster test execution
+RUN cargo install cargo-nextest --locked
+
+# Install MCP servers for GitHub Copilot integration
+# Install GitHub MCP server - provides GitHub repository access (issues, PRs, code search, etc.)
+RUN npm install -g github-mcp-server@latest --unsafe-perm
+
+# Verify installations
+RUN node --version && npm --version && github-mcp-server --version || echo "github-mcp-server installed"
+
+# Create workspace directory
+WORKDIR /workspace
+
+# Copy Cargo workspace files for dependency caching
+# This layer will be cached as long as dependencies don't change
+COPY Cargo.toml Cargo.lock ./
+COPY litebox/Cargo.toml ./litebox/
+COPY litebox_common_linux/Cargo.toml ./litebox_common_linux/
+COPY litebox_common_optee/Cargo.toml ./litebox_common_optee/
+COPY litebox_platform_linux_kernel/Cargo.toml ./litebox_platform_linux_kernel/
+COPY litebox_platform_linux_userland/Cargo.toml ./litebox_platform_linux_userland/
+COPY litebox_platform_windows_userland/Cargo.toml ./litebox_platform_windows_userland/
+COPY litebox_platform_linux_for_windows/Cargo.toml ./litebox_platform_linux_for_windows/
+COPY litebox_platform_lvbs/Cargo.toml ./litebox_platform_lvbs/
+COPY litebox_platform_multiplex/Cargo.toml ./litebox_platform_multiplex/
+COPY litebox_runner_linux_userland/Cargo.toml ./litebox_runner_linux_userland/
+COPY litebox_runner_linux_on_windows_userland/Cargo.toml ./litebox_runner_linux_on_windows_userland/
+COPY litebox_runner_windows_on_linux_userland/Cargo.toml ./litebox_runner_windows_on_linux_userland/
+COPY litebox_runner_lvbs/Cargo.toml ./litebox_runner_lvbs/
+COPY litebox_runner_optee_on_linux_userland/Cargo.toml ./litebox_runner_optee_on_linux_userland/
+COPY litebox_shim_linux/Cargo.toml ./litebox_shim_linux/
+COPY litebox_shim_optee/Cargo.toml ./litebox_shim_optee/
+COPY litebox_shim_windows/Cargo.toml ./litebox_shim_windows/
+COPY litebox_syscall_rewriter/Cargo.toml ./litebox_syscall_rewriter/
+COPY litebox_runner_snp/Cargo.toml ./litebox_runner_snp/
+COPY dev_tests/Cargo.toml ./dev_tests/
+COPY dev_bench/Cargo.toml ./dev_bench/
+
+# Create dummy source files to enable dependency fetching and caching
+# This allows cargo to download and compile dependencies without the actual source code
+RUN mkdir -p litebox/src \
+    litebox_common_linux/src \
+    litebox_common_optee/src \
+    litebox_platform_linux_kernel/src \
+    litebox_platform_linux_userland/src \
+    litebox_platform_windows_userland/src \
+    litebox_platform_linux_for_windows/src \
+    litebox_platform_lvbs/src \
+    litebox_platform_multiplex/src \
+    litebox_runner_linux_userland/src \
+    litebox_runner_linux_on_windows_userland/src \
+    litebox_runner_windows_on_linux_userland/src \
+    litebox_runner_lvbs/src \
+    litebox_runner_optee_on_linux_userland/src \
+    litebox_shim_linux/src \
+    litebox_shim_optee/src \
+    litebox_shim_windows/src \
+    litebox_syscall_rewriter/src \
+    litebox_runner_snp/src \
+    dev_tests/src \
+    dev_bench/src \
+    && touch litebox/src/lib.rs \
+    litebox_common_linux/src/lib.rs \
+    litebox_common_optee/src/lib.rs \
+    litebox_platform_linux_kernel/src/lib.rs \
+    litebox_platform_linux_userland/src/lib.rs \
+    litebox_platform_windows_userland/src/lib.rs \
+    litebox_platform_linux_for_windows/src/lib.rs \
+    litebox_platform_lvbs/src/lib.rs \
+    litebox_platform_multiplex/src/lib.rs \
+    litebox_runner_linux_userland/src/main.rs \
+    litebox_runner_linux_on_windows_userland/src/main.rs \
+    litebox_runner_windows_on_linux_userland/src/main.rs \
+    litebox_runner_lvbs/src/main.rs \
+    litebox_runner_optee_on_linux_userland/src/main.rs \
+    litebox_shim_linux/src/lib.rs \
+    litebox_shim_optee/src/lib.rs \
+    litebox_shim_windows/src/lib.rs \
+    litebox_syscall_rewriter/src/lib.rs \
+    litebox_runner_snp/src/main.rs \
+    dev_tests/src/lib.rs \
+    dev_bench/src/main.rs
+
+# Fetch all dependencies to cache them in the Docker layer
+# This step will be cached as long as Cargo.toml/Cargo.lock don't change
+RUN cargo fetch
+
+# Clean up dummy files - the actual source will be mounted/copied at runtime
+RUN rm -rf litebox litebox_common_linux litebox_common_optee \
+    litebox_platform_linux_kernel litebox_platform_linux_userland \
+    litebox_platform_windows_userland litebox_platform_linux_for_windows \
+    litebox_platform_lvbs litebox_platform_multiplex \
+    litebox_runner_linux_userland litebox_runner_linux_on_windows_userland \
+    litebox_runner_windows_on_linux_userland litebox_runner_lvbs \
+    litebox_runner_optee_on_linux_userland litebox_shim_linux \
+    litebox_shim_optee litebox_shim_windows litebox_syscall_rewriter \
+    litebox_runner_snp dev_tests dev_bench Cargo.toml Cargo.lock
+
+# Set the default command
+CMD ["/bin/bash"]

.devcontainer/README.md

@@ -0,0 +1,150 @@
+# LiteBox Development Container
+
+This directory contains the configuration for a development container that provides a pre-configured environment for working on the LiteBox project.
+
+## What's Included
+
+The devcontainer provides:
+
+- **Rust Toolchain**: Pre-installed Rust nightly-2026-01-15 (as specified in `rust-toolchain.toml`)
+- **Build Tools**: 
+  - `build-essential`, `pkg-config`, `libssl-dev` for compiling Rust projects
+  - `mingw-w64` for cross-compiling Windows PE binaries
+  - `gdb` for debugging
+- **Node.js & npm**: For JavaScript tooling and MCP server support
+- **Rust Targets**: `x86_64-pc-windows-gnu` for Windows cross-compilation
+- **Cargo Tools**: `cargo-nextest` for faster test execution
+- **MCP Servers**: Pre-installed Model Context Protocol servers for AI assistant integration:
+  - **GitHub MCP Server** (`github-mcp-server`) - Provides GitHub API access for repository management, issue/PR operations, code search, and workflow automation
+- **Cached Dependencies**: All Cargo dependencies are pre-downloaded in the container image
+- **VS Code Extensions**:
+  - `rust-analyzer` - Rust language server
+  - `vscode-lldb` - Debugger
+  - `even-better-toml` - TOML syntax support
+
+## Benefits
+
+- **Fast Startup**: Dependencies are cached in the container image, so you don't need to download them every time
+- **Consistent Environment**: Everyone uses the same toolchain and dependencies, including MCP servers for AI assistants
+- **No Local Setup**: No need to install Rust, MinGW, Node.js, or other tools on your local machine
+- **AI-Ready**: Pre-configured MCP servers enable GitHub Copilot and other AI assistants to interact with your repository
+
+## Using the Devcontainer
+
+### GitHub Codespaces
+
+1. Go to the repository on GitHub
+2. Click the "Code" button
+3. Select "Codespaces" tab
+4. Click "Create codespace on [branch]"
+
+The devcontainer will automatically build and start.
+
+### VS Code with Docker
+
+1. Install [Docker](https://www.docker.com/products/docker-desktop)
+2. Install the [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extension
+3. Open the repository in VS Code
+4. When prompted, click "Reopen in Container" (or run "Dev Containers: Reopen in Container" from the command palette)
+
+The container will build the first time (this may take 10-15 minutes), but subsequent starts will be much faster.
+
+## Building the Container Manually
+
+If you want to build the container image manually:
+
+```bash
+cd .devcontainer
+docker build -t litebox-dev .
+```
+
+## Customization
+
+To customize the devcontainer:
+
+- **Dockerfile**: Modify system packages, Rust components, or add new tools
+- **devcontainer.json**: Adjust VS Code settings, extensions, or environment variables
+
+## Caching
+
+The devcontainer uses Docker volume mounts to cache:
+- Cargo registry (`litebox-cargo-registry` volume)
+- Cargo git repositories (`litebox-cargo-git` volume)
+
+This means dependencies persist across container rebuilds, making subsequent builds faster.
+
+## Troubleshooting
+
+**Container build fails:**
+- Ensure Docker has enough disk space (at least 10GB free)
+- Try building with `docker build --no-cache` to force a clean build
+
+**Slow first build:**
+- The first build downloads and compiles all dependencies, which can take 10-15 minutes
+- Subsequent builds will be much faster due to Docker layer caching
+
+**VS Code can't connect to container:**
+- Check that Docker is running
+- Try rebuilding the container: "Dev Containers: Rebuild Container"
+
+## MCP Servers
+
+### What are MCP Servers?
+
+Model Context Protocol (MCP) servers enable AI assistants like GitHub Copilot to interact with external systems and tools. They provide a standardized way for AI models to access GitHub repositories, file systems, and other resources.
+
+### Pre-installed Servers
+
+**GitHub MCP Server** (`github-mcp-server`)
+- **Purpose**: Provides comprehensive GitHub API access for AI assistants
+- **Capabilities**:
+  - Repository management (clone, create, list repositories)
+  - Issue and pull request operations (create, update, search, manage)
+  - Code search and analysis across repositories
+  - Workflow automation (commits, branches, merges)
+  - GitHub-specific queries and metadata access
+- **Usage**: Automatically available to GitHub Copilot and other MCP-compatible AI assistants
+- **Documentation**: [github-mcp-server on npm](https://www.npmjs.com/package/github-mcp-server)
+
+### Verifying MCP Server Installation
+
+To verify MCP servers are installed correctly in the devcontainer:
+
+```bash
+# Check Node.js and npm versions
+node --version
+npm --version
+
+# Check GitHub MCP server installation
+which github-mcp-server
+github-mcp-server --version
+
+# List globally installed npm packages
+npm list -g --depth=0
+```
+
+### Using MCP Servers with GitHub Copilot
+
+When using this devcontainer with GitHub Copilot:
+
+1. The MCP servers are automatically available to GitHub Copilot Workspace
+2. You can interact with GitHub repositories through natural language
+3. Copilot can perform actions like:
+   - Searching code across the repository
+   - Creating and managing issues and pull requests
+   - Analyzing repository structure and dependencies
+   - Automating common Git workflows
+
+### Adding More MCP Servers
+
+If you need additional MCP servers, you can:
+
+1. **Temporarily** (for current container session):
+   ```bash
+   npm install -g <mcp-server-package>
+   ```
+
+2. **Permanently** (add to Dockerfile):
+   - Edit `.devcontainer/Dockerfile`
+   - Add installation line: `RUN npm install -g <mcp-server-package>`
+   - Rebuild the container

.devcontainer/devcontainer.json

@@ -0,0 +1,60 @@
+{
+	"name": "LiteBox Development",
+	"build": {
+		"dockerfile": "Dockerfile",
+		"context": ".."
+	},
+
+	// Configure VS Code settings
+	"customizations": {
+		"vscode": {
+			// Extensions to install
+			"extensions": [
+				"rust-lang.rust-analyzer",
+				"vadimcn.vscode-lldb",
+				"tamasfe.even-better-toml"
+			],
+
+			// VS Code settings
+			"settings": {
+				"rust-analyzer.cargo.features": "all",
+				"rust-analyzer.checkOnSave": true,
+				"rust-analyzer.check.command": "clippy",
+				"rust-analyzer.check.allTargets": true,
+				"rust-analyzer.procMacro.enable": true,
+				"editor.formatOnSave": true,
+				"[rust]": {
+					"editor.defaultFormatter": "rust-lang.rust-analyzer",
+					"editor.formatOnSave": true
+				},
+				"files.watcherExclude": {
+					"**/target/**": true
+				}
+			}
+		}
+	},
+
+	// Mount the cargo registry and git cache for faster builds
+	"mounts": [
+		"source=litebox-cargo-registry,target=/usr/local/cargo/registry,type=volume",
+		"source=litebox-cargo-git,target=/usr/local/cargo/git,type=volume"
+	],
+
+	// Set environment variables
+	"remoteEnv": {
+		"RUST_BACKTRACE": "1",
+		"NODE_ENV": "development"
+	},
+
+	// Post-create command to set up the environment and verify installations
+	"postCreateCommand": "rustc --version && cargo --version && cargo nextest --version && node --version && npm --version",
+
+	// Features to add (optional)
+	"features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally
+	"forwardPorts": [],
+
+	// Use 'postStartCommand' to run commands after the container is started
+	"postStartCommand": ""
+}