container-superposition 0.1.1

package/overlays/redpanda/devcontainer.patch.json

@@ -0,0 +1,37 @@
+{
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
+    "features": {
+        "./features/cross-distro-packages": {
+            "apt": "curl",
+            "apk": "curl"
+        }
+    },
+    "runServices": ["redpanda", "redpanda-console"],
+    "forwardPorts": [9092, 8080, 8081, 8082, 9644],
+    "portsAttributes": {
+        "9092": {
+            "label": "Redpanda Kafka API",
+            "onAutoForward": "notify"
+        },
+        "8080": {
+            "label": "Redpanda Console",
+            "onAutoForward": "openBrowser"
+        },
+        "8081": {
+            "label": "Schema Registry",
+            "onAutoForward": "notify"
+        },
+        "8082": {
+            "label": "HTTP Proxy",
+            "onAutoForward": "notify"
+        },
+        "9644": {
+            "label": "Admin API",
+            "onAutoForward": "notify"
+        }
+    },
+    "remoteEnv": {
+        "REDPANDA_BROKERS": "redpanda:9092",
+        "KAFKA_BROKERS": "redpanda:9092"
+    }
+}

package/overlays/redpanda/docker-compose.yml

@@ -0,0 +1,67 @@
+version: '3.8'
+
+services:
+    redpanda:
+        image: docker.redpanda.com/redpandadata/redpanda:${REDPANDA_VERSION:-latest}
+        restart: unless-stopped
+        command:
+            - redpanda
+            - start
+            - --kafka-addr internal://0.0.0.0:9092,external://0.0.0.0:19092
+            - --advertise-kafka-addr internal://redpanda:9092,external://localhost:19092
+            - --pandaproxy-addr internal://0.0.0.0:8082,external://0.0.0.0:18082
+            - --advertise-pandaproxy-addr internal://redpanda:8082,external://localhost:18082
+            - --schema-registry-addr internal://0.0.0.0:8081,external://0.0.0.0:18081
+            - --rpc-addr redpanda:33145
+            - --advertise-rpc-addr redpanda:33145
+            - --mode dev-container
+            - --smp 1
+            - --memory 1G
+        volumes:
+            - redpanda-data:/var/lib/redpanda/data
+        ports:
+            - '${REDPANDA_KAFKA_PORT:-9092}:9092'
+            - '${REDPANDA_SCHEMA_REGISTRY_PORT:-8081}:8081'
+            - '${REDPANDA_PROXY_PORT:-8082}:8082'
+            - '${REDPANDA_ADMIN_PORT:-9644}:9644'
+        networks:
+            - devnet
+        healthcheck:
+            test: ['CMD-SHELL', "rpk cluster health | grep -q 'Healthy:.*true'"]
+            interval: 10s
+            timeout: 5s
+            retries: 5
+            start_period: 30s
+
+    redpanda-console:
+        image: docker.redpanda.com/redpandadata/console:${REDPANDA_CONSOLE_VERSION:-latest}
+        restart: unless-stopped
+        entrypoint: /bin/sh
+        command: -c "echo \"$$CONSOLE_CONFIG_FILE\" > /tmp/config.yml; /app/console"
+        environment:
+            CONFIG_FILEPATH: /tmp/config.yml
+            CONSOLE_CONFIG_FILE: |
+                kafka:
+                  brokers: ["redpanda:9092"]
+                  schemaRegistry:
+                    enabled: true
+                    urls: ["http://redpanda:8081"]
+                redpanda:
+                  adminApi:
+                    enabled: true
+                    urls: ["http://redpanda:9644"]
+                connect:
+                  enabled: false
+        ports:
+            - '${REDPANDA_CONSOLE_PORT:-8080}:8080'
+        networks:
+            - devnet
+        depends_on:
+            redpanda:
+                condition: service_healthy
+
+volumes:
+    redpanda-data:
+
+networks:
+    devnet:

package/overlays/redpanda/overlay.yml

@@ -0,0 +1,21 @@
+id: redpanda
+name: Redpanda
+description: Kafka-compatible event streaming with web console
+category: database
+supports:
+    - compose
+requires: []
+suggests: []
+conflicts: []
+tags:
+    - database
+    - messaging
+    - streaming
+    - kafka
+    - redpanda
+ports:
+    - 9092
+    - 8080
+    - 8081
+    - 8082
+    - 9644

package/overlays/redpanda/verify.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# Verification script for Redpanda overlay
+# Confirms Redpanda is installed and accessible
+
+set -e
+
+echo "🔍 Verifying Redpanda overlay..."
+echo ""
+
+# Check if Redpanda service is running
+echo "1️⃣ Checking Redpanda service..."
+# Wait up to 30 seconds for Redpanda to be ready
+REDPANDA_READY=false
+for i in {1..30}; do
+    if curl -s http://redpanda:9644/v1/cluster/health_overview &> /dev/null; then
+        echo "   ✅ Redpanda service is ready"
+        REDPANDA_READY=true
+        break
+    fi
+    sleep 1
+done
+
+if [ "$REDPANDA_READY" = false ]; then
+    echo "   ❌ Redpanda service not ready after 30 seconds"
+    exit 1
+fi
+
+# Check Redpanda Console
+echo ""
+echo "2️⃣ Checking Redpanda Console..."
+CONSOLE_READY=false
+for i in {1..30}; do
+    if curl -s http://redpanda-console:8080 &> /dev/null; then
+        echo "   ✅ Redpanda Console is accessible"
+        CONSOLE_READY=true
+        break
+    fi
+    sleep 1
+done
+
+if [ "$CONSOLE_READY" = false ]; then
+    echo "   ⚠️  Redpanda Console not ready (may still be starting)"
+fi
+
+echo ""
+echo "✅ Redpanda overlay verification complete"
+echo "   Kafka API: redpanda:9092"
+echo "   Console UI: http://localhost:8080"

package/overlays/rust/README.md

@@ -0,0 +1,299 @@
+# Rust Overlay
+
+Adds Rust stable toolchain with cargo, rustfmt, clippy, and rust-analyzer for systems programming and high-performance applications.
+
+## Features
+
+- **Rust** - Latest stable version with rustup
+- **cargo** - Rust package manager and build tool
+- **rustfmt** - Official Rust code formatter
+- **clippy** - Rust linter for catching common mistakes
+- **rust-analyzer** - Language server for IDE features
+- **VS Code Extensions:**
+    - rust-analyzer (rust-lang.rust-analyzer) - IntelliSense and code actions
+    - CodeLLDB (vadimcn.vscode-lldb) - Native debugger
+- **Automatic dependency fetching** - Runs `cargo fetch` on container creation
+
+## How It Works
+
+This overlay uses the official devcontainers Rust feature to install Rust via rustup. The setup script installs essential Rust components (rustfmt, clippy, rust-src) and useful cargo extensions (cargo-watch, cargo-edit).
+
+**Installation method:**
+
+- Rust toolchain via rustup
+- Components and tools via `rustup component add` and `cargo install`
+- Tools accessible in ~/.cargo/bin
+
+## Common Commands
+
+### Project Initialization
+
+```bash
+# Create new binary project
+cargo new myapp
+
+# Create new library
+cargo new --lib mylib
+
+# Initialize in existing directory
+cargo init
+```
+
+### Building and Running
+
+```bash
+# Build project
+cargo build
+
+# Build with optimizations (release mode)
+cargo build --release
+
+# Run application
+cargo run
+
+# Run with arguments
+cargo run -- arg1 arg2
+
+# Check code without building
+cargo check
+```
+
+### Testing
+
+```bash
+# Run all tests
+cargo test
+
+# Run specific test
+cargo test test_name
+
+# Run tests with output
+cargo test -- --nocapture
+
+# Run benchmarks
+cargo bench
+
+# Run with coverage (requires tarpaulin)
+cargo install cargo-tarpaulin
+cargo tarpaulin
+```
+
+### Code Quality
+
+```bash
+# Format code
+cargo fmt
+
+# Check formatting without changes
+cargo fmt -- --check
+
+# Lint with clippy
+cargo clippy
+
+# Clippy with all warnings
+cargo clippy -- -W clippy::all
+
+# Fix automatically fixable issues
+cargo clippy --fix
+```
+
+### Dependency Management
+
+```bash
+# Add dependency (requires cargo-edit)
+cargo add tokio
+
+# Add dev dependency
+cargo add --dev serde
+
+# Remove dependency
+cargo rm tokio
+
+# Update dependencies
+cargo update
+
+# List dependencies
+cargo tree
+```
+
+### Watch Mode
+
+```bash
+# Auto-rebuild on file changes (requires cargo-watch)
+cargo watch -x run
+
+# Run tests on changes
+cargo watch -x test
+
+# Run clippy on changes
+cargo watch -x clippy
+```
+
+## Use Cases
+
+- **Systems programming** - Operating systems, device drivers, embedded systems
+- **WebAssembly** - High-performance web applications (wasm-pack)
+- **CLI tools** - Fast command-line utilities (clap, structopt)
+- **Web servers** - High-performance APIs (Actix, Axum, Rocket)
+- **Game engines** - Game development (Bevy, Amethyst)
+- **Blockchain** - Cryptocurrency and smart contracts (Substrate, Solana)
+
+**Integrates well with:**
+
+- `postgres`, `redis` - Database drivers (sqlx, deadpool)
+- `docker-sock` - Bollard (Docker SDK for Rust)
+- `prometheus` - Prometheus Rust client
+- `otel-collector` - OpenTelemetry Rust SDK
+
+## Configuration
+
+### Rust Version
+
+The overlay installs **latest stable** Rust. To use nightly:
+
+```bash
+# Switch to nightly
+rustup default nightly
+
+# Or use nightly for specific project
+rustup override set nightly
+```
+
+### Cargo Configuration
+
+Create `.cargo/config.toml` in project root:
+
+```toml
+[build]
+# Use all CPU cores
+jobs = 8
+
+[target.x86_64-unknown-linux-gnu]
+# Use lld linker for faster builds
+rustflags = ["-C", "link-arg=-fuse-ld=lld"]
+
+[alias]
+# Custom aliases
+b = "build"
+r = "run"
+t = "test"
+```
+
+## Application Integration
+
+### Web Server with Axum
+
+**Cargo.toml:**
+
+```toml
+[dependencies]
+axum = "0.7"
+tokio = { version = "1", features = ["full"] }
+```
+
+**main.rs:**
+
+```rust
+use axum::{routing::get, Router};
+
+#[tokio::main]
+async fn main() {
+    let app = Router::new()
+        .route("/", get(|| async { "Hello from Rust!" }));
+
+    let listener = tokio::net::TcpListener::bind("0.0.0.0:8080")
+        .await
+        .unwrap();
+
+    axum::serve(listener, app).await.unwrap();
+}
+```
+
+**Run:**
+
+```bash
+cargo run
+# Access at http://localhost:8080
+```
+
+### PostgreSQL with sqlx
+
+```rust
+use sqlx::postgres::PgPoolOptions;
+
+#[tokio::main]
+async fn main() -> Result<(), sqlx::Error> {
+    let pool = PgPoolOptions::new()
+        .max_connections(5)
+        .connect("postgres://postgres:postgres@postgres/mydb")
+        .await?;
+
+    let row: (i64,) = sqlx::query_as("SELECT COUNT(*) FROM users")
+        .fetch_one(&pool)
+        .await?;
+
+    println!("User count: {}", row.0);
+    Ok(())
+}
+```
+
+## Troubleshooting
+
+### Issue: rust-analyzer not working
+
+**Symptoms:**
+
+- No IntelliSense
+- "rust-analyzer failed to load workspace" error
+
+**Solution:**
+
+```bash
+# Install rust-src component
+rustup component add rust-src
+
+# Reload VS Code window
+# Command Palette -> "Developer: Reload Window"
+```
+
+### Issue: Slow compilation times
+
+**Solution:**
+
+```bash
+# Use sccache for caching
+cargo install sccache
+export RUSTC_WRAPPER=sccache
+
+# Use lld linker (faster)
+sudo apt-get install lld
+# Add to .cargo/config.toml (see Configuration section)
+```
+
+### Issue: Cargo.lock conflicts
+
+**Solution:**
+
+```bash
+# Update Cargo.lock
+cargo update
+
+# Or delete and regenerate
+rm Cargo.lock
+cargo build
+```
+
+## References
+
+- [Official Rust Documentation](https://doc.rust-lang.org/) - The Rust Book and reference
+- [Rust by Example](https://doc.rust-lang.org/rust-by-example/) - Learn by examples
+- [crates.io](https://crates.io/) - Rust package registry
+- [rust-analyzer](https://rust-analyzer.github.io/) - Language server
+- [Clippy Lints](https://rust-lang.github.io/rust-clippy/) - All clippy lints
+
+**Related Overlays:**
+
+- `postgres` - PostgreSQL with sqlx/diesel
+- `redis` - Redis with redis-rs
+- `docker-sock` - Bollard Docker SDK
+- `prometheus` - Prometheus Rust client

package/overlays/rust/devcontainer.patch.json

@@ -0,0 +1,39 @@
+{
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
+    "features": {
+        "./features/cross-distro-packages": {
+            "apt": "build-essential pkg-config libssl-dev",
+            "apk": "build-base pkgconfig openssl-dev"
+        },
+        "ghcr.io/devcontainers/features/rust:1": {
+            "version": "latest",
+            "profile": "default"
+        }
+    },
+    "customizations": {
+        "vscode": {
+            "extensions": ["rust-lang.rust-analyzer", "vadimcn.vscode-lldb"],
+            "settings": {
+                "rust-analyzer.checkOnSave.command": "clippy",
+                "[rust]": {
+                    "editor.formatOnSave": true,
+                    "editor.defaultFormatter": "rust-lang.rust-analyzer"
+                }
+            }
+        }
+    },
+    "remoteEnv": {
+        "PATH": "${containerEnv:HOME}/.cargo/bin:${containerEnv:PATH}"
+    },
+    "forwardPorts": [8080, 3000],
+    "portsAttributes": {
+        "8080": {
+            "label": "Web Server",
+            "onAutoForward": "openBrowser"
+        },
+        "3000": {
+            "label": "Dev Server",
+            "onAutoForward": "notify"
+        }
+    }
+}

package/overlays/rust/overlay.yml

@@ -0,0 +1,15 @@
+id: rust
+name: Rust
+description: Rust stable with cargo, rustfmt, and clippy
+category: language
+supports: []
+requires: []
+suggests: []
+conflicts: []
+tags:
+    - language
+    - rust
+    - cargo
+ports:
+    - 8080
+    - 3000

package/overlays/rust/setup.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+# Rust setup script - Install Rust components and tools
+
+set -e
+
+echo "🔧 Setting up Rust development environment..."
+
+# Install common Rust components and tools
+echo "📦 Installing Rust components..."
+
+# rustfmt (Code formatter)
+rustup component add rustfmt || echo "⚠️ rustfmt already installed"
+
+# clippy (Linter)
+rustup component add clippy || echo "⚠️ clippy already installed"
+
+# rust-src (Source code for standard library)
+rustup component add rust-src || echo "⚠️ rust-src already installed"
+
+# Install common cargo tools
+echo "📦 Installing cargo tools..."
+
+# cargo-watch (Auto-rebuild on file changes)
+cargo install cargo-watch || echo "⚠️ cargo-watch already installed"
+
+# cargo-edit (Manage dependencies from CLI)
+cargo install cargo-edit || echo "⚠️ cargo-edit already installed"
+
+# Install project dependencies if Cargo.toml exists
+if [ -f "Cargo.toml" ]; then
+    echo "📦 Rust project detected, building dependencies..."
+    cargo fetch || echo "⚠️ cargo fetch failed"
+    cargo build || echo "⚠️ cargo build failed or skipped"
+fi
+
+echo "✓ Rust setup complete"

package/overlays/rust/verify.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# Verification script for Rust overlay
+
+set -e
+
+echo "🔍 Verifying Rust overlay..."
+echo ""
+
+# Check Rust is installed
+echo "1️⃣ Checking Rust..."
+if command -v rustc &> /dev/null; then
+    rustc --version
+    echo "   ✅ Rust found"
+else
+    echo "   ❌ Rust not found"
+    exit 1
+fi
+
+# Check Cargo is installed
+echo ""
+echo "2️⃣ Checking Cargo..."
+if command -v cargo &> /dev/null; then
+    cargo --version
+    echo "   ✅ Cargo found"
+else
+    echo "   ❌ Cargo not found"
+    exit 1
+fi
+
+# Check rustfmt
+echo ""
+echo "3️⃣ Checking rustfmt..."
+if command -v rustfmt &> /dev/null; then
+    rustfmt --version
+    echo "   ✅ rustfmt found"
+else
+    echo "   ⚠️ rustfmt not found"
+fi
+
+# Check clippy
+echo ""
+echo "4️⃣ Checking clippy..."
+if command -v cargo-clippy &> /dev/null; then
+    cargo clippy --version
+    echo "   ✅ clippy found"
+else
+    echo "   ⚠️ clippy not found"
+fi
+
+echo ""
+echo "✅ Rust overlay verification complete"