feat: enable full AI automation and safe startup updates

scripts/start.ps1

@@ -17,6 +17,7 @@ param(
     [int]$Port = 8000,
     [switch]$NoOpen = $false,
     [switch]$SetupOnly = $false,
+    [switch]$SkipUpdate = $false,
     [ValidateSet('Official', 'China')][string]$Mirror
 )
 
@@ -32,6 +33,27 @@ $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition
 $RootDir = Split-Path -Parent $ScriptDir
 Set-Location $RootDir
 
+# Existing installations check source BEFORE importing bootstrap helpers.
+$existingPython = Join-Path $RootDir '.venv\Scripts\python.exe'
+if ((-not $SkipUpdate) -and (Test-Path -LiteralPath $existingPython)) {
+    & $existingPython (Join-Path $ScriptDir 'update_installation.py') source --port $Port
+    $updateExit = $LASTEXITCODE
+    if ($updateExit -eq 20) { exit 1 }
+    if ($updateExit -eq 10) {
+        # Reparse the freshly updated launcher; do not continue running stale functions.
+        $reloadArgs = @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', (Join-Path $ScriptDir 'start.ps1'), '-Port', $Port, '-SkipUpdate')
+        if ($NoOpen) { $reloadArgs += '-NoOpen' }
+        if ($SetupOnly) { $reloadArgs += '-SetupOnly' }
+        if ($Mirror) { $reloadArgs += @('-Mirror', $Mirror) }
+        & powershell.exe @reloadArgs
+        exit $LASTEXITCODE
+    }
+    if ($updateExit -ne 0) {
+        Write-Host '   [ERROR] Source update check failed. Resolve the error above, or use -SkipUpdate for local startup.' -ForegroundColor Red
+        exit 1
+    }
+}
+
 . (Join-Path $ScriptDir 'download_config.ps1')
 try {
     Initialize-ArtemisDownloads -ProjectRoot $RootDir -Mode $Mirror
@@ -320,6 +342,11 @@ if (-not (Test-Path -LiteralPath (Join-Path $RootDir '.env'))) {
         Write-Host '   [OK] Created .env from .env.example. Configure your model in the web UI.' -ForegroundColor Green
     }
 }
+Write-Host '   [CHECK] Refreshing already-configured MCP clients...' -ForegroundColor Cyan
+& $ArtemisPython (Join-Path $ScriptDir 'update_installation.py') mcp
+if ($LASTEXITCODE -ne 0) {
+    Write-Host '   [WARN] MCP refresh failed. Existing client settings were not replaced; check the errors above.' -ForegroundColor Yellow
+}
 if ($SetupOnly) {
     Write-Host '   [OK] Setup complete. Run start.bat to launch Artemis.' -ForegroundColor Green
     exit 0
@@ -381,7 +408,10 @@ Start-LocalAdbServer
 $ShowcaseIndex = "$RootDir\apps\showcase_ui\dist\frontend\browser\index.html"
 $ShowcaseIndexAlt1 = "$RootDir\apps\showcase_ui\dist\browser\index.html"
 $ShowcaseIndexAlt2 = "$RootDir\apps\showcase_ui\dist\index.html"
-if ((-not (Test-Path $ShowcaseIndex)) -and (-not (Test-Path $ShowcaseIndexAlt1)) -and (-not (Test-Path $ShowcaseIndexAlt2))) {
+& $ArtemisPython (Join-Path $ScriptDir 'update_installation.py') frontend-check
+$frontendChanged = $LASTEXITCODE -eq 10
+if ($LASTEXITCODE -notin @(0, 10)) { Write-Host '   [ERROR] Could not check frontend sources.' -ForegroundColor Red; exit 1 }
+if ($frontendChanged -or ((-not (Test-Path $ShowcaseIndex)) -and (-not (Test-Path $ShowcaseIndexAlt1)) -and (-not (Test-Path $ShowcaseIndexAlt2)))) {
     if (-not (Test-NodeCompatible)) {
         if (Test-CommandExists "node") {
             $curVer = (& node -v 2>$null)
@@ -429,7 +459,7 @@ if ((-not (Test-Path $ShowcaseIndex)) -and (-not (Test-Path $ShowcaseIndexAlt1))
     if (Test-NodeCompatible) {
         $nodeVer = (& node -v 2>$null)
         Write-Host "   [OK] Node.js $nodeVer is ready." -ForegroundColor Green
-        Write-Host "   [INFO] Showcase UI build not found. Compiling Angular Showcase UI..." -ForegroundColor Yellow
+        Write-Host "   [INFO] Showcase UI sources/dependencies changed or build missing. Compiling..." -ForegroundColor Yellow
         Push-Location "$RootDir\apps\showcase_ui"
         try {
             $npmExec = if (Test-CommandExists "npm.cmd") { "npm.cmd" } else { "npm" }
@@ -443,11 +473,13 @@ if ((-not (Test-Path $ShowcaseIndex)) -and (-not (Test-Path $ShowcaseIndexAlt1))
             if ($LASTEXITCODE -ne 0) { throw "Frontend build failed (exit $LASTEXITCODE)." }
             if (Test-Path $ShowcaseIndex) {
                 Write-Host "   [OK] Showcase UI compiled successfully." -ForegroundColor Green
-            } elseif (Test-Path $ShowcaseIndexAlt1) {
+            } elseif ((Test-Path $ShowcaseIndexAlt1) -or (Test-Path $ShowcaseIndexAlt2)) {
                 Write-Host "   [OK] Showcase UI compiled successfully." -ForegroundColor Green
             } else {
                 throw 'Frontend build did not produce index.html.'
             }
+            & $ArtemisPython (Join-Path $ScriptDir 'update_installation.py') frontend-mark
+            if ($LASTEXITCODE -ne 0) { throw 'Could not save frontend build fingerprint.' }
         } catch {
             Write-Host "   [ERROR] Failed to build Showcase UI: $_" -ForegroundColor Red
             exit 1
@@ -460,33 +492,7 @@ if ((-not (Test-Path $ShowcaseIndex)) -and (-not (Test-Path $ShowcaseIndexAlt1))
     }
 }
 
-# 7. Optionally configure MCP for detected AI IDEs
-Write-Host ""
-Write-Host "   [INFO] Would you like to configure ARTEMIS MCP & testing rules for your AI IDEs?" -ForegroundColor Cyan
-Write-Host "      (Supported: Antigravity, Cursor, Claude Code/Desktop, Codex, OpenClaw, Windsurf)"
-$installMcp = "Y"
-if ([Console]::IsInputRedirected -eq $false) {
-    $response = Read-Host "      Install MCP configuration & rules now? [Y/n]"
-    if ($response -ne "") {
-        $installMcp = $response
-    }
-} else {
-    $installMcp = "N"
-}
-
-if ($installMcp -match "^[Yy]") {
-    Write-Host "   Installing MCP server configuration & testing rules..." -ForegroundColor Cyan
-    & $ArtemisPython -m artemis mcp --install all
-    if ($LASTEXITCODE -eq 0) {
-        Write-Host "   [OK] MCP configuration and rules installed successfully." -ForegroundColor Green
-        Write-Host "   [TIP] You can update or re-install anytime with: uv run artemis mcp --install all" -ForegroundColor Cyan
-    } else {
-        Write-Host "   [WARN] MCP installation failed. Review the error above and retry with: uv run artemis mcp --install all" -ForegroundColor Yellow
-    }
-} else {
-    Write-Host "   [SKIP] You can install MCP anytime later with: uv run artemis mcp --install all" -ForegroundColor Yellow
-}
-Write-Host ""
+# MCP clients were refreshed after Python dependency sync above.
 
 # 8. Launch unified Showcase UI & open browser
 # Ensure local ADB daemon is warm & listening