V2.0.0-Beta release

.devcontainer/devcontainer.json

@@ -1,94 +1,75 @@
-// For format details, see https://aka.ms/devcontainer.json. For config options, see the
-// README at: https://github.com/devcontainers/templates/tree/main/src/python
+// For format details, see https://aka.ms/devcontainer.json
+// For config options, see https://github.com/devcontainers/templates/tree/main/src/python
 {
-	"name": "RTAudio DevContainer",
-	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
-	"image": "mcr.microsoft.com/devcontainers/python:0-3.11",
-	// Features to add to the dev container. More info: https://containers.dev/features.
+	"name": "ARTAgent DevContainer",
+	// Multi-arch Python 3.11 base image (supports amd64 and arm64)
+	"image": "mcr.microsoft.com/devcontainers/python:1-3.11",
+
+	// Features to add to the dev container
 	"features": {
-		// Enable Docker (via Docker-in-Docker)
+		// Docker-in-Docker for container builds
 		"ghcr.io/devcontainers/features/docker-in-docker:2": {},
-		"ghcr.io/devcontainers/features/common-utils:2": {
-			"installZsh": true,
-			"configureZshAsDefaultShell": true,
-			"installOhMyZsh": true,
-			"upgradePackages": true,
-			"username": "vscode",
-			"remoteUser": "vscode",
-			"userUid": "automatic",
-			"userGid": "automatic"
-		},
-		"ghcr.io/devcontainers-extra/features/zsh-plugins:0": {
-			"plugins": "ssh-agent zsh-syntax-highlighting zsh-autosuggestions",
-			"omzPlugins": "https://github.com/zsh-users/zsh-autosuggestions https://github.com/zsh-users/zsh-syntax-highlighting",
-			"username": "vscode"
-		},
-		"ghcr.io/stuartleeks/dev-container-features/shell-history:0": {},
-		// Node.js for React/Vite frontend toolchain
+
+		// Node.js for React/Vite frontend
 		"ghcr.io/devcontainers/features/node:1": {
-			"version": "22",
-			"nodeGypDependencies": true
+			"version": "22"
 		},
-		"ghcr.io/va-h/devcontainers-features/uv:1": {},
+
 		// Azure CLI
 		"ghcr.io/devcontainers/features/azure-cli:1": {
 			"version": "latest"
 		},
-		// Terraform
+
+		// Terraform (multi-arch)
 		"ghcr.io/devcontainers/features/terraform:1": {
 			"version": "latest"
 		},
+
 		// Azure Developer CLI (azd)
 		"ghcr.io/azure/azure-dev/azd:0": {
 			"version": "latest"
 		}
 	},
-	// Configure tool-specific properties.
+
+	// VS Code customizations
 	"customizations": {
-		// Configure properties specific to VS Code.
 		"vscode": {
-			"settings": {},
+			"settings": {
+				"python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+				"python.terminal.activateEnvironment": true
+			},
 			"extensions": [
-				"GitHub.copilot",
-				"timonwong.shellcheck",
+				// Python (essential)
 				"ms-python.python",
-				"kevinrose.vsc-python-indent",
-				"visualstudioexptteam.vscodeintellicode",
-				"shd101wyy.markdown-preview-enhanced",
-				"github.copilot-chat",
-				"darkriszty.markdown-table-prettify",
-				"DavidAnson.vscode-markdownlint",
-				"yzhang.markdown-all-in-one",
-				"esbenp.prettier-vscode",
-				"ms-vscode-remote.vscode-remote-extensionpack",
-				"shardulm94.trailing-spaces",
-				"streetsidesoftware.code-spell-checker",
+				"ms-python.debugpy",
+				// GitHub Copilot
+				"GitHub.copilot",
+				"GitHub.copilot-chat",
+				// Azure (essential for this project)
 				"ms-azuretools.azure-dev",
 				"ms-azuretools.vscode-azureterraform",
-				"ms-vscode.azurecli",
-				"ms-azureaispeech.azure-ai-speech-toolkit",
-				"github.vscode-github-actions",
-				"ms-python.debugpy",
-				"GitHub.copilot-chat"
+				// Utilities
+				"timonwong.shellcheck"
 			]
 		}
 	},
-	// Use 'forwardPorts' to make a list of ports inside the container available locally.
-	"forwardPorts": [8010],
-	// Use 'portsAttributes' to set default properties for specific forwarded ports. 
-	// More info: https://containers.dev/implementors/json_reference/#port-attributes
+
+	// Port forwarding
+	"forwardPorts": [8010, 5173],
 	"portsAttributes": {
 		"8010": {
-			"label": "Hello Remote World",
+			"label": "FastAPI Backend",
+			"onAutoForward": "notify"
+		},
+		"5173": {
+			"label": "Vite Frontend",
 			"onAutoForward": "notify"
 		}
 	},
-	// Use 'postCreateCommand' to run commands after the container is created.
+
+	// Run setup script after container creation
 	"postCreateCommand": "bash .devcontainer/post_create.sh",
-	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-	"remoteUser": "vscode",
-	"mounts": [
-		// map host ssh to container
-		"source=${env:HOME}${env:USERPROFILE}/.ssh,target=/home/vscode/.ssh,type=bind,consistency=cached"
-	  ]
-}
+
+	// Run as non-root user
+	"remoteUser": "vscode"
+}

.devcontainer/post_create.sh

@@ -1,35 +1,85 @@
 #!/bin/bash
+set -e
 
-# Define the path to your shell profiles
-zshrc_path="$HOME/.zshrc"
-bashrc_path="$HOME/.bashrc"
+echo "🚀 Setting up ARTAgent development environment..."
 
-echo "🚀 Setting up development environment..."
+# Detect architecture
+ARCH=$(uname -m)
+echo "📍 Detected architecture: $ARCH"
 
-# Add local bin to PATH
-echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$zshrc_path"
-echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$bashrc_path"
+# Define shell profile paths
+ZSHRC="$HOME/.zshrc"
+BASHRC="$HOME/.bashrc"
 
-# Source the current path
+# Add local bin to PATH
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$ZSHRC"
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$BASHRC"
 export PATH="$HOME/.local/bin:$PATH"
 
-echo "📦 Installing Bicep CLI..."
-# Install Bicep CLI
-curl -Lo bicep https://github.com/Azure/bicep/releases/latest/download/bicep-linux-x64
-chmod +x ./bicep
-sudo mv ./bicep /usr/local/bin/bicep
+# =============================================================================
+# Configure two-line zsh prompt
+# =============================================================================
+echo "🎨 Configuring two-line zsh prompt..."
+cat >> "$ZSHRC" << 'EOF'
+
+# Two-line prompt configuration
+PROMPT='
+%F{cyan}%n%f %F{blue}%~%f $(git_prompt_info)
+%F{green}❯%f '
+ZSH_THEME_GIT_PROMPT_PREFIX="%F{yellow}("
+ZSH_THEME_GIT_PROMPT_SUFFIX=")%f"
+ZSH_THEME_GIT_PROMPT_DIRTY=" %F{red}✗%f"
+ZSH_THEME_GIT_PROMPT_CLEAN=" %F{green}✓%f"
+EOF
+
+# =============================================================================
+# Install uv (Astral's fast Python package manager)
+# =============================================================================
+echo "📦 Installing uv..."
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Source uv for current session
+source "$HOME/.local/bin/env" 2>/dev/null || export PATH="$HOME/.local/bin:$PATH"
+
+# =============================================================================
+# Install Bicep CLI (multi-arch)
+# =============================================================================
+# echo "📦 Installing Bicep CLI..."
+# if [ "$ARCH" = "aarch64" ] || [ "$ARCH" = "arm64" ]; then
+#     BICEP_URL="https://github.com/Azure/bicep/releases/latest/download/bicep-linux-arm64"
+# else
+#     BICEP_URL="https://github.com/Azure/bicep/releases/latest/download/bicep-linux-x64"
+# fi
 
+# curl -Lo bicep "$BICEP_URL"
+# chmod +x ./bicep
+# sudo mv ./bicep /usr/local/bin/bicep
+# echo "✅ Bicep installed: $(bicep --version)"
+
+# =============================================================================
+# Install system dependencies for Python packages
+# =============================================================================
+echo "📦 Installing system dependencies..."
+sudo apt-get update && sudo apt-get install -y portaudio19-dev
+
+# =============================================================================
+# Setup Python environment with uv
+# =============================================================================
 echo "🐍 Setting up Python environment with uv..."
-# Sync Python dependencies using uv and pyproject.toml
-uv sync --dev
+cd /workspaces/art-voice-agent-accelerator
+
+# Sync all dependencies (main + dev + docs)
+uv sync --extra dev --extra docs
 
-# Display helpful commands
+echo ""
+echo "✅ Development environment ready!"
 echo ""
 echo "📋 Useful commands:"
-echo "  uv run rtagent-server          # Run main orchestrator"
+echo "  uv sync                        # Sync dependencies"
 echo "  uv run pytest                  # Run tests"
-echo "  uv run hatch run lint          # Run linting"
-echo "  uv run hatch run format        # Format code"
-echo "  uv run hatch run quality       # Run all quality checks"
+echo "  uv run python -m uvicorn ...   # Run with uv"
+echo "  source .venv/bin/activate      # Activate venv manually"
+echo ""
 echo "  az login                       # Login to Azure"
-echo "  azd init                       # Initialize Azure Developer CLI"
+echo "  azd up                         # Deploy to Azure"
+echo ""

.dockerignore

@@ -0,0 +1,104 @@
+# =============================================================================
+# Docker Build Context Exclusions
+# =============================================================================
+# This file prevents large/unnecessary files from being included in Docker 
+# build contexts, which can cause "archive/tar: write too long" errors.
+
+# -----------------------------------------------------------------------------
+# Git
+# -----------------------------------------------------------------------------
+.git
+.gitignore
+.gitattributes
+
+# -----------------------------------------------------------------------------
+# IDE / Editor
+# -----------------------------------------------------------------------------
+.vscode
+.idea
+*.swp
+*.swo
+*~
+
+# -----------------------------------------------------------------------------
+# Python
+# -----------------------------------------------------------------------------
+.venv
+venv
+env
+__pycache__
+*.py[cod]
+*$py.class
+*.egg-info
+.eggs
+dist
+build
+*.egg
+.pytest_cache
+.coverage
+htmlcov
+.mypy_cache
+.ruff_cache
+
+# -----------------------------------------------------------------------------
+# Node.js
+# -----------------------------------------------------------------------------
+**/node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# -----------------------------------------------------------------------------
+# Infrastructure / Terraform
+# -----------------------------------------------------------------------------
+infra/terraform/.terraform
+infra/terraform/*.tfstate
+infra/terraform/*.tfstate.*
+infra/terraform/.terraform.lock.hcl
+.azure/**/infra/terraform/.terraform
+
+# -----------------------------------------------------------------------------
+# Azure Developer CLI
+# -----------------------------------------------------------------------------
+.azure
+
+# -----------------------------------------------------------------------------
+# Documentation (not needed in containers)
+# -----------------------------------------------------------------------------
+docs
+*.md
+!README.md
+
+# -----------------------------------------------------------------------------
+# Tests (not needed in production containers)
+# -----------------------------------------------------------------------------
+tests
+**/tests
+**/*_test.py
+**/*_test.js
+**/*.test.js
+**/*.spec.js
+
+# -----------------------------------------------------------------------------
+# Samples and Labs
+# -----------------------------------------------------------------------------
+samples
+labs
+
+# -----------------------------------------------------------------------------
+# DevOps (CI/CD configs not needed in containers)
+# -----------------------------------------------------------------------------
+.github
+devops/security
+
+# -----------------------------------------------------------------------------
+# Misc
+# -----------------------------------------------------------------------------
+*.log
+*.tmp
+*.temp
+.env.local
+.env.*.local
+Makefile
+CHANGELOG.md
+CONTRIBUTING.md