Improve Grace's agent-readiness (#52)

* Removing old references to Dapr and Kubernetes.

* Improve Grace's agent-readiness.

* Reuse shared Aspire host for smoke test

* Quick namespace fix.

* Run Fantomas checks in CI

* Disable Fantomas check in validate

---------

Co-authored-by: Scott Arbeit <scottarbeit@github.com>

Author: ScottArbeit

.config/dotnet-tools.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "fantomas-tool": {
+      "version": "4.7.9",
+      "commands": [
+        "fantomas"
+      ]
+    }
+  }
+}

.env.example

@@ -0,0 +1,64 @@
+# Grace .env example (placeholders only)
+
+GRACE_SERVER_URI=http://localhost:5000
+GRACE_TOKEN=changeme
+GRACE_TOKEN_FILE=
+
+GRACE_TESTING=0
+GRACE_TEST_CLEANUP=1
+
+ASPIRE_RESOURCE_MODE=Local
+
+# Telemetry
+# grace__applicationinsightsconnectionstring=
+
+# OIDC / Auth
+# grace__auth__oidc__authority=
+# grace__auth__oidc__audience=
+# grace__auth__oidc__cli_client_id=
+# grace__auth__oidc__cli_redirect_port=
+# grace__auth__oidc__cli_scopes=
+# grace__auth__oidc__m2m_client_id=
+# grace__auth__oidc__m2m_client_secret=
+# grace__auth__oidc__m2m_scopes=
+
+# PAT defaults
+# grace__auth__pat__default_lifetime_days=
+# grace__auth__pat__max_lifetime_days=
+# grace__auth__pat__allow_no_expiry=
+
+# Azure Storage
+# grace__azure_storage__connectionstring=
+# grace__azure_storage__account_name=
+# grace__azure_storage__endpoint_suffix=
+# grace__azure_storage__key=
+# grace__azure_storage__directoryversion_container_name=
+# grace__azure_storage__diff_container_name=
+# grace__azure_storage__zipfile_container_name=
+
+# Azure Cosmos DB
+# grace__azurecosmosdb__connectionstring=
+# grace__azurecosmosdb__endpoint=
+# grace__azurecosmosdb__database_name=
+# grace__azurecosmosdb__container_name=
+
+# Azure Service Bus
+# grace__azure_service_bus__connectionstring=
+# grace__azure_service_bus__namespace=
+# grace__azure_service_bus__topic=
+# grace__azure_service_bus__subscription=
+
+# Redis
+# grace__redis__host=127.0.0.1
+# grace__redis__port=6379
+
+# Orleans
+# orleans_cluster_id=
+# orleans_service_id=
+
+# Pub/Sub
+# grace__pubsub__system=AzureServiceBus
+
+# Diagnostics
+# grace__log_directory=
+# grace__debug_environment=Local

.github/workflows/validate.yml

@@ -0,0 +1,40 @@
+name: Validate
+
+on:
+  pull_request:
+    branches: [ main ]
+  push:
+    branches: [ main ]
+  schedule:
+    - cron: "0 3 * * *"
+
+jobs:
+  fast:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+      - name: Install .NET Aspire workload
+        run: dotnet workload install aspire
+      - name: Validate (Fast)
+        run: pwsh ./scripts/validate.ps1 -Fast
+
+  full:
+    if: github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+      - name: Install .NET Aspire workload
+        run: dotnet workload install aspire
+      - name: Docker info
+        run: docker info
+      - name: Validate (Full)
+        run: pwsh ./scripts/validate.ps1 -Full

AGENTS.md

@@ -3,6 +3,29 @@
 Other `AGENTS.md` files exist in subdirectories, refer to them for more specific
 context.
 
+## Agent Quickstart (Local)
+
+Prerequisites:
+
+- PowerShell 7.x
+- .NET 10 SDK
+- Docker Desktop (required for `-Full`)
+
+Commands:
+
+- `pwsh ./scripts/bootstrap.ps1`
+- `pwsh ./scripts/validate.ps1 -Fast`
+
+Use `pwsh ./scripts/validate.ps1 -Full` for Aspire integration coverage.
+Optional: `pwsh ./scripts/install-githooks.ps1` to add a pre-commit
+`validate -Fast` hook.
+
+More context:
+
+- `src/AGENTS.md`
+- `src/docs/ASPIRE_SETUP.md`
+- `src/docs/ENVIRONMENT.md`
+
 ## Issue Tracking
 
 This project uses **bd (beads)** for issue tracking.

global.json

@@ -0,0 +1,6 @@
+{
+  "sdk": {
+    "version": "10.0.100",
+    "rollForward": "latestPatch"
+  }
+}

scripts/bootstrap.ps1

@@ -0,0 +1,89 @@
+[CmdletBinding()]
+param(
+    [switch]$SkipDocker,
+    [switch]$CI
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+if ($CI) {
+    $ProgressPreference = "SilentlyContinue"
+}
+
+$startTime = Get-Date
+$exitCode = 0
+
+function Write-Section([string]$Title) {
+    Write-Host ""
+    Write-Host ("== {0} ==" -f $Title)
+}
+
+function Invoke-External([string]$Label, [scriptblock]$Command) {
+    & $Command
+    if ($LASTEXITCODE -ne 0) {
+        throw "$Label failed with exit code $LASTEXITCODE."
+    }
+}
+
+try {
+    Write-Section "Prerequisites"
+
+    if ($PSVersionTable.PSVersion.Major -lt 7) {
+        throw "PowerShell 7.x is required. Current version: $($PSVersionTable.PSVersion)."
+    }
+
+    Write-Verbose ("PowerShell version: {0}" -f $PSVersionTable.PSVersion)
+
+    try {
+        Get-Command dotnet -ErrorAction Stop | Out-Null
+    } catch {
+        throw "dotnet SDK not found. Install the .NET 10 SDK and retry."
+    }
+
+    $dotnetVersion = (& dotnet --version).Trim()
+    if ($LASTEXITCODE -ne 0) {
+        throw "dotnet --version failed. Ensure the .NET 10 SDK is installed."
+    }
+    if ([string]::IsNullOrWhiteSpace($dotnetVersion)) {
+        throw "dotnet --version returned an empty value."
+    }
+
+    $dotnetMajor = [int]($dotnetVersion.Split(".")[0])
+    if ($dotnetMajor -lt 10) {
+        throw "dotnet SDK 10.x required. Detected $dotnetVersion."
+    }
+
+    if (-not $SkipDocker) {
+        try {
+            Get-Command docker -ErrorAction Stop | Out-Null
+        } catch {
+            throw "Docker is required for full validation. Install Docker Desktop or run with -SkipDocker."
+        }
+
+        Invoke-External "docker info" { docker info | Out-Null }
+    } else {
+        Write-Host "Skipping Docker check (-SkipDocker)."
+    }
+
+    Write-Section "Restore Tools"
+    Invoke-External "dotnet tool restore" { dotnet tool restore }
+
+    Write-Section "Restore Packages"
+    Invoke-External "dotnet restore" { dotnet restore "src/Grace.sln" }
+
+    Write-Section "Next Steps"
+    Write-Host "Run: pwsh ./scripts/validate.ps1 -Fast"
+    Write-Host "Use -Full for Aspire integration coverage."
+} catch {
+    $exitCode = 1
+    Write-Error $_
+} finally {
+    $elapsed = (Get-Date) - $startTime
+    Write-Host ""
+    Write-Host ("Elapsed: {0:c}" -f $elapsed)
+
+    if ($exitCode -ne 0) {
+        exit $exitCode
+    }
+}

scripts/install-githooks.ps1

@@ -0,0 +1,93 @@
+[CmdletBinding()]
+param(
+    [switch]$Uninstall,
+    [switch]$Force
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$repoRoot = Resolve-Path (Join-Path $PSScriptRoot "..")
+$gitDir = Join-Path $repoRoot ".git"
+
+if (-not (Test-Path $gitDir)) {
+    throw "No .git directory found at $gitDir. Run from inside a Git clone."
+}
+
+$hookDir = Join-Path $gitDir "hooks"
+$hookPath = Join-Path $hookDir "pre-commit"
+$backupPath = Join-Path $hookDir "pre-commit.grace.bak"
+$marker = "Grace Validate Hook"
+
+function Get-FileContent([string]$Path) {
+    if (-not (Test-Path $Path)) {
+        return ""
+    }
+
+    return (Get-Content -Path $Path -Raw)
+}
+
+function Write-Hook([string]$Path) {
+    $hook = @"
+#!/usr/bin/env sh
+# Grace Validate Hook (installed by scripts/install-githooks.ps1)
+# Runs validate -Fast after any existing hook logic.
+
+HOOK_DIR=$(cd "$(dirname "$0")" && pwd)
+BACKUP="$HOOK_DIR/pre-commit.grace.bak"
+
+if [ -x "$BACKUP" ]; then
+  "$BACKUP" "$@" || exit $?
+fi
+
+if command -v pwsh >/dev/null 2>&1; then
+  REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
+  if [ -n "$REPO_ROOT" ]; then
+    pwsh -NoProfile -ExecutionPolicy Bypass -File "$REPO_ROOT/scripts/validate.ps1" -Fast || exit $?
+  else
+    echo "Grace hook: unable to locate repo root; skipping validate." >&2
+  fi
+else
+  echo "Grace hook: pwsh not found; skipping validate." >&2
+fi
+"@
+
+    Set-Content -Path $Path -Value $hook -Encoding ASCII
+}
+
+if ($Uninstall) {
+    $current = Get-FileContent $hookPath
+
+    if ($current -match $marker) {
+        if (Test-Path $backupPath) {
+            Copy-Item -Path $backupPath -Destination $hookPath -Force
+            Remove-Item -Path $backupPath -Force
+            Write-Host "Restored original pre-commit hook."
+        } else {
+            Remove-Item -Path $hookPath -Force
+            Write-Host "Removed Grace pre-commit hook."
+        }
+    } else {
+        Write-Host "Grace pre-commit hook not installed. No changes made."
+    }
+
+    return
+}
+
+$existing = Get-FileContent $hookPath
+if ($existing -match $marker) {
+    Write-Host "Grace pre-commit hook already installed."
+    return
+}
+
+if (Test-Path $hookPath) {
+    if ((Test-Path $backupPath) -and -not $Force) {
+        throw "Backup already exists at $backupPath. Use -Force to overwrite."
+    }
+
+    Copy-Item -Path $hookPath -Destination $backupPath -Force
+}
+
+Write-Hook $hookPath
+Write-Host "Installed Grace pre-commit hook (validate -Fast)."
+Write-Host "Run with -Uninstall to restore the previous hook."