update docs

Author: fraware

.dockerignore

@@ -1,81 +1,33 @@
-# Git
 .git
+.github
 .gitignore
+.gitattributes
 
-# Python
+.venv
+venv
 __pycache__
-*.pyc
-*.pyo
-*.pyd
-.Python
-env
-pip-log.txt
-pip-delete-this-directory.txt
-.tox
+*.py[cod]
+.pytest_cache
+.mypy_cache
+.ruff_cache
+htmlcov
 .coverage
-.coverage.*
-.cache
-nosetests.xml
 coverage.xml
-*.cover
-*.log
-.git
-.mypy_cache
-.pytest_cache
-.hypothesis
+*.egg-info
 
-# Virtual environments
-_venv
-venv
-ENV
-env
-.venv
+**/node_modules
+examples/react_dashboard/dist
 
-# IDE
 .vscode
 .idea
 *.swp
-*.swo
-*~
-
-# OS
 .DS_Store
-.DS_Store?
-._*
-.Spotlight-V100
-.Trashes
-ehthumbs.db
-Thumbs.db
-
-# Build artifacts
-build/
-dist/
-*.egg-info/
-*.egg
 
-# Documentation
-docs/
-*.md
-!README.md
+maps
+tours
+traces
+dist
+build
 
-# Tests
-tests/
-test_*
-*_test.py
-
-# CI/CD
-.github/
-.gitlab-ci.yml
-.travis.yml
-.circleci/
-
-# Temporary files
-*.tmp
-*.temp
-out.txt
-
-# Local development
-maps/
-tours/
-contracts/
-traces/
+tests
+.hypothesis

.github/actions/setup-uf-python/action.yml

@@ -0,0 +1,20 @@
+name: Setup Understand-First (uv)
+description: Install Python and sync dependencies from uv.lock (dev + examples extras).
+inputs:
+  python-version:
+    description: Python version for setup-python
+    required: true
+runs:
+  using: composite
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+    - name: Sync environment
+      shell: bash
+      run: uv sync --all-extras --frozen

.github/dependabot.yml

@@ -0,0 +1,25 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      python-minor:
+        patterns:
+          - "*"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "npm"
+    directory: "/examples/react_dashboard"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "npm"
+    directory: "/ide/vscode/understand-first"
+    schedule:
+      interval: "weekly"