Ci/fix docs pipeline

.devcontainer/Dockerfile

@@ -0,0 +1,6 @@
+FROM mcr.microsoft.com/devcontainers/rust:1-bullseye
+
+# Install OS dependencies here
+RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
+    pkg-config libssl-dev cmake clang curl wget && \
+    apt-get clean && rm -rf /var/lib/apt/lists/*

.devcontainer/devcontainer.json

@@ -0,0 +1,52 @@
+{
+    "name": "rust-mdbook-dev",
+    "build": { "dockerfile": "Dockerfile" },
+    "features": {
+      "ghcr.io/devcontainers/features/common-utils:2": {
+        "username": "vscode",
+        "installZsh": false,
+        "upgradePackages": true
+      },
+      "ghcr.io/devcontainers/features/git:1": {}
+    },
+    "customizations": {
+      "vscode": {
+        "extensions": [
+          "rust-lang.rust-analyzer",
+          "serayuzgur.crates",
+          "tamasfe.even-better-toml",
+          "tamago324.marksman",
+          "DavidAnson.vscode-markdownlint",
+          "yzhang.markdown-all-in-one",
+          "ms-azuretools.vscode-docker",
+          "github.vscode-github-actions"
+        ],
+        "settings": {
+          "editor.formatOnSave": true,
+          "rust-analyzer.cargo.features": "all",
+          "rust-analyzer.cargo.buildScripts.enable": true,
+          "rust-analyzer.checkOnSave.command": "clippy",
+          "rust-analyzer.checkOnSave.allTargets": true,
+          "files.trimTrailingWhitespace": true,
+          "markdownlint.config": { "MD013": false }
+        }
+      }
+    },
+    "containerEnv": {
+      "CARGO_TERM_COLOR": "always"
+    },
+    // Cache mounts removed due to Docker compatibility issues
+    // Use named volumes instead for better compatibility
+    "mounts": [
+      "source=cargo-registry,target=/usr/local/cargo/registry,type=volume",
+      "source=cargo-git,target=/usr/local/cargo/git,type=volume",
+      "source=cargo-target,target=/workspaces/${localWorkspaceFolderBasename}/target,type=volume"
+    ],
+    "forwardPorts": [3000],
+    "portsAttributes": {
+      "3000": { "label": "mdBook", "onAutoForward": "notify" }
+    },
+    "postCreateCommand": "bash .devcontainer/postCreate.sh",
+    "postStartCommand": "git config --global --add safe.directory /workspaces/${localWorkspaceFolderBasename}",
+    "remoteUser": "vscode"
+  }

.devcontainer/postCreate.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "Starting post-create setup..."
+
+# Rust components
+echo "Installing Rust components..."
+rustup component add rustfmt clippy
+
+echo "Installing taplo..."
+if ! command -v taplo >/dev/null 2>&1; then
+  ARCH=$(uname -m)
+  case $ARCH in
+    x86_64)
+      TAPLO_ARCH="linux-x86_64"
+      ;;
+    aarch64|arm64)
+      TAPLO_ARCH="linux-aarch64"
+      ;;
+    *)
+      echo "Unsupported architecture: $ARCH. Skipping taplo installation."
+      TAPLO_ARCH=""
+      ;;
+  esac
+
+  if [ -n "$TAPLO_ARCH" ]; then
+    curl -sSfL "https://github.com/tamasfe/taplo/releases/latest/download/taplo-full-${TAPLO_ARCH}.gz" \
+      | gunzip > /usr/local/bin/taplo && chmod +x /usr/local/bin/taplo || true
+  fi
+fi
+
+# Install dev tools from Cargo.toml dev-dependencies
+echo "Installing development tools from Cargo.toml..."
+if command -v make >/dev/null 2>&1; then
+  make install-dev-tools || true
+fi
+
+echo "Post-create setup completed!"

.editorconfig

@@ -0,0 +1,13 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false

.github/CHANGELOG.md

@@ -0,0 +1,83 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-09-XX
+
+### Added
+
+- Initial release of Fugue, a monadic probabilistic programming library for Rust.
+- **Core probabilistic programming framework**:
+  - `Model<A>` abstraction for composable probabilistic programs.
+  - Monadic operations: `bind`, `map`, `and_then`, `pure` for program composition.
+  - `sample`, `observe`, `factor`, `guard` primitives for probabilistic modeling.
+- **Type-safe distribution system** with natural return types:
+  - `Bernoulli` distribution returning `bool` (eliminates `== 1.0` comparisons).
+  - `Poisson` and `Binomial` distributions returning `u64` (natural counting).
+  - `Categorical` distribution returning `usize` (safe array indexing).
+  - Continuous distributions (`Normal`, `Beta`, `Gamma`, etc.) returning `f64`.
+  - 10 built-in distributions with parameter validation and numerical stability.
+- **Ergonomic macros** for probabilistic programming:
+  - `prob!` macro for Haskell-style do-notation.
+  - `plate!` macro for vectorized operations over collections.
+  - `addr!` and `scoped_addr!` macros for hierarchical addressing.
+- **Multiple inference algorithms**:
+  - MCMC: Adaptive Metropolis-Hastings with convergence diagnostics.
+  - SMC: Sequential Monte Carlo with multiple resampling methods.
+  - VI: Mean-field variational inference with ELBO optimization.
+  - ABC: Approximate Bayesian Computation with distance functions.
+- **Effect handler system**:
+  - `Handler` trait for pluggable model interpreters.
+  - 5 built-in handlers: `PriorHandler`, `ReplayHandler`, `ScoreGivenTrace`, `SafeReplayHandler`, `SafeScoreGivenTrace`.
+  - Type-safe execution preserving distribution return types.
+- **Trace system** for execution history:
+  - Complete recording of random choices and log-weights.
+  - Type-safe value access with `get_f64()`, `get_bool()`, `get_u64()`, `get_usize()`.
+  - Three-component log-weight decomposition (prior, likelihood, factors).
+- **Memory optimization**:
+  - Copy-on-write traces (`CowTrace`) for efficient MCMC proposals.
+  - Object pooling (`TracePool`) for zero-allocation inference.
+  - Efficient trace construction (`TraceBuilder`).
+- **Production features**:
+  - Comprehensive error handling with `FugueError` and error codes.
+  - Numerically stable algorithms with overflow protection.
+  - Convergence diagnostics: R-hat, effective sample size, Geweke tests.
+  - Statistical validation against analytical solutions.
+- **Documentation and examples**:
+  - Comprehensive user guide with 20+ tutorial and how-to pages.
+  - Complete API documentation with rustdoc.
+  - 14 examples covering foundation concepts, statistical modeling, and advanced patterns.
+  - 158+ doctests ensuring example correctness.
+- **Testing infrastructure**:
+  - 82+ unit tests across all modules.
+  - 9+ integration tests for end-to-end workflows.
+  - Property-based testing with `proptest`.
+  - Continuous integration with format, lint, and test enforcement.
+
+### Changed
+
+- N/A (initial release)
+
+### Deprecated
+
+- N/A (initial release)
+
+### Removed
+
+- N/A (initial release)
+
+### Fixed
+
+- N/A (initial release)
+
+### Security
+
+- N/A (initial release)
+
+[Unreleased]: https://github.com/alexandernodeland/fugue/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/alexandernodeland/fugue/releases/tag/v0.1.0

.github/CODEOWNERS

@@ -0,0 +1,11 @@
+# Docs reviewers
+/docs/                      @alexnodeland
+/examples/                  @alexnodeland
+# Crate API reviewers
+/src/                       @alexnodeland
+/tests/                     @alexnodeland
+/benches/                   @alexnodeland
+# CI and meta
+/.github/                   @alexnodeland
+/.devcontainer/             @alexnodeland
+/.vscode/                   @alexnodeland