feat: introduce MCP server, cross-platform runtime, and Showcase UI reorganization

- Showcase UI Reorganization:
  * Move web UI dashboard from root directory into apps/showcase_ui/ for cleaner project structure
  * Add 'artemis ui' CLI command (artemis/interfaces/cli/commands/ui.py) and launcher scripts for the interactive showcase console
- Standalone MCP Server & Notifiers (mcp_server/):
  * Implement dedicated MCP server package with mobile automation tools (device_state, inspect_trace, task_manager, task_runner)
  * Add multi-channel notifiers (AgentAPI, Desktop notifications, Webhooks, File output, and Composite routing)
  * Introduce background task runner and trace store for autonomous mobile execution monitoring
- Cross-Platform Runtime & Toolchain Support:
  * Add artemis/platform/ with OS-specific implementations for Linux, macOS (Darwin), and Windows
  * Add artemis/runtime/supervisor.py for resilient process and agent runtime supervision
  * Add artemis/toolchain/ with dependency resolution and SDK descriptors
  * Add cross-platform launcher scripts (start.sh, start.bat) and installer scripts (scripts/install_deps.*)
- Core Enhancements & Diagnostics:
  * Enhance coordinate normalization, OCR API fallback, and perception pipeline
  * Add credential validation (credentials_validator.py) and system diagnostics
  * Update bilingual documentation (README.md, README_CN.md) and architecture diagrams
- Test Suite Expansion:
  * Add integration tests for cloud gateway, remote ADB, and Artemis login
  * Add unit tests covering core diagnostics, platform detection, toolchain, credentials validator, optional OCR, and MCP tools
This commit is contained in:
somew1nd committed 2026-08-18 13:59:27 -07:00
1 parent 78e478f502
commit 9a5aaf99b7
249 files changed
+37226 -9339

No files matched your search

+37 -8
View File
@@ -1,4 +1,18 @@
.PHONY: help test install setup clean precommit-install precommit lint format typecheck
# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
.PHONY: help test install install-deps setup start ui doctor clean precommit-install precommit lint format typecheck
help: ## Show this help message
@echo 'Usage: make [target]'
@@ -6,14 +20,27 @@ help: ## Show this help message
@echo 'Available targets:'
@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf " %-20s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
start: ## One-click start Artemis Showcase UI and auto-open browser
@bash start.sh
ui: ## Launch the unified Showcase UI & Admin Console in browser
@uv run artemis ui --open
doctor: ## Run system, device, and toolchain diagnostics
@uv run artemis doctor
test: ## Run all tests
@echo "🧪 Running all tests..."
@uv run pytest -v
install: ## Install dependencies
@echo "📦 Installing dependencies..."
install: ## Install python dependencies via uv
@echo "📦 Installing python dependencies..."
@uv sync --dev
install-deps: ## One-click install all system dependencies (ADB, FFmpeg, scrcpy, Python, uv)
@echo "⚡ Running one-click dependency installer..."
@bash scripts/install_deps.sh
setup: ## Setup project (install dependencies + pre-commit hooks)
@echo "🚀 Setting up project..."
@$(MAKE) install
@@ -47,10 +74,12 @@ precommit: ## Run pre-commit hooks manually on all files
@echo "🔍 Running pre-commit checks..."
@uv run pre-commit run --all-files
clean: ## Clean up generated files and caches
@echo "🧹 Cleaning up..."
@rm -rf .pytest_cache
@rm -rf .ruff_cache
@rm -rf **/__pycache__
clean: ## Clean up generated files, caches, and traces
@echo "🧹 Cleaning up caches and temporary files..."
@rm -rf .pytest_cache .ruff_cache .artemis_paused traces scratch .venv apps/showcase_ui/.angular build dist
@find . -type d -name "outputs" -exec rm -rf {} + 2>/dev/null || true
@find . -type f -name ".artemis_paused" -delete 2>/dev/null || true
@find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
@find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
@find . -type f -name "*.py[cod]" -delete 2>/dev/null || true
@echo "✅ Cleanup complete"