Merge branch 'main' of https://github.com/open-edge-platform/scenescape into feature/vision-pipeline-api-design-doc

Author: rawatts10

.github/resources/.prettierignore

@@ -4,3 +4,4 @@
 # Most yaml files are go templates, so they're parsed incorrectly
 **/kubernetes/**/*.yaml
 **/.reuse/templates/template.jinja2
+.venv

.github/resources/actionlint.yaml

@@ -4,7 +4,7 @@
 
 self-hosted-runner:
   # Labels of self-hosted runner in array of strings.
-  labels: [xeon, nuc]
+  labels: [all, bat]
 
 # Configuration variables in array of strings defined in your repository or
 # organization. `null` means disabling configuration variables check.

.github/workflows/docs-build.yml

@@ -47,7 +47,7 @@ jobs:
       DOC_AWS_ACCESS_KEY_ID: ${{ secrets.DOC_AWS_ACCESS_KEY_ID }}
       DOC_AWS_SECRET_ACCESS_KEY: ${{ secrets.DOC_AWS_SECRET_ACCESS_KEY }}
     with:
-      exclude_patterns: "README.md, adr, design"
+      exclude_patterns: "README.md, adr, design, development"
   build_autocalibration:
     name: "Build Autocalibration Documentation"
     needs: filter

.github/workflows/tests-all.yml

@@ -45,7 +45,7 @@ permissions:
 jobs:
   run-all-tests:
     name: "Run All Tests"
-    runs-on: [self-hosted]
+    runs-on: [all]
     timeout-minutes: ${{ fromJSON(inputs.timeout || '90') }}
     steps:
       - name: "Remove all Docker images"

.github/workflows/tests-bat.yml

@@ -116,7 +116,7 @@ jobs:
 
   run-basic-acceptance-tests:
     name: "Run Basic Acceptance Tests"
-    runs-on: [self-hosted]
+    runs-on: [bat]
     timeout-minutes: ${{ fromJSON(inputs.timeout || '60') }}
     needs: [filter, check-pr-state]
     if: ${{ needs.filter.outputs.code_changed == 'true' && (needs.check-pr-state.outputs.pr_state != 'true' || github.event_name == 'workflow_dispatch') }}

.gitignore

@@ -46,3 +46,4 @@ coverity_tool.tgz
 *.ts
 *.pem
 kubernetes/scenescape-chart/files/*
+.venv

controller/Dockerfile

@@ -35,13 +35,12 @@ RUN : \
     && rm -rf /var/lib/apt/lists/*
 
 # install common dependencies
-COPY ./scene_common /tmp/scene_common
+COPY ./scene_common/src /tmp/scene_common
 RUN : \
     && cd /tmp/scene_common \
-    && mv src scene_common \
     && pip3 install --break-system-packages --no-cache-dir pybind11==3.0.0 \
     && pip3 install --break-system-packages --no-cache-dir . \
-    && make -C scene_common/fast_geometry -j $(nproc) all install \
+    && make -C fast_geometry -j $(nproc) all install \
     && cd .. \
     && rm -rf scene_common
 

docs/development/vscode-setup.md

@@ -0,0 +1,126 @@
+# VS Code Setup for SceneScape
+
+This guide configures Visual Studio Code for optimal SceneScape development with cross-module navigation and IntelliSense.
+
+## Prerequisites
+
+- Ubuntu 24.04 LTS
+- Python 3.12
+- Git
+- Visual Studio Code
+
+### Initial Setup
+
+Before configuring VS Code, set up the project environment:
+
+1. **Clone the repository**
+
+   ```bash
+   git clone https://github.com/open-edge-platform/scenescape.git
+   cd scenescape
+   ```
+
+2. **Create and activate virtual environment**
+
+   ```bash
+   python3.12 -m venv .venv
+   source .venv/bin/activate
+   ```
+
+3. **Install Python dependencies**
+
+   ```bash
+   pip install --upgrade pip
+   pip install -r controller/requirements-runtime.txt
+   pip install -r manager/requirements-runtime.txt
+   pip install -r autocalibration/requirements-runtime.txt
+   pip install -r model_installer/requirements-runtime.txt
+
+   # Optional: Install test requirements
+   pip install -r manager/test/requirements-test.txt
+   ```
+
+4. **Build project components**
+   ```bash
+   make
+   ```
+
+## Quick Setup
+
+Assuming you have the SceneScape project cloned and Python environment ready:
+
+1. Open VS Code
+2. Use **File → Open Folder** and select the `scenescape` directory
+3. VS Code will load the workspace with the project structure
+
+## Required Extensions
+
+Install these essential VS Code extensions for Python development:
+
+### Python Extension Pack
+
+- **[Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python)** (Microsoft)
+  - Core Python language support
+  - Debugging, linting, and code formatting
+  - Extension ID: `ms-python.python`
+
+- **[Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance)** (Microsoft)
+  - Fast Python language server
+  - Type checking and IntelliSense
+  - Auto-imports and code navigation
+  - Extension ID: `ms-python.vscode-pylance`
+
+### Installation Steps
+
+1. Open Extensions view (`Ctrl+Shift+X`)
+2. Search for "Python" and install the **Microsoft** Python extension
+3. Search for "Pylance" and install the **Microsoft** Pylance extension
+
+> **Tip:** You can also copy and paste the extension IDs directly into the search box:
+>
+> - `ms-python.python`
+> - `ms-python.vscode-pylance`
+
+## Workspace Configuration
+
+Create `.vscode/settings.json` in the project root, or press `Ctrl+Shift+P` → "Preferences: Open Workspace Settings (JSON)"
+
+```json
+{
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+  "python.terminal.activateEnvironment": true,
+  "python.analysis.extraPaths": [
+    "${workspaceFolder}",
+    "${workspaceFolder}/manager/src/django",
+    "${workspaceFolder}/tests",
+    "${workspaceFolder}/scene_common/src",
+    "${workspaceFolder}/controller/src",
+    "${workspaceFolder}/autocalibration/src",
+    "${workspaceFolder}/manager/src"
+  ],
+  "python.analysis.autoImportCompletions": true,
+  "python.analysis.autoSearchPaths": true
+}
+```
+
+## What This Configuration Enables
+
+- **Automatic Python Environment**: Uses `.venv/bin/python` automatically
+- **Cross-Module Navigation**: Jump between modules with F12 (Go to Definition)
+- **IntelliSense**: Auto-completion across all project components
+- **Import Resolution**: Finds imports in `scene_common`, `controller`, `manager`, `autocalibration`, and `tests`
+
+## Verify Setup
+
+1. Open any Python file in `scene_common/src/` or `controller/src/`
+2. Check that VS Code status bar shows Python interpreter from `.venv`
+3. Verify that imports and IntelliSense work across modules
+4. Test cross-module navigation:
+   - Right-click on any import from `scene_common` → "Go to Definition" (F12)
+   - Use "Find All References" (Shift+F12) on functions/classes
+   - Verify autocomplete works for imports from other modules
+
+## Troubleshooting
+
+- If Python interpreter is not detected, press `Ctrl+Shift+P` → "Python: Select Interpreter" → Choose `.venv/bin/python`
+- If imports are not resolved, restart VS Code or reload the window (`Ctrl+Shift+P` → "Developer: Reload Window")

scene_common/Dockerfile

@@ -32,13 +32,12 @@ RUN : \
     && rm -rf /var/lib/apt/lists/*
 
 # install common dependencies
-COPY ./scene_common /tmp/scene_common
+COPY ./scene_common/src /tmp/scene_common
 RUN : \
     && cd /tmp/scene_common \
-    && mv src scene_common \
     && pip3 install --no-cache-dir pybind11 \
     && pip3 install --no-cache-dir . \
-    && make -C scene_common/fast_geometry -j $(nproc) all install \
+    && make -C fast_geometry -j $(nproc) all install \
     && cd .. \
     && rm -rf scene_common