feat(wren): CLI 0.2.0 — context management, profiles, strict mode & memory

.claude/CLAUDE.md

@@ -14,10 +14,10 @@ Five main modules:
 - **wren-core-base/** — Shared Rust crate with manifest types (`Model`, `Column`, `Metric`, `Relationship`, `View`). Has optional `python-binding` feature for PyO3 compatibility.
 - **wren-core-py/** — PyO3 bindings exposing wren-core to Python. Built with Maturin. Published to PyPI.
 - **ibis-server/** — FastAPI web server (Python 3.11). Provides REST API for query execution, validation, and metadata. Uses Ibis framework for data source connectivity.
-- **wren/** — Standalone Python SDK and CLI (`wren-engine` on PyPI). Wraps `wren-core-py` + Ibis connectors into a single installable package with `wren` CLI tool. Includes optional LanceDB-backed memory layer for semantic schema/query retrieval.
+- **wren/** — Python SDK and CLI (`wren-engine` on PyPI). Wraps `wren-core-py` + Ibis connectors into a single installable package with `wren` CLI tool. Features YAML-based MDL project management (`wren context`), named connection profiles (`wren profile`), strict SQL policy mode, and optional LanceDB-backed memory layer for semantic schema/query retrieval.
 - **mcp-server/** — MCP server exposing Wren Engine to AI agents (Claude, Cline, Cursor).
 
-Supporting modules: `wren-core-legacy/` (Java engine, fallback for v2 queries), `cli-skills/` (agent skill definitions), `mock-web-server/`, `benchmark/`, `example/`.
+Supporting modules: `wren-core-legacy/` (Java engine, fallback for v2 queries), `skills/` (CLI-based agent skills: `wren-generate-mdl`, `wren-usage`), `skills-archive/` (legacy HTTP-based skills), `mock-web-server/`, `benchmark/`, `example/`.
 
 ## Build & Development Commands
 

.github/workflows/wren-ci.yml

@@ -122,3 +122,86 @@ jobs:
           uv sync --extra ${{ matrix.extra }} --extra dev --find-links ../wren-core-py/target/wheels/
       - name: Run ${{ matrix.datasource }} tests
         run: uv run pytest ${{ matrix.test_file }} -v -m ${{ matrix.marker }}
+
+  test-ui:
+    name: ui tests
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: wren
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+      - name: Cache Cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            ./wren-core-py/target/
+          key: ${{ runner.os }}-cargo-wren-${{ hashFiles('**/Cargo.lock') }}
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+      - name: Build wren-core-py wheel
+        working-directory: wren-core-py
+        run: |
+          pipx install poetry
+          poetry install --no-root
+          poetry run maturin build
+      - name: Install dependencies
+        run: |
+          uv lock --find-links ../wren-core-py/target/wheels/ --upgrade-package wren-core-py
+          uv sync --extra dev --extra ui --find-links ../wren-core-py/target/wheels/
+      - name: Run UI tests
+        run: uv run pytest tests/test_profile_web.py tests/test_field_registry.py -v
+
+  test-memory:
+    name: memory tests
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: wren
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+      - name: Cache Cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            ./wren-core-py/target/
+          key: ${{ runner.os }}-cargo-wren-${{ hashFiles('**/Cargo.lock') }}
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+      - name: Build wren-core-py wheel
+        working-directory: wren-core-py
+        run: |
+          pipx install poetry
+          poetry install --no-root
+          poetry run maturin build
+      - name: Install dependencies
+        run: |
+          uv lock --find-links ../wren-core-py/target/wheels/ --upgrade-package wren-core-py
+          uv sync --extra dev --extra memory --find-links ../wren-core-py/target/wheels/
+      - name: Cache sentence-transformers model
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/huggingface
+          key: hf-paraphrase-MiniLM-L3-v2
+      - name: Run memory tests
+        env:
+          WREN_EMBEDDING_MODEL: paraphrase-MiniLM-L3-v2
+        run: uv run pytest tests/unit/test_memory.py -v

docs/README.md

@@ -0,0 +1,17 @@
+# Wren Engine Documentation
+
+Wren Engine is an open-source semantic engine for AI agents and MCP clients. It translates SQL queries through MDL (Model Definition Language) and executes them against 22+ data sources.
+
+## Getting Started
+
+- [Quick Start](quickstart.md) -- Set up a local semantic layer with the jaffle_shop dataset using the Wren CLI and Claude Code. (~15 minutes)
+
+## Core Concepts
+
+- [Wren Project](wren_project.md) -- Project structure, YAML authoring, and how the CLI compiles models into a deployable manifest.
+
+### MDL Reference
+
+- [Model](mdl/model.md) -- Define semantic entities over physical tables or SQL expressions.
+- [Relationship](mdl/relationship.md) -- Declare join paths between models for automatic resolution.
+- [View](mdl/view.md) -- Named SQL queries that behave as virtual tables.