Arch2 Desktop Onboarding & Device Setup Report

Arch2 Desktop Onboarding & Device Setup Report

This document records the zero-friction onboarding framework designed for the Arch2 Desktop environment. Onboarding is fully automated via scripts/bootstrap.ps1 (natively integrated into VS Code Build Tasks via Ctrl+B).

Automated Setup Sequence

1. Host Policy & Toolchain Provisioning

• PowerShell Execution Policy: Configures the shell execution policy to RemoteSigned for the CurrentUser scope to allow scripts to run cleanly.
• Git: Installs/verifies Git.Git via winget (git version 2.55.0.windows.3).
• Node.js: Installs/verifies OpenJS.NodeJS.LTS via winget (v26.4.0).
• Terraform: Installs/verifies HashiCorp.Terraform via winget (v1.15.8).
• Google Cloud CLI: Installs/verifies Google.CloudSDK via winget (gcloud --version).
• .NET SDK: Installs/verifies Microsoft.DotNet.SDK.10 via winget (10.0.302).

2. Environment Variables & Secret Configuration

• Runs script-only onboarding through join-project.ps1 and scripts/sync-local-keyvault-secrets.ps1.
• Hydrates settings/.env.dev.local, settings/.env.test.local, or settings/.env.prod.local based on the selected environment.
• Uses this lifecycle for each managed key:
  1. check for local value
  2. if local value does not exist, check Azure Key Vault
  3. if key vault value does not exist and key is managed as generated, create value
  4. store created value in Azure Key Vault
  5. store resolved value in local environment file
  6. if key vault value exists, use it directly for local environment file

3. Database Scaffolding & Seeding

• Restores project dependencies in api/.
• Runs schema.sql to initialize the database tables.
• Runs seed.sql to fully populate Bloodstock Open Air 2026 stages, bands, sets, walking travel times, and sample user preferences.

4. VS Code Extension Provisioning

• Reads .vscode/extensions.json.
• Iterates and silently installs all recommended workspace extensions (Astro, PowerShell, Terraform, Tailwind CSS, SQLTools) using code --install-extension --force.

5. Dual-Server Dev Services Launch

• Restores dependencies in app/.
• Asynchronously launches the Cloudflare Wrangler Local Dev API (http://127.0.0.1:8787).
• Asynchronously launches the Astro Dev Server (http://localhost:4321) with Vite proxy rules mapping /api/* requests to the Worker API.
• Sleeps for 4 seconds to allow servers to bind, and automatically opens the local PWA in the default browser.

6. Local MCP Server Validation

• Validates local Azure DevOps MCP server binary from workspace dependencies.
• Validates local Filesystem MCP server binary from workspace dependencies.

---

Status: Verified Operational. Onboarding is fully automated and friction-free for any developer onboarding onto the Arch2 Desktop.