Added dev environment setup scripts

Author: Mindstormman06

package-lock.json

@@ -0,0 +1,73 @@
+<#
+.SYNOPSIS
+    Set up the dev environment from a fresh clone of totk-vscode.
+.DESCRIPTION
+    1. Initializes git submodules
+    2. Installs Node dependencies (root)
+    3. Creates a Python venv and installs Python dependencies
+.PARAMETER PythonPath
+    Explicit path to a Python 3.10+ interpreter. If omitted, tries py, python3, python.
+#>
+param(
+    [string]$PythonPath
+)
+
+$ErrorActionPreference = 'Stop'
+$root = Split-Path -Parent $PSScriptRoot
+
+Push-Location $root
+try {
+    # ── 1. Git submodules ──────────────────────────────────────────────
+    Write-Host "`n=== Initializing git submodules ===" -ForegroundColor Cyan
+    git submodule update --init --recursive
+    if ($LASTEXITCODE -ne 0) { throw "git submodule update failed" }
+
+    # ── 2. Node dependencies ───────────────────────────────────────────
+    Write-Host "`n=== Installing Node dependencies (root) ===" -ForegroundColor Cyan
+    npm install
+    if ($LASTEXITCODE -ne 0) { throw "npm install failed" }
+
+    # ── 3. Python venv ─────────────────────────────────────────────────
+    Write-Host "`n=== Setting up Python virtual environment ===" -ForegroundColor Cyan
+
+    if ($PythonPath) {
+        $py = $PythonPath
+    } else {
+        $py = $null
+        foreach ($candidate in @('py -3', 'python3', 'python')) {
+            $parts = $candidate -split ' '
+            $exe = $parts[0]
+            $args = if ($parts.Length -gt 1) { $parts[1..($parts.Length-1)] } else { @() }
+            try {
+                $ver = & $exe @args --version 2>&1
+                if ($ver -match 'Python 3\.(\d+)' -and [int]$Matches[1] -ge 10) {
+                    $py = $candidate
+                    Write-Host "  Found: $ver ($candidate)" -ForegroundColor Green
+                    break
+                }
+            } catch {}
+        }
+        if (-not $py) { throw "Python 3.10+ not found. Install it or pass -PythonPath." }
+    }
+
+    $venvDir = Join-Path $root '.venv'
+    if (-not (Test-Path $venvDir)) {
+        Write-Host "  Creating venv at $venvDir"
+        $parts = $py -split ' '
+        $exe = $parts[0]
+        $args = if ($parts.Length -gt 1) { $parts[1..($parts.Length-1)] } else { @() }
+        & $exe @args -m venv $venvDir
+        if ($LASTEXITCODE -ne 0) { throw "venv creation failed" }
+    } else {
+        Write-Host "  venv already exists at $venvDir"
+    }
+
+    $pip = Join-Path $venvDir 'Scripts' 'pip.exe'
+    Write-Host "  Installing Python dependencies"
+    & $pip install $root --quiet
+    if ($LASTEXITCODE -ne 0) { throw "pip install failed" }
+
+    Write-Host "`n=== Dev Environment Setup complete ===" -ForegroundColor Green
+} finally {
+    Pop-Location
+}

scripts/init-dev-env.ps1

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+#
+# Set up the dev environment from a fresh clone of totk-vscode.
+#
+#   1. Initializes git submodules
+#   2. Installs Node dependencies (root)
+#   3. Creates a Python venv and installs Python dependencies
+#
+# Usage:
+#   ./scripts/init-env.sh
+#   ./scripts/init-env.sh --python /path/to/python3.12  # explicit python
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+PYTHON_CMD=""
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --python)    PYTHON_CMD="$2"; shift 2 ;;
+        *)           echo "Unknown option: $1"; exit 1 ;;
+    esac
+done
+
+cd "$ROOT"
+
+# ── 1. Git submodules ──────────────────────────────────────────────
+echo ""
+echo "=== Initializing git submodules ==="
+git submodule update --init --recursive
+
+# ── 2. Node dependencies ───────────────────────────────────────────
+echo ""
+echo "=== Installing Node dependencies (root) ==="
+npm install
+
+# ── 3. Python venv ─────────────────────────────────────────────────
+echo ""
+echo "=== Setting up Python virtual environment ==="
+
+if [[ -z "$PYTHON_CMD" ]]; then
+    for candidate in python3 python; do
+        if command -v "$candidate" &>/dev/null; then
+            ver=$("$candidate" --version 2>&1 || true)
+            if [[ "$ver" =~ Python\ 3\.([0-9]+) ]] && (( ${BASH_REMATCH[1]} >= 10 )); then
+                PYTHON_CMD="$candidate"
+                echo "  Found: $ver ($candidate)"
+                break
+            fi
+        fi
+    done
+    if [[ -z "$PYTHON_CMD" ]]; then
+        echo "ERROR: Python 3.10+ not found. Install it or pass --python /path/to/python3."
+        exit 1
+    fi
+fi
+
+VENV_DIR="$ROOT/.venv"
+if [[ ! -d "$VENV_DIR" ]]; then
+    echo "  Creating venv at $VENV_DIR"
+    "$PYTHON_CMD" -m venv "$VENV_DIR"
+else
+    echo "  venv already exists at $VENV_DIR"
+fi
+
+PIP="$VENV_DIR/bin/pip"
+echo "  Installing Python dependencies"
+"$PIP" install "$ROOT" --quiet
+
+echo ""
+echo "=== Dev Environment Setup complete ==="