feat: consolidate GDS ecosystem into uv workspace monorepo

Migrate gds-framework, gds-viz, gds-games, and gds-examples from
separate repos into a single monorepo with:

- uv workspace resolution across all 4 packages
- Shared ruff config (line-length 88, reformatted from 100)
- Unified MkDocs Material docs site
- GitHub Actions CI (matrix test), publish (tag-based OIDC),
  and docs (GitHub Pages) workflows
- 745 tests passing across all packages

Author: rororowyourboat

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv sync
+      - run: uv run ruff check packages/
+      - run: uv run ruff format --check packages/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        package:
+          - gds-framework
+          - gds-viz
+          - gds-games
+          - gds-examples
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv sync --package ${{ matrix.package }}
+      - name: Run tests
+        run: |
+          if [ "${{ matrix.package }}" = "gds-examples" ]; then
+            uv run --package ${{ matrix.package }} pytest packages/gds-examples -v
+          else
+            uv run --package ${{ matrix.package }} pytest packages/${{ matrix.package }}/tests -v
+          fi

.github/workflows/docs.yml

@@ -0,0 +1,40 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "packages/*/gds*/**"
+      - "packages/*/ogs/**"
+
+permissions:
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv sync --all-packages --group docs
+      - run: uv run mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "*/v*"
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+
+      - name: Parse package name from tag
+        id: parse
+        run: |
+          TAG="${GITHUB_REF#refs/tags/}"
+          PACKAGE="${TAG%%/v*}"
+          VERSION="${TAG#*/v}"
+          echo "package=$PACKAGE" >> "$GITHUB_OUTPUT"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Publishing $PACKAGE v$VERSION"
+
+      - run: uv build --package ${{ steps.parse.outputs.package }}
+      - run: uv publish

.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# uv
+uv.lock
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.coverage
+.pytest_cache/
+htmlcov/
+.mypy_cache/
+
+# MkDocs
+site/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Ruff
+.ruff_cache/
+
+# Pyright
+.pyright/

.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

CLAUDE.md

@@ -0,0 +1,67 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code when working in this monorepo.
+
+## Project
+
+`gds-core` — monorepo for the Generalized Dynamical Systems ecosystem. Contains four packages managed as a uv workspace.
+
+## Packages
+
+| Package | Import | Location |
+|---------|--------|----------|
+| gds-framework | `gds` | `packages/gds-framework/` |
+| gds-viz | `gds_viz` | `packages/gds-viz/` |
+| gds-games | `ogs` | `packages/gds-games/` |
+| gds-examples | — | `packages/gds-examples/` |
+
+## Commands
+
+```bash
+# Install all packages (workspace-linked)
+uv sync --all-packages
+
+# Run tests per-package
+uv run --package gds-framework pytest packages/gds-framework/tests -v
+uv run --package gds-viz pytest packages/gds-viz/tests -v
+uv run --package gds-games pytest packages/gds-games/tests -v
+uv run --package gds-examples pytest packages/gds-examples -v
+
+# Run all tests
+uv run --package gds-framework pytest packages/gds-framework/tests packages/gds-viz/tests packages/gds-games/tests packages/gds-examples -v
+
+# Lint & format
+uv run ruff check packages/
+uv run ruff format --check packages/
+
+# Build a specific package
+uv build --package gds-framework
+
+# Docs
+uv sync --all-packages --group docs
+uv run mkdocs build --strict
+uv run mkdocs serve
+```
+
+## Architecture
+
+This is a **uv workspace** monorepo. The root `pyproject.toml` declares `packages/*` as workspace members. Each package has its own `pyproject.toml` with package-specific dependencies and build config. Shared tooling (ruff, docs) is configured at the root.
+
+### Dependency Graph
+
+```
+gds-framework  ←  core engine (no GDS dependencies)
+    ↑
+gds-viz        ←  visualization (depends on gds-framework)
+gds-games      ←  game theory DSL (depends on gds-framework)
+    ↑
+gds-examples   ←  tutorials (depends on gds-framework + gds-viz)
+```
+
+### Key Conventions
+
+- All data models are Pydantic v2 BaseModel
+- Absolute imports only (never relative)
+- Ruff config inherited from root (line-length 88)
+- Each package published independently to PyPI via tag-based workflow (`gds-framework/v0.3.1`)
+- Per-package CLAUDE.md files contain package-specific architecture details