Version: 2.0.0-beta.1

.env.example

@@ -0,0 +1,62 @@
+# ===========================================================================
+# Scalable AI Provider Configuration
+# ===========================================================================
+# These generic environment variables configure which AI/LLM provider and
+# model Scalable uses. They are provider-agnostic — set them once and switch
+# providers by changing AI_PROVIDER and LLM_MODEL_NAME.
+#
+# Supported providers:
+#   openai     — OpenAI (GPT-5.2, GPT-5.5, etc.)
+#   anthropic  — Anthropic (Claude Opus, Sonnet, Haiku)
+#   google     — Google Gemini (2.0 Flash, 1.5 Pro, etc.)
+#   xai        — xAI (Grok-2, Grok-3)
+#   groq       — Groq (Llama, Mixtral — fast inference)
+#   ollama     — Local Ollama models (Llama3, Mistral, etc.)
+# ===========================================================================
+
+# Provider name — determines which AI service to use.
+# Options: openai | anthropic | google | xai | groq | ollama
+AI_PROVIDER=openai
+
+# Universal API key — works for any provider that requires authentication.
+# This single key is used unless a provider-specific key is set (see below).
+AI_API_KEY=your_api_key_here
+
+# LLM model of choice for generation tasks.
+# Examples by provider:
+#   openai:    gpt-4o, gpt-4o-mini, o1, o1-mini
+#   anthropic: claude-opus-4-20250514, claude-sonnet-4-20250514, claude-haiku-3-20250414
+#   google:    gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash
+#   xai:       grok-3, grok-2
+#   groq:      llama-3.1-70b-versatile, mixtral-8x7b-32768
+#   ollama:    llama3, mistral, codellama
+LLM_MODEL_NAME=gpt-5.5
+
+# Optional: Custom API base URL.
+# Required for OpenAI-compatible proxies (e.g., Azure, vLLM, LiteLLM).
+# xAI defaults to https://api.x.ai/v1 automatically.
+# Ollama defaults to http://localhost:11434 automatically.
+# AI_BASE_URL=https://api.openai.com/v1
+
+# ===========================================================================
+# Provider-Specific API Keys (Optional Overrides)
+# ===========================================================================
+# If you use multiple providers, you can set provider-specific keys below.
+# These take priority over AI_API_KEY for their respective provider.
+#
+# OPENAI_API_KEY=sk-...
+# ANTHROPIC_API_KEY=sk-ant-...
+# GOOGLE_API_KEY=AIza...
+# XAI_API_KEY=xai-...
+# GROQ_API_KEY=gsk_...
+
+# ===========================================================================
+# Advanced: SCALABLE_AI_* Overrides
+# ===========================================================================
+# These Scalable-specific variables take priority over the generic ones above.
+# Use them only if you need separate config for Scalable vs. other tools.
+#
+# SCALABLE_AI_BACKEND=openai
+# SCALABLE_AI_MODEL=gpt-4o
+# SCALABLE_AI_ENDPOINT=https://custom-endpoint.example.com/v1
+# SCALABLE_AI_API_KEY=sk-...

.github/workflows/tests.yml

@@ -2,9 +2,9 @@ name: tests
 
 on:
   push:
-    branches: [develop, master, main]
+    branches: [develop, master, main, 'version/**']
   pull_request:
-    branches: [develop, master, main]
+    branches: [develop, master, main, 'version/**']
   workflow_dispatch:
 
 concurrency:
@@ -18,12 +18,17 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest]
-        python-version: ["3.11", "3.12", "3.13"]
+        include:
+          - os: ubuntu-latest
+            python-version: "3.11"
+          - os: ubuntu-latest
+            python-version: "3.12"
+          - os: ubuntu-latest
+            python-version: "3.13"
     steps:
       - uses: actions/checkout@v4
         with:
-          fetch-depth: 0  # versioneer needs tags
+          fetch-depth: 0
 
       - uses: actions/setup-python@v5
         with:
@@ -38,6 +43,32 @@ jobs:
       - name: Run unit tests
         run: pytest tests/unit -v
 
+  validate-example-manifests:
+    name: validate example manifests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .[test]
+
+      - name: Validate docs examples
+        run: |
+          scalable validate docs/examples/scalable.minimal.yaml --target local
+          scalable validate docs/examples/scalable.gcam_stitches.yaml --target local
+
+      - name: Plan docs examples (dry-run)
+        run: |
+          scalable plan docs/examples/scalable.minimal.yaml --target local --dry-run --output /tmp/plan-minimal.json
+          scalable plan docs/examples/scalable.gcam_stitches.yaml --target local --dry-run --output /tmp/plan-gcam-stitches.json
+
   lint:
     name: ruff + mypy
     runs-on: ubuntu-latest

.gitignore

@@ -3,6 +3,12 @@
 # -----------------------------
 capabilities/
 plans/
+.rooignore
+.env
+notebooks/.ipynb_checkpoints/
+notebooks/beginner/.ipynb_checkpoints/
+notebooks/intermediate/.ipynb_checkpoints/
+notebooks/advanced/.ipynb_checkpoints/
 
 # -----------------------------
 # Python bytecode / caches