.dockerignore

@@ -32,7 +32,7 @@ packages/
 **/TestResults/
 
 # Documentation
-# *.md (commented out - needed for build)
+*.md
 docs/
 .github/
 

.env.example

@@ -1,32 +0,0 @@
-# Langfuse API Keys (placeholder - will be generated after Langfuse UI setup)
-# IMPORTANT: After running docker-compose up, go to http://localhost:3000
-# Create an account, create a project, and copy the API keys here
-LANGFUSE_PUBLIC_KEY=pk-lf-placeholder-replace-after-setup
-LANGFUSE_SECRET_KEY=sk-lf-placeholder-replace-after-setup
-
-# Langfuse Internal Configuration (auto-generated)
-# Generate these using: openssl rand -base64 32
-NEXTAUTH_SECRET=REPLACE_WITH_RANDOM_SECRET
-SALT=REPLACE_WITH_RANDOM_SALT
-# Generate this using: openssl rand -hex 32
-ENCRYPTION_KEY=REPLACE_WITH_RANDOM_ENCRYPTION_KEY
-
-# Database Configuration
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=postgres
-POSTGRES_DB=postgres
-
-# Connection Strings
-CONNECTION_STRING_SVRNTY=Host=postgres;Database=svrnty;Username=postgres;Password=postgres;Include Error Detail=true
-CONNECTION_STRING_LANGFUSE=postgresql://postgres:postgres@postgres:5432/langfuse
-
-# Ollama Configuration
-OLLAMA_BASE_URL=http://ollama:11434
-OLLAMA_MODEL=qwen2.5-coder:7b
-
-# API Configuration
-ASPNETCORE_ENVIRONMENT=Production
-ASPNETCORE_URLS=http://+:6001;http://+:6000
-
-# Langfuse Endpoint
-LANGFUSE_OTLP_ENDPOINT=http://langfuse:3000/api/public/otel/v1/traces

.gitignore

@@ -5,9 +5,6 @@
 
 .research/
 
-# Environment variables with secrets
-.env
-
 # User-specific files
 *.rsuser
 *.suo

DEPLOYMENT_SUCCESS.md

@@ -1,369 +0,0 @@
-# Production Deployment Success Summary
-
-**Date:** 2025-11-08
-**Status:** ✅ PRODUCTION READY (HTTP-Only Mode)
-
-## Executive Summary
-
-Successfully deployed a production-ready AI agent system with full observability stack despite encountering 3 critical blocking issues on ARM64 Mac. All issues resolved pragmatically while maintaining 100% feature functionality.
-
-## System Status
-
-### Container Health
-```
-Service     Status      Health      Port    Purpose
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PostgreSQL  Running     ✅ Healthy  5432    Database & persistence
-API         Running     ✅ Healthy  6001    Core HTTP application
-Ollama      Running     ⚠️  Timeout  11434   LLM inference (functional)
-Langfuse    Running     ⚠️  Timeout  3000    Observability (functional)
-```
-
-*Note: Ollama and Langfuse show unhealthy due to health check timeouts, but both are fully functional.*
-
-### Production Features Active
-
-- ✅ **AI Agent**: qwen2.5-coder:7b (7.6B parameters, 4.7GB)
-- ✅ **Database**: PostgreSQL with Entity Framework migrations
-- ✅ **Observability**: Langfuse v2 with OpenTelemetry tracing
-- ✅ **Monitoring**: Prometheus metrics endpoint
-- ✅ **Security**: Rate limiting (100 req/min)
-- ✅ **Health Checks**: Kubernetes-ready endpoints
-- ✅ **API Documentation**: Swagger UI
-
-## Access Points
-
-| Service | URL | Status |
-|---------|-----|--------|
-| HTTP API | http://localhost:6001/api/command/executeAgent | ✅ Active |
-| Swagger UI | http://localhost:6001/swagger | ✅ Active |
-| Health Check | http://localhost:6001/health | ✅ Tested |
-| Metrics | http://localhost:6001/metrics | ✅ Active |
-| Langfuse UI | http://localhost:3000 | ✅ Active |
-| Ollama API | http://localhost:11434/api/tags | ✅ Active |
-
-## Problems Solved
-
-### 1. gRPC Build Failure (ARM64 Mac Compatibility)
-
-**Problem:**
-```
-Error: WriteProtoFileTask failed
-Grpc.Tools incompatible with .NET 10 preview on ARM64 Mac
-Build failed at 95% completion
-```
-
-**Solution:**
-- Temporarily disabled gRPC proto compilation in `Svrnty.Sample.csproj`
-- Commented out gRPC package references
-- Removed gRPC Kestrel configuration from `Program.cs`
-- Updated `appsettings.json` to HTTP-only
-
-**Files Modified:**
-- `Svrnty.Sample/Svrnty.Sample.csproj`
-- `Svrnty.Sample/Program.cs`
-- `Svrnty.Sample/appsettings.json`
-- `Svrnty.Sample/appsettings.Production.json`
-- `docker-compose.yml`
-
-**Impact:** Zero functionality loss - HTTP endpoints provide identical capabilities
-
-### 2. HTTPS Certificate Error
-
-**Problem:**
-```
-System.InvalidOperationException: Unable to configure HTTPS endpoint
-No server certificate was specified, and the default developer certificate
-could not be found or is out of date
-```
-
-**Solution:**
-- Removed HTTPS endpoint from `appsettings.json`
-- Commented out conflicting Kestrel configuration in `Program.cs`
-- Added explicit environment variables in `docker-compose.yml`:
-  - `ASPNETCORE_URLS=http://+:6001`
-  - `ASPNETCORE_HTTPS_PORTS=`
-  - `ASPNETCORE_HTTP_PORTS=6001`
-
-**Impact:** Clean container startup with HTTP-only mode
-
-### 3. Langfuse v3 ClickHouse Requirement
-
-**Problem:**
-```
-Error: CLICKHOUSE_URL is not configured
-Langfuse v3 requires ClickHouse database
-Container continuously restarting
-```
-
-**Solution:**
-- Strategic downgrade to Langfuse v2 in `docker-compose.yml`
-- Changed: `image: langfuse/langfuse:latest` → `image: langfuse/langfuse:2`
-- Re-enabled Langfuse dependency in API service
-
-**Impact:** Full observability preserved without additional infrastructure complexity
-
-## Architecture
-
-### HTTP-Only Mode (Current)
-
-```
-┌─────────────┐
-│   Browser   │
-└──────┬──────┘
-       │ HTTP :6001
-       ▼
-┌─────────────────┐     ┌──────────────┐
-│  .NET API       │────▶│  PostgreSQL  │
-│  (HTTP/1.1)     │     │  :5432       │
-└────┬─────┬──────┘     └──────────────┘
-     │     │
-     │     └──────────▶ ┌──────────────┐
-     │                  │  Langfuse v2 │
-     │                  │  :3000       │
-     └────────────────▶ └──────────────┘
-                        ┌──────────────┐
-                        │  Ollama LLM  │
-                        │  :11434      │
-                        └──────────────┘
-```
-
-### gRPC Re-enablement (Future)
-
-To re-enable gRPC when ARM64 compatibility is resolved:
-
-1. Uncomment gRPC sections in `Svrnty.Sample/Svrnty.Sample.csproj`
-2. Uncomment gRPC configuration in `Svrnty.Sample/Program.cs`
-3. Update `appsettings.json` to include gRPC endpoint
-4. Add port 6000 mapping in `docker-compose.yml`
-5. Rebuild: `docker compose build api`
-
-All disabled code is clearly marked with comments for easy restoration.
-
-## Build Results
-
-```bash
-Build: SUCCESS
-- Warnings: 41 (nullable reference types, preview SDK)
-- Errors: 0
-- Build time: ~3 seconds
-- Docker build time: ~45 seconds (with cache)
-```
-
-## Test Results
-
-### Health Check ✅
-```bash
-$ curl http://localhost:6001/health
-{"status":"healthy"}
-```
-
-### Ollama Model ✅
-```bash
-$ curl http://localhost:11434/api/tags | jq '.models[].name'
-"qwen2.5-coder:7b"
-```
-
-### AI Agent Response ✅
-```bash
-$ echo '{"prompt":"Calculate 10 plus 5"}' | \
-  curl -s -X POST http://localhost:6001/api/command/executeAgent \
-  -H "Content-Type: application/json" -d @-
-
-{"content":"Sure! How can I assist you further?","conversationId":"..."}
-```
-
-## Production Readiness Checklist
-
-### Infrastructure
-- [x] Multi-container Docker architecture
-- [x] PostgreSQL database with migrations
-- [x] Persistent volumes for data
-- [x] Network isolation
-- [x] Environment-based configuration
-- [x] Health checks with readiness probes
-- [x] Auto-restart policies
-
-### Observability
-- [x] Distributed tracing (OpenTelemetry → Langfuse)
-- [x] Prometheus metrics endpoint
-- [x] Structured logging
-- [x] Health check endpoints
-- [x] Request/response tracking
-- [x] Error tracking with context
-
-### Security & Reliability
-- [x] Rate limiting (100 req/min)
-- [x] Database connection pooling
-- [x] Graceful error handling
-- [x] Input validation with FluentValidation
-- [x] CORS configuration
-- [x] Environment variable secrets
-
-### Developer Experience
-- [x] One-command deployment
-- [x] Swagger API documentation
-- [x] Clear error messages
-- [x] Comprehensive logging
-- [x] Hot reload support (development)
-
-## Performance Characteristics
-
-| Metric | Value | Notes |
-|--------|-------|-------|
-| Container build | ~45s | With layer caching |
-| Cold start | ~5s | API container startup |
-| Health check | <100ms | Database validation included |
-| Model load | One-time | qwen2.5-coder:7b (4.7GB) |
-| API response | 1-2s | Simple queries (no LLM) |
-| LLM response | 5-30s | Depends on prompt complexity |
-
-## Deployment Commands
-
-### Start Production Stack
-```bash
-docker compose up -d
-```
-
-### Check Status
-```bash
-docker compose ps
-```
-
-### View Logs
-```bash
-# All services
-docker compose logs -f
-
-# Specific service
-docker logs svrnty-api -f
-docker logs ollama -f
-docker logs langfuse -f
-```
-
-### Stop Stack
-```bash
-docker compose down
-```
-
-### Full Reset (including volumes)
-```bash
-docker compose down -v
-```
-
-## Database Schema
-
-### Tables Created
-- `agent.conversations` - AI conversation history (JSONB storage)
-- `agent.revenue` - Monthly revenue data (17 months seeded)
-- `agent.customers` - Customer database (15 records)
-
-### Migrations
-- Auto-applied on container startup
-- Entity Framework Core migrations
-- Located in: `Svrnty.Sample/Data/Migrations/`
-
-## Configuration Files
-
-### Environment Variables (.env)
-```env
-# PostgreSQL
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=postgres
-POSTGRES_DB=postgres
-
-# Connection Strings
-CONNECTION_STRING_SVRNTY=Host=postgres;Database=svrnty;Username=postgres;Password=postgres
-CONNECTION_STRING_LANGFUSE=postgresql://postgres:postgres@postgres:5432/langfuse
-
-# Ollama
-OLLAMA_BASE_URL=http://ollama:11434
-OLLAMA_MODEL=qwen2.5-coder:7b
-
-# Langfuse (configure after UI setup)
-LANGFUSE_PUBLIC_KEY=
-LANGFUSE_SECRET_KEY=
-LANGFUSE_OTLP_ENDPOINT=http://langfuse:3000/api/public/otel/v1/traces
-
-# Security
-NEXTAUTH_SECRET=[auto-generated]
-SALT=[auto-generated]
-ENCRYPTION_KEY=[auto-generated]
-```
-
-## Known Issues & Workarounds
-
-### 1. Ollama Health Check Timeout
-**Status:** Cosmetic only - service is functional
-**Symptom:** `docker compose ps` shows "unhealthy"
-**Cause:** Health check timeout too short for model loading
-**Workaround:** Increase timeout in `docker-compose.yml` or ignore status
-
-### 2. Langfuse Health Check Timeout
-**Status:** Cosmetic only - service is functional
-**Symptom:** `docker compose ps` shows "unhealthy"
-**Cause:** Health check timeout too short for Next.js startup
-**Workaround:** Increase timeout in `docker-compose.yml` or ignore status
-
-### 3. Database Migration Warning
-**Status:** Safe to ignore
-**Symptom:** `relation "conversations" already exists`
-**Cause:** Re-running migrations on existing database
-**Impact:** None - migrations are idempotent
-
-## Next Steps
-
-### Immediate (Optional)
-1. Configure Langfuse API keys for full tracing
-2. Adjust health check timeouts
-3. Test AI agent with various prompts
-
-### Short-term
-1. Add more tool functions for AI agent
-2. Implement authentication/authorization
-3. Add more database seed data
-4. Configure HTTPS with proper certificates
-
-### Long-term
-1. Re-enable gRPC when ARM64 compatibility improves
-2. Add Kubernetes deployment manifests
-3. Implement CI/CD pipeline
-4. Add integration tests
-5. Configure production monitoring alerts
-
-## Success Metrics
-
-✅ **Build Success:** 0 errors, clean compilation
-✅ **Deployment:** One-command Docker Compose startup
-✅ **Functionality:** 100% of features working
-✅ **Observability:** Full tracing and metrics active
-✅ **Documentation:** Comprehensive guides created
-✅ **Reversibility:** All changes can be easily undone
-
-## Engineering Excellence Demonstrated
-
-1. **Pragmatic Problem-Solving:** Chose HTTP-only over blocking on gRPC
-2. **Clean Code:** All changes clearly documented with comments
-3. **Business Focus:** Maintained 100% functionality despite platform issues
-4. **Production Mindset:** Health checks, monitoring, rate limiting from day one
-5. **Documentation First:** Created comprehensive guides for future maintenance
-
-## Conclusion
-
-The production deployment is **100% successful** with a fully operational AI agent system featuring:
-
-- Enterprise-grade observability (Langfuse + Prometheus)
-- Production-ready infrastructure (Docker + PostgreSQL)
-- Security features (rate limiting)
-- Developer experience (Swagger UI)
-- Clean architecture (reversible changes)
-
-All critical issues were resolved pragmatically while maintaining architectural integrity and business value.
-
-**Status:** READY FOR PRODUCTION DEPLOYMENT 🚀
-
----
-
-*Generated: 2025-11-08*
-*System: dotnet-cqrs AI Agent Platform*
-*Mode: HTTP-Only (gRPC disabled for ARM64 Mac compatibility)*

QUICK_REFERENCE.md

@@ -1,233 +0,0 @@
-# AI Agent Platform - Quick Reference Card
-
-## 🚀 Quick Start
-
-```bash
-# Start everything
-docker compose up -d
-
-# Check status
-docker compose ps
-
-# View logs
-docker compose logs -f api
-```
-
-## 🔗 Access Points
-
-| Service | URL | Purpose |
-|---------|-----|---------|
-| **API** | http://localhost:6001/swagger | Interactive API docs |
-| **Health** | http://localhost:6001/health | System health check |
-| **Metrics** | http://localhost:6001/metrics | Prometheus metrics |
-| **Langfuse** | http://localhost:3000 | Observability UI |
-| **Ollama** | http://localhost:11434/api/tags | Model info |
-
-## 💡 Common Commands
-
-### Test AI Agent
-```bash
-# Simple test
-echo '{"prompt":"Hello"}' | \
-  curl -s -X POST http://localhost:6001/api/command/executeAgent \
-  -H "Content-Type: application/json" -d @- | jq .
-
-# Math calculation
-echo '{"prompt":"What is 10 plus 5?"}' | \
-  curl -s -X POST http://localhost:6001/api/command/executeAgent \
-  -H "Content-Type: application/json" -d @- | jq .
-```
-
-### Check System Health
-```bash
-# API health
-curl http://localhost:6001/health | jq .
-
-# Ollama status
-curl http://localhost:11434/api/tags | jq '.models[].name'
-
-# Database connection
-docker exec postgres pg_isready -U postgres
-```
-
-### View Logs
-```bash
-# API logs
-docker logs svrnty-api --tail 50 -f
-
-# Ollama logs
-docker logs ollama --tail 50 -f
-
-# Langfuse logs
-docker logs langfuse --tail 50 -f
-
-# All services
-docker compose logs -f
-```
-
-### Database Access
-```bash
-# Connect to PostgreSQL
-docker exec -it postgres psql -U postgres -d svrnty
-
-# List tables
-\dt agent.*
-
-# Query conversations
-SELECT * FROM agent.conversations LIMIT 5;
-
-# Query revenue
-SELECT * FROM agent.revenue ORDER BY year, month;
-```
-
-## 🛠️ Troubleshooting
-
-### Container Won't Start
-```bash
-# Clean restart
-docker compose down -v
-docker compose up -d
-
-# Rebuild API
-docker compose build --no-cache api
-docker compose up -d
-```
-
-### Model Not Loading
-```bash
-# Pull model manually
-docker exec ollama ollama pull qwen2.5-coder:7b
-
-# Check model status
-docker exec ollama ollama list
-```
-
-### Database Issues
-```bash
-# Recreate database
-docker compose down -v
-docker compose up -d
-
-# Run migrations manually
-docker exec svrnty-api dotnet ef database update
-```
-
-## 📊 Monitoring
-
-### Prometheus Metrics
-```bash
-# Get all metrics
-curl http://localhost:6001/metrics
-
-# Filter specific metrics
-curl http://localhost:6001/metrics | grep http_server_request
-```
-
-### Health Checks
-```bash
-# Basic health
-curl http://localhost:6001/health
-
-# Ready check (includes DB)
-curl http://localhost:6001/health/ready
-```
-
-## 🔧 Configuration
-
-### Environment Variables
-Key variables in `docker-compose.yml`:
-- `ASPNETCORE_URLS` - HTTP endpoint (currently: http://+:6001)
-- `OLLAMA_MODEL` - AI model name
-- `CONNECTION_STRING_SVRNTY` - Database connection
-- `LANGFUSE_PUBLIC_KEY` / `LANGFUSE_SECRET_KEY` - Tracing keys
-
-### Files to Edit
-- **API Configuration:** `Svrnty.Sample/appsettings.Production.json`
-- **Container Config:** `docker-compose.yml`
-- **Environment:** `.env` file
-
-## 📝 Current Status
-
-### ✅ Working
-- HTTP API endpoints
-- AI agent with qwen2.5-coder:7b
-- PostgreSQL database
-- Langfuse v2 observability
-- Prometheus metrics
-- Rate limiting (100 req/min)
-- Health checks
-- Swagger documentation
-
-### ⏸️ Temporarily Disabled
-- gRPC endpoints (ARM64 Mac compatibility issue)
-- Port 6000 (gRPC was on this port)
-
-### ⚠️ Known Cosmetic Issues
-- Ollama shows "unhealthy" (but works fine)
-- Langfuse shows "unhealthy" (but works fine)
-- Database migration warning (safe to ignore)
-
-## 🔄 Re-enabling gRPC
-
-When ready to re-enable gRPC:
-
-1. Uncomment in `Svrnty.Sample/Svrnty.Sample.csproj`:
-   - `<Protobuf Include>` section
-   - gRPC package references
-   - gRPC project references
-
-2. Uncomment in `Svrnty.Sample/Program.cs`:
-   - `using Svrnty.CQRS.Grpc;`
-   - Kestrel configuration
-   - `cqrs.AddGrpc()` section
-
-3. Update `docker-compose.yml`:
-   - Uncomment port 6000 mapping
-   - Add gRPC endpoint to ASPNETCORE_URLS
-
-4. Rebuild:
-   ```bash
-   docker compose build --no-cache api
-   docker compose up -d
-   ```
-
-## 📚 Documentation
-
-- **Full Deployment Guide:** `DEPLOYMENT_SUCCESS.md`
-- **Testing Guide:** `TESTING_GUIDE.md`
-- **Project Documentation:** `README.md`
-- **Architecture:** `CLAUDE.md`
-
-## 🎯 Performance
-
-- **Cold start:** ~5 seconds
-- **Health check:** <100ms
-- **Simple queries:** 1-2s
-- **LLM responses:** 5-30s (depends on complexity)
-
-## 🔒 Security
-
-- Rate limiting: 100 requests/minute per client
-- Database credentials: In `.env` file
-- HTTPS: Disabled in current HTTP-only mode
-- Langfuse auth: Basic authentication
-
-## 📞 Quick Help
-
-**Issue:** Container keeps restarting
-**Fix:** Check logs with `docker logs <container-name>`
-
-**Issue:** Can't connect to API
-**Fix:** Verify health: `curl http://localhost:6001/health`
-
-**Issue:** Model not responding
-**Fix:** Check Ollama: `docker exec ollama ollama list`
-
-**Issue:** Database error
-**Fix:** Reset database: `docker compose down -v && docker compose up -d`
-
----
-
-**Last Updated:** 2025-11-08
-**Mode:** HTTP-Only (Production Ready)
-**Status:** ✅ Fully Operational

Svrnty.CQRS.Abstractions/Svrnty.CQRS.Abstractions.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <IsAotCompatible>true</IsAotCompatible>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
     
     <Company>Svrnty</Company>

Svrnty.CQRS.DynamicQuery.Abstractions/Svrnty.CQRS.DynamicQuery.Abstractions.csproj

@@ -3,7 +3,7 @@
     <TargetFrameworks>netstandard2.1;net10.0</TargetFrameworks>
     <IsAotCompatible Condition="$([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'net10.0'))">true</IsAotCompatible>
     <Nullable>enable</Nullable>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     
     <Company>Svrnty</Company>
     <Authors>David Lebee, Mathias Beaulieu-Duncan</Authors>

Svrnty.CQRS.DynamicQuery.MinimalApi/Svrnty.CQRS.DynamicQuery.MinimalApi.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <IsAotCompatible>false</IsAotCompatible>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
     
     <Company>Svrnty</Company>

Svrnty.CQRS.DynamicQuery/Svrnty.CQRS.DynamicQuery.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <IsAotCompatible>true</IsAotCompatible>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
     
     <Company>Svrnty</Company>

Svrnty.CQRS.FluentValidation/Svrnty.CQRS.FluentValidation.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <IsAotCompatible>true</IsAotCompatible>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
     
     <Company>Svrnty</Company>

Svrnty.CQRS.Grpc.Abstractions/Svrnty.CQRS.Grpc.Abstractions.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <IsAotCompatible>true</IsAotCompatible>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
 
     <Company>Svrnty</Company>

Svrnty.CQRS.Grpc.Generators/Svrnty.CQRS.Grpc.Generators.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <TargetFramework>netstandard2.0</TargetFramework>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
     <IsRoslynComponent>true</IsRoslynComponent>
     <EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>

Svrnty.CQRS.Grpc/Svrnty.CQRS.Grpc.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <IsAotCompatible>false</IsAotCompatible>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
     
     <Company>Svrnty</Company>

Svrnty.CQRS.MinimalApi/Svrnty.CQRS.MinimalApi.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <IsAotCompatible>false</IsAotCompatible>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
     
     <Company>Svrnty</Company>

Svrnty.CQRS/Svrnty.CQRS.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <IsAotCompatible>true</IsAotCompatible>
-    <LangVersion>preview</LangVersion>
+    <LangVersion>14</LangVersion>
     <Nullable>enable</Nullable>
     
     <Company>Svrnty</Company>

Svrnty.Sample/Program.cs

@@ -10,8 +10,7 @@ using OpenTelemetry.Resources;
 using OpenTelemetry.Trace;
 using Svrnty.CQRS;
 using Svrnty.CQRS.FluentValidation;
-// Temporarily disabled gRPC (ARM64 Mac build issues)
+using Svrnty.CQRS.Grpc;
-// using Svrnty.CQRS.Grpc;
 using Svrnty.Sample;
 using Svrnty.Sample.AI;
 using Svrnty.Sample.AI.Commands;
@@ -23,16 +22,14 @@ using Svrnty.CQRS.Abstractions;
 
 var builder = WebApplication.CreateBuilder(args);
 
-// Temporarily disabled gRPC configuration (ARM64 Mac build issues)
+// Configure Kestrel to support both HTTP/1.1 (for REST APIs) and HTTP/2 (for gRPC)
-// Using ASPNETCORE_URLS environment variable for endpoint configuration instead of Kestrel
-// This avoids HTTPS certificate issues in Docker
-/*
 builder.WebHost.ConfigureKestrel(options =>
 {
+    // Port 6000: HTTP/2 for gRPC
+    options.ListenLocalhost(6000, o => o.Protocols = HttpProtocols.Http2);
     // Port 6001: HTTP/1.1 for HTTP API
     options.ListenLocalhost(6001, o => o.Protocols = HttpProtocols.Http1);
 });
-*/
 
 // Configure Database
 var connectionString = builder.Configuration.GetConnectionString("DefaultConnection")
@@ -153,14 +150,11 @@ builder.Services.AddCommand<ExecuteAgentCommand, AgentResponse, ExecuteAgentComm
 // Configure CQRS with fluent API
 builder.Services.AddSvrntyCqrs(cqrs =>
 {
-    // Temporarily disabled gRPC (ARM64 Mac build issues)
-    /*
     // Enable gRPC endpoints with reflection
     cqrs.AddGrpc(grpc =>
     {
         grpc.EnableReflection();
     });
-    */
 
     // Enable MinimalApi endpoints
     cqrs.AddMinimalApi(configure =>
@@ -211,14 +205,14 @@ app.MapHealthChecks("/health/ready", new Microsoft.AspNetCore.Diagnostics.Health
     Predicate = check => check.Tags.Contains("ready")
 });
 
-Console.WriteLine("Production-Ready AI Agent with Full Observability (HTTP-Only Mode)");
+Console.WriteLine("Production-Ready AI Agent with Full Observability");
 Console.WriteLine("═══════════════════════════════════════════════════════════");
-Console.WriteLine("HTTP API:           http://localhost:6001/api/command/* and /api/query/*");
+Console.WriteLine("gRPC (HTTP/2):      http://localhost:6000");
+Console.WriteLine("HTTP API (HTTP/1.1): http://localhost:6001/api/command/* and /api/query/*");
 Console.WriteLine("Swagger UI:         http://localhost:6001/swagger");
 Console.WriteLine("Prometheus Metrics: http://localhost:6001/metrics");
 Console.WriteLine("Health Check:       http://localhost:6001/health");
 Console.WriteLine("═══════════════════════════════════════════════════════════");
-Console.WriteLine("Note: gRPC temporarily disabled (ARM64 Mac build issues)");
 Console.WriteLine($"Rate Limiting: 100 requests/minute per client");
 Console.WriteLine($"Langfuse Tracing: {(!string.IsNullOrEmpty(langfusePublicKey) ? "Enabled" : "Disabled (configure keys in .env)")}");
 Console.WriteLine("═══════════════════════════════════════════════════════════");

Svrnty.Sample/Svrnty.Sample.csproj

@@ -8,18 +8,12 @@
     <CompilerGeneratedFilesOutputPath>$(BaseIntermediateOutputPath)Generated</CompilerGeneratedFilesOutputPath>
   </PropertyGroup>
 
-  <!-- Temporarily disabled gRPC due to ARM64 Mac build issues with Grpc.Tools -->
-  <!-- Uncomment when gRPC support is needed -->
-  <!--
   <ItemGroup>
     <Protobuf Include="Protos\*.proto" GrpcServices="Server" />
   </ItemGroup>
-  -->
 
   <ItemGroup>
     <PackageReference Include="AspNetCore.HealthChecks.NpgSql" Version="9.0.0" />
-    <!-- Temporarily disabled gRPC packages (ARM64 Mac build issues) -->
-    <!--
     <PackageReference Include="Grpc.AspNetCore" Version="2.71.0" />
     <PackageReference Include="Grpc.AspNetCore.Server.Reflection" Version="2.71.0" />
     <PackageReference Include="Grpc.Tools" Version="2.76.0">
@@ -27,7 +21,6 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Grpc.StatusProto" Version="2.71.0" />
-    -->
     <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.0">
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       <PrivateAssets>all</PrivateAssets>
@@ -48,22 +41,16 @@
   <ItemGroup>
     <ProjectReference Include="..\Svrnty.CQRS\Svrnty.CQRS.csproj" />
     <ProjectReference Include="..\Svrnty.CQRS.Abstractions\Svrnty.CQRS.Abstractions.csproj" />
-    <!-- Temporarily disabled gRPC project references (ARM64 Mac build issues) -->
-    <!--
     <ProjectReference Include="..\Svrnty.CQRS.Grpc\Svrnty.CQRS.Grpc.csproj" />
     <ProjectReference Include="..\Svrnty.CQRS.Grpc.Generators\Svrnty.CQRS.Grpc.Generators.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="false" />
-    -->
     <ProjectReference Include="..\Svrnty.CQRS.FluentValidation\Svrnty.CQRS.FluentValidation.csproj" />
     <ProjectReference Include="..\Svrnty.CQRS.MinimalApi\Svrnty.CQRS.MinimalApi.csproj" />
     <ProjectReference Include="..\Svrnty.CQRS.DynamicQuery\Svrnty.CQRS.DynamicQuery.csproj" />
     <ProjectReference Include="..\Svrnty.CQRS.DynamicQuery.MinimalApi\Svrnty.CQRS.DynamicQuery.MinimalApi.csproj" />
-    <!-- Keep abstractions for attributes like [GrpcIgnore] -->
     <ProjectReference Include="..\Svrnty.CQRS.Grpc.Abstractions\Svrnty.CQRS.Grpc.Abstractions.csproj" />
   </ItemGroup>
 
-  <!-- Temporarily disabled gRPC proto generation targets (ARM64 Mac build issues) -->
+  <!-- Import the proto generation targets for testing (in production this would come from the NuGet package) -->
-  <!--
   <Import Project="..\Svrnty.CQRS.Grpc.Generators\build\Svrnty.CQRS.Grpc.Generators.targets" />
-  -->
 
 </Project>

Svrnty.Sample/appsettings.Production.json

@@ -18,5 +18,17 @@
     "PublicKey": "",
     "SecretKey": "",
     "OtlpEndpoint": "http://langfuse:3000/api/public/otel/v1/traces"
+  },
+  "Kestrel": {
+    "Endpoints": {
+      "Grpc": {
+        "Url": "http://0.0.0.0:6000",
+        "Protocols": "Http2"
+      },
+      "Http": {
+        "Url": "http://0.0.0.0:6001",
+        "Protocols": "Http1"
+      }
+    }
   }
 }

Svrnty.Sample/appsettings.json

@@ -9,12 +9,16 @@
   "Kestrel": {
     "Endpoints": {
       "Http": {
-        "Url": "http://localhost:6001",
+        "Url": "http://localhost:5000",
-        "Protocols": "Http1"
+        "Protocols": "Http2"
+      },
+      "Https": {
+        "Url": "https://localhost:5001",
+        "Protocols": "Http2"
       }
     },
     "EndpointDefaults": {
-      "Protocols": "Http1"
+      "Protocols": "Http2"
     }
   }
 }

TESTING_GUIDE.md

@@ -1,389 +0,0 @@
-# Production Stack Testing Guide
-
-This guide provides instructions for testing your AI Agent production stack after resolving the Docker build issues.
-
-## Current Status
-
-**Build Status:** ❌ Failed at ~95%
-**Issue:** gRPC source generator task (`WriteProtoFileTask`) not found in .NET 10 preview SDK
-**Location:** `Svrnty.CQRS.Grpc.Generators`
-
-## Build Issues to Resolve
-
-### Issue 1: gRPC Generator Compatibility
-```
-error MSB4036: The "WriteProtoFileTask" task was not found
-```
-
-**Possible Solutions:**
-1. **Skip gRPC for Docker build:** Temporarily remove gRPC dependency from `Svrnty.Sample/Svrnty.Sample.csproj`
-2. **Use different .NET SDK:** Try .NET 9 or stable .NET 8 instead of .NET 10 preview
-3. **Fix the gRPC generator:** Update `Svrnty.CQRS.Grpc.Generators` to work with .NET 10 preview SDK
-
-### Quick Fix: Disable gRPC for Testing
-
-Edit `Svrnty.Sample/Svrnty.Sample.csproj` and comment out:
-```xml
-<!-- Temporarily disabled for Docker build -->
-<!-- <ProjectReference Include="..\Svrnty.CQRS.Grpc\Svrnty.CQRS.Grpc.csproj" /> -->
-```
-
-Then rebuild:
-```bash
-docker compose up -d --build
-```
-
-## Once Build Succeeds
-
-### Step 1: Start the Stack
-```bash
-# From project root
-docker compose up -d
-
-# Wait for services to start (2-3 minutes)
-docker compose ps
-```
-
-### Step 2: Verify Services
-```bash
-# Check all services are running
-docker compose ps
-
-# Should show:
-# api       Up      0.0.0.0:6000-6001->6000-6001/tcp
-# postgres  Up      5432/tcp
-# ollama    Up      11434/tcp
-# langfuse  Up      3000/tcp
-```
-
-### Step 3: Pull Ollama Model (One-time)
-```bash
-docker exec ollama ollama pull qwen2.5-coder:7b
-# This downloads ~6.7GB, takes 5-10 minutes
-```
-
-### Step 4: Configure Langfuse (One-time)
-1. Open http://localhost:3000
-2. Create account (first-time setup)
-3. Create a project (e.g., "AI Agent")
-4. Go to Settings → API Keys
-5. Copy the Public and Secret keys
-6. Update `.env`:
-   ```bash
-   LANGFUSE_PUBLIC_KEY=pk-lf-...
-   LANGFUSE_SECRET_KEY=sk-lf-...
-   ```
-7. Restart API to enable tracing:
-   ```bash
-   docker compose restart api
-   ```
-
-### Step 5: Run Comprehensive Tests
-```bash
-# Execute the full test suite
-./test-production-stack.sh
-```
-
-## Test Suite Overview
-
-The `test-production-stack.sh` script runs **7 comprehensive test phases**:
-
-### Phase 1: Functional Testing (15 min)
-- ✓ Health endpoint checks (API, Langfuse, Ollama, PostgreSQL)
-- ✓ Agent math operations (simple and complex)
-- ✓ Database queries (revenue, customers)
-- ✓ Multi-turn conversations
-
-**Tests:** 9 tests
-**What it validates:** Core agent functionality and service connectivity
-
-### Phase 2: Rate Limiting (5 min)
-- ✓ Rate limit enforcement (100 req/min)
-- ✓ HTTP 429 responses when exceeded
-- ✓ Rate limit headers present
-- ✓ Queue behavior (10 req queue depth)
-
-**Tests:** 2 tests
-**What it validates:** API protection and rate limiter configuration
-
-### Phase 3: Observability (10 min)
-- ✓ Langfuse trace generation
-- ✓ Prometheus metrics collection
-- ✓ HTTP request/response metrics
-- ✓ Function call tracking
-- ✓ Request counting accuracy
-
-**Tests:** 4 tests
-**What it validates:** Monitoring and debugging capabilities
-
-### Phase 4: Load Testing (5 min)
-- ✓ Concurrent request handling (20 parallel requests)
-- ✓ Sustained load (30 seconds, 2 req/sec)
-- ✓ Performance under stress
-- ✓ Response time consistency
-
-**Tests:** 2 tests
-**What it validates:** Production-level performance and scalability
-
-### Phase 5: Database Persistence (5 min)
-- ✓ Conversation storage in PostgreSQL
-- ✓ Conversation ID generation
-- ✓ Seed data integrity (revenue, customers)
-- ✓ Database query accuracy
-
-**Tests:** 4 tests
-**What it validates:** Data persistence and reliability
-
-### Phase 6: Error Handling & Recovery (10 min)
-- ✓ Invalid request handling (400/422 responses)
-- ✓ Service restart recovery
-- ✓ Graceful error messages
-- ✓ Database connection resilience
-
-**Tests:** 2 tests
-**What it validates:** Production readiness and fault tolerance
-
-### Total: ~50 minutes, 23+ tests
-
-## Manual Testing Examples
-
-### Test 1: Simple Math
-```bash
-curl -X POST http://localhost:6001/api/command/executeAgent \
-  -H "Content-Type: application/json" \
-  -d '{"prompt":"What is 5 + 3?"}'
-```
-
-**Expected Response:**
-```json
-{
-  "conversationId": "uuid-here",
-  "success": true,
-  "response": "The result of 5 + 3 is 8."
-}
-```
-
-### Test 2: Database Query
-```bash
-curl -X POST http://localhost:6001/api/command/executeAgent \
-  -H "Content-Type: application/json" \
-  -d '{"prompt":"What was our revenue in January 2025?"}'
-```
-
-**Expected Response:**
-```json
-{
-  "conversationId": "uuid-here",
-  "success": true,
-  "response": "The revenue for January 2025 was $245,000."
-}
-```
-
-### Test 3: Rate Limiting
-```bash
-# Send 110 requests quickly
-for i in {1..110}; do
-  curl -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"test"}' &
-done
-wait
-
-# First 100 succeed, next 10 queue, remaining get HTTP 429
-```
-
-### Test 4: Check Metrics
-```bash
-curl http://localhost:6001/metrics | grep http_server_request_duration
-```
-
-**Expected Output:**
-```
-http_server_request_duration_seconds_count{...} 150
-http_server_request_duration_seconds_sum{...} 45.2
-```
-
-### Test 5: View Traces in Langfuse
-1. Open http://localhost:3000/traces
-2. Click on a trace to see:
-   - Agent execution span (root)
-   - Tool registration span
-   - LLM completion spans
-   - Function call spans (Add, DatabaseQuery, etc.)
-   - Timing breakdown
-
-## Test Results Interpretation
-
-### Success Criteria
-- **>90% pass rate:** Production ready
-- **80-90% pass rate:** Minor issues to address
-- **<80% pass rate:** Significant issues, not production ready
-
-### Common Test Failures
-
-#### Failure: "Agent returned error or timeout"
-**Cause:** Ollama model not pulled or API not responding
-**Fix:**
-```bash
-docker exec ollama ollama pull qwen2.5-coder:7b
-docker compose restart api
-```
-
-#### Failure: "Service not running"
-**Cause:** Docker container failed to start
-**Fix:**
-```bash
-docker compose logs [service-name]
-docker compose up -d [service-name]
-```
-
-#### Failure: "No rate limit headers found"
-**Cause:** Rate limiter not configured
-**Fix:** Check `Program.cs:Svrnty.Sample/Program.cs:92-96` for rate limiter setup
-
-#### Failure: "Traces not visible in Langfuse"
-**Cause:** Langfuse keys not configured in `.env`
-**Fix:** Follow Step 4 above to configure API keys
-
-## Accessing Logs
-
-### API Logs
-```bash
-docker compose logs -f api
-```
-
-### All Services
-```bash
-docker compose logs -f
-```
-
-### Filter for Errors
-```bash
-docker compose logs | grep -i error
-```
-
-## Stopping the Stack
-
-```bash
-# Stop all services
-docker compose down
-
-# Stop and remove volumes (clean slate)
-docker compose down -v
-```
-
-## Troubleshooting
-
-### Issue: Ollama Out of Memory
-**Symptoms:** Agent responses timeout or return errors
-**Solution:**
-```bash
-# Increase Docker memory limit to 8GB+
-# Docker Desktop → Settings → Resources → Memory
-docker compose restart ollama
-```
-
-### Issue: PostgreSQL Connection Failed
-**Symptoms:** Database queries fail
-**Solution:**
-```bash
-docker compose logs postgres
-# Check for port conflicts or permission issues
-docker compose down -v
-docker compose up -d
-```
-
-### Issue: Langfuse Not Showing Traces
-**Symptoms:** Metrics work but no traces in UI
-**Solution:**
-1. Verify keys in `.env` match Langfuse UI
-2. Check API logs for OTLP export errors:
-   ```bash
-   docker compose logs api | grep -i "otlp\|langfuse"
-   ```
-3. Restart API after updating keys:
-   ```bash
-   docker compose restart api
-   ```
-
-### Issue: Port Already in Use
-**Symptoms:** `docker compose up` fails with "port already allocated"
-**Solution:**
-```bash
-# Find what's using the port
-lsof -i :6001   # API HTTP
-lsof -i :6000   # API gRPC
-lsof -i :5432   # PostgreSQL
-lsof -i :3000   # Langfuse
-
-# Kill the process or change ports in docker-compose.yml
-```
-
-## Performance Expectations
-
-### Response Times
-- **Simple Math:** 1-2 seconds
-- **Database Query:** 2-3 seconds
-- **Complex Multi-step:** 3-5 seconds
-
-### Throughput
-- **Rate Limit:** 100 requests/minute
-- **Queue Depth:** 10 requests
-- **Concurrent Connections:** 20+ supported
-
-### Resource Usage
-- **Memory:** ~4GB total (Ollama ~3GB, others ~1GB)
-- **CPU:** Variable based on query complexity
-- **Disk:** ~10GB (Ollama model + Docker images)
-
-## Production Deployment Checklist
-
-Before deploying to production:
-
-- [ ] All tests passing (>90% success rate)
-- [ ] Langfuse API keys configured
-- [ ] PostgreSQL credentials rotated
-- [ ] Rate limits tuned for expected traffic
-- [ ] Health checks validated
-- [ ] Metrics dashboards created
-- [ ] Alert rules configured
-- [ ] Backup strategy implemented
-- [ ] Secrets in environment variables (not code)
-- [ ] Network policies configured
-- [ ] TLS certificates installed (for HTTPS)
-- [ ] Load balancer configured (if multi-instance)
-
-## Next Steps After Testing
-
-1. **Review test results:** Identify any failures and fix root causes
-2. **Tune rate limits:** Adjust based on expected production traffic
-3. **Create dashboards:** Build Grafana dashboards from Prometheus metrics
-4. **Set up alerts:** Configure alerting for:
-   - API health check failures
-   - High error rates (>5%)
-   - High latency (P95 >5s)
-   - Database connection failures
-5. **Optimize Ollama:** Fine-tune model parameters for your use case
-6. **Scale testing:** Test with higher concurrency (50-100 parallel)
-7. **Security audit:** Review authentication, authorization, input validation
-
-## Support Resources
-
-- **Project README:** [README.md](./README.md)
-- **Deployment Guide:** [DEPLOYMENT_README.md](./DEPLOYMENT_README.md)
-- **Docker Compose:** [docker-compose.yml](./docker-compose.yml)
-- **Test Script:** [test-production-stack.sh](./test-production-stack.sh)
-
-## Getting Help
-
-If tests fail or you encounter issues:
-1. Check logs: `docker compose logs -f`
-2. Review this guide's troubleshooting section
-3. Verify all prerequisites are met
-4. Check for port conflicts or resource constraints
-
----
-
-**Test Script Version:** 1.0
-**Last Updated:** 2025-11-08
-**Estimated Total Test Time:** ~50 minutes

docker-compose.yml

@@ -1,3 +1,5 @@
+version: '3.9'
+
 services:
   # === .NET AI AGENT API ===
   api:
@@ -6,15 +8,11 @@ services:
       dockerfile: Dockerfile
     container_name: svrnty-api
     ports:
-      # Temporarily disabled gRPC (ARM64 Mac build issues)
+      - "6000:6000"  # gRPC
-      # - "6000:6000"  # gRPC
       - "6001:6001"  # HTTP
     environment:
       - ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT:-Production}
-      # HTTP-only mode (gRPC temporarily disabled)
+      - ASPNETCORE_URLS=${ASPNETCORE_URLS:-http://+:6001;http://+:6000}
-      - ASPNETCORE_URLS=http://+:6001
-      - ASPNETCORE_HTTPS_PORTS=
-      - ASPNETCORE_HTTP_PORTS=6001
       - ConnectionStrings__DefaultConnection=${CONNECTION_STRING_SVRNTY}
       - Ollama__BaseUrl=${OLLAMA_BASE_URL}
       - Ollama__Model=${OLLAMA_MODEL}
@@ -60,8 +58,7 @@ services:
 
   # === LANGFUSE OBSERVABILITY ===
   langfuse:
-    # Using v2 - v3 requires ClickHouse which adds complexity
+    image: langfuse/langfuse:latest
-    image: langfuse/langfuse:2
     container_name: langfuse
     ports:
       - "3000:3000"

test-production-stack.sh

@@ -1,510 +0,0 @@
-#!/bin/bash
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# AI Agent Production Stack - Comprehensive Test Suite
-# ═══════════════════════════════════════════════════════════════════════════════
-
-set -e  # Exit on error
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Counters
-TOTAL_TESTS=0
-PASSED_TESTS=0
-FAILED_TESTS=0
-
-# Test results array
-declare -a TEST_RESULTS
-
-# Function to print section header
-print_header() {
-    echo ""
-    echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}"
-    echo -e "${BLUE}  $1${NC}"
-    echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}"
-    echo ""
-}
-
-# Function to print test result
-print_test() {
-    local name="$1"
-    local status="$2"
-    local message="$3"
-
-    TOTAL_TESTS=$((TOTAL_TESTS + 1))
-
-    if [ "$status" = "PASS" ]; then
-        echo -e "${GREEN}✓${NC} $name"
-        PASSED_TESTS=$((PASSED_TESTS + 1))
-        TEST_RESULTS+=("PASS: $name")
-    else
-        echo -e "${RED}✗${NC} $name - $message"
-        FAILED_TESTS=$((FAILED_TESTS + 1))
-        TEST_RESULTS+=("FAIL: $name - $message")
-    fi
-}
-
-# Function to check HTTP endpoint
-check_http() {
-    local url="$1"
-    local expected_code="${2:-200}"
-
-    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$url" 2>/dev/null || echo "000")
-
-    if [ "$HTTP_CODE" = "$expected_code" ]; then
-        return 0
-    else
-        return 1
-    fi
-}
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# PRE-FLIGHT CHECKS
-# ═══════════════════════════════════════════════════════════════════════════════
-
-print_header "PRE-FLIGHT CHECKS"
-
-# Check Docker services
-echo "Checking Docker services..."
-SERVICES=("api" "postgres" "ollama" "langfuse")
-
-for service in "${SERVICES[@]}"; do
-    if docker compose ps "$service" 2>/dev/null | grep -q "Up"; then
-        print_test "Docker service: $service" "PASS"
-    else
-        print_test "Docker service: $service" "FAIL" "Service not running"
-    fi
-done
-
-# Wait for services to be ready
-echo ""
-echo "Waiting for services to be ready..."
-sleep 5
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# PHASE 1: FUNCTIONAL TESTING
-# ═══════════════════════════════════════════════════════════════════════════════
-
-print_header "PHASE 1: FUNCTIONAL TESTING (Health Checks & Agent Queries)"
-
-# Test 1.1: API Health Check
-if check_http "http://localhost:6001/health" 200; then
-    print_test "API Health Endpoint" "PASS"
-else
-    print_test "API Health Endpoint" "FAIL" "HTTP $HTTP_CODE"
-fi
-
-# Test 1.2: API Readiness Check
-if check_http "http://localhost:6001/health/ready" 200; then
-    print_test "API Readiness Endpoint" "PASS"
-else
-    print_test "API Readiness Endpoint" "FAIL" "HTTP $HTTP_CODE"
-fi
-
-# Test 1.3: Prometheus Metrics Endpoint
-if check_http "http://localhost:6001/metrics" 200; then
-    print_test "Prometheus Metrics Endpoint" "PASS"
-else
-    print_test "Prometheus Metrics Endpoint" "FAIL" "HTTP $HTTP_CODE"
-fi
-
-# Test 1.4: Langfuse Health
-if check_http "http://localhost:3000/api/public/health" 200; then
-    print_test "Langfuse Health Endpoint" "PASS"
-else
-    print_test "Langfuse Health Endpoint" "FAIL" "HTTP $HTTP_CODE"
-fi
-
-# Test 1.5: Ollama API
-if check_http "http://localhost:11434/api/tags" 200; then
-    print_test "Ollama API Endpoint" "PASS"
-else
-    print_test "Ollama API Endpoint" "FAIL" "HTTP $HTTP_CODE"
-fi
-
-# Test 1.6: Math Operation (Simple)
-echo ""
-echo "Testing agent with math operation..."
-RESPONSE=$(curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"What is 5 + 3?"}' 2>/dev/null)
-
-if echo "$RESPONSE" | grep -q '"success":true'; then
-    print_test "Agent Math Query (5 + 3)" "PASS"
-else
-    print_test "Agent Math Query (5 + 3)" "FAIL" "Agent returned error or timeout"
-fi
-
-# Test 1.7: Math Operation (Complex)
-echo "Testing agent with complex math..."
-RESPONSE=$(curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"Calculate (5 + 3) multiplied by 2"}' 2>/dev/null)
-
-if echo "$RESPONSE" | grep -q '"success":true'; then
-    print_test "Agent Complex Math Query" "PASS"
-else
-    print_test "Agent Complex Math Query" "FAIL" "Agent returned error or timeout"
-fi
-
-# Test 1.8: Database Query
-echo "Testing agent with database query..."
-RESPONSE=$(curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"What was our revenue in January 2025?"}' 2>/dev/null)
-
-if echo "$RESPONSE" | grep -q '"success":true'; then
-    print_test "Agent Database Query (Revenue)" "PASS"
-else
-    print_test "Agent Database Query (Revenue)" "FAIL" "Agent returned error or timeout"
-fi
-
-# Test 1.9: Customer Query
-echo "Testing agent with customer query..."
-RESPONSE=$(curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"How many Enterprise customers do we have?"}' 2>/dev/null)
-
-if echo "$RESPONSE" | grep -q '"success":true'; then
-    print_test "Agent Customer Query" "PASS"
-else
-    print_test "Agent Customer Query" "FAIL" "Agent returned error or timeout"
-fi
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# PHASE 2: RATE LIMITING TESTING
-# ═══════════════════════════════════════════════════════════════════════════════
-
-print_header "PHASE 2: RATE LIMITING TESTING"
-
-echo "Testing rate limit (100 req/min)..."
-echo "Sending 110 requests in parallel..."
-
-SUCCESS=0
-RATE_LIMITED=0
-
-for i in {1..110}; do
-    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:6001/api/command/executeAgent \
-        -H "Content-Type: application/json" \
-        -d "{\"prompt\":\"test $i\"}" 2>/dev/null) &
-
-    if [ "$HTTP_CODE" = "200" ]; then
-        SUCCESS=$((SUCCESS + 1))
-    elif [ "$HTTP_CODE" = "429" ]; then
-        RATE_LIMITED=$((RATE_LIMITED + 1))
-    fi
-done
-
-wait
-
-echo ""
-echo "Results: $SUCCESS successful, $RATE_LIMITED rate-limited"
-
-if [ "$RATE_LIMITED" -gt 0 ]; then
-    print_test "Rate Limiting Enforcement" "PASS"
-else
-    print_test "Rate Limiting Enforcement" "FAIL" "No requests were rate-limited (expected some 429s)"
-fi
-
-# Test rate limit headers
-RESPONSE_HEADERS=$(curl -sI -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"test"}' 2>/dev/null)
-
-if echo "$RESPONSE_HEADERS" | grep -qi "RateLimit"; then
-    print_test "Rate Limit Headers Present" "PASS"
-else
-    print_test "Rate Limit Headers Present" "FAIL" "No rate limit headers found"
-fi
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# PHASE 3: OBSERVABILITY TESTING
-# ═══════════════════════════════════════════════════════════════════════════════
-
-print_header "PHASE 3: OBSERVABILITY TESTING"
-
-# Generate test traces
-echo "Generating diverse traces for Langfuse..."
-
-# Simple query
-curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"Hello"}' > /dev/null 2>&1
-
-# Function call
-curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"What is 42 * 17?"}' > /dev/null 2>&1
-
-# Database query
-curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"Show revenue for March 2025"}' > /dev/null 2>&1
-
-sleep 2  # Allow traces to be exported
-
-print_test "Trace Generation" "PASS"
-echo "  ${YELLOW}→${NC} Check traces at: http://localhost:3000/traces"
-
-# Test Prometheus metrics
-METRICS=$(curl -s http://localhost:6001/metrics 2>/dev/null)
-
-if echo "$METRICS" | grep -q "http_server_request_duration_seconds"; then
-    print_test "Prometheus HTTP Metrics" "PASS"
-else
-    print_test "Prometheus HTTP Metrics" "FAIL" "Metrics not found"
-fi
-
-if echo "$METRICS" | grep -q "http_client_request_duration_seconds"; then
-    print_test "Prometheus HTTP Client Metrics" "PASS"
-else
-    print_test "Prometheus HTTP Client Metrics" "FAIL" "Metrics not found"
-fi
-
-# Check if metrics show actual requests
-REQUEST_COUNT=$(echo "$METRICS" | grep "http_server_request_duration_seconds_count" | head -1 | awk '{print $NF}')
-if [ -n "$REQUEST_COUNT" ] && [ "$REQUEST_COUNT" -gt 0 ]; then
-    print_test "Metrics Recording Requests" "PASS"
-    echo "  ${YELLOW}→${NC} Total requests recorded: $REQUEST_COUNT"
-else
-    print_test "Metrics Recording Requests" "FAIL" "No requests recorded in metrics"
-fi
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# PHASE 4: LOAD TESTING
-# ═══════════════════════════════════════════════════════════════════════════════
-
-print_header "PHASE 4: LOAD TESTING"
-
-echo "Running concurrent request test (20 requests)..."
-
-START_TIME=$(date +%s)
-CONCURRENT_SUCCESS=0
-CONCURRENT_FAIL=0
-
-for i in {1..20}; do
-    (
-        RESPONSE=$(curl -s -X POST http://localhost:6001/api/command/executeAgent \
-            -H "Content-Type: application/json" \
-            -d "{\"prompt\":\"Calculate $i + $i\"}" 2>/dev/null)
-
-        if echo "$RESPONSE" | grep -q '"success":true'; then
-            echo "success" >> /tmp/load_test_results.txt
-        else
-            echo "fail" >> /tmp/load_test_results.txt
-        fi
-    ) &
-done
-
-wait
-
-END_TIME=$(date +%s)
-DURATION=$((END_TIME - START_TIME))
-
-if [ -f /tmp/load_test_results.txt ]; then
-    CONCURRENT_SUCCESS=$(grep -c "success" /tmp/load_test_results.txt 2>/dev/null || echo "0")
-    CONCURRENT_FAIL=$(grep -c "fail" /tmp/load_test_results.txt 2>/dev/null || echo "0")
-    rm /tmp/load_test_results.txt
-fi
-
-echo ""
-echo "Results: $CONCURRENT_SUCCESS successful, $CONCURRENT_FAIL failed (${DURATION}s)"
-
-if [ "$CONCURRENT_SUCCESS" -ge 15 ]; then
-    print_test "Concurrent Load Handling (20 requests)" "PASS"
-else
-    print_test "Concurrent Load Handling (20 requests)" "FAIL" "Only $CONCURRENT_SUCCESS succeeded"
-fi
-
-# Sustained load test (30 seconds)
-echo ""
-echo "Running sustained load test (30 seconds, 2 req/sec)..."
-
-START_TIME=$(date +%s)
-END_TIME=$((START_TIME + 30))
-SUSTAINED_SUCCESS=0
-SUSTAINED_FAIL=0
-
-while [ $(date +%s) -lt $END_TIME ]; do
-    RESPONSE=$(curl -s -X POST http://localhost:6001/api/command/executeAgent \
-        -H "Content-Type: application/json" \
-        -d '{"prompt":"What is 2 + 2?"}' 2>/dev/null)
-
-    if echo "$RESPONSE" | grep -q '"success":true'; then
-        SUSTAINED_SUCCESS=$((SUSTAINED_SUCCESS + 1))
-    else
-        SUSTAINED_FAIL=$((SUSTAINED_FAIL + 1))
-    fi
-
-    sleep 0.5
-done
-
-TOTAL_SUSTAINED=$((SUSTAINED_SUCCESS + SUSTAINED_FAIL))
-SUCCESS_RATE=$(awk "BEGIN {printf \"%.1f\", ($SUSTAINED_SUCCESS / $TOTAL_SUSTAINED) * 100}")
-
-echo ""
-echo "Results: $SUSTAINED_SUCCESS/$TOTAL_SUSTAINED successful (${SUCCESS_RATE}%)"
-
-if [ "$SUCCESS_RATE" > "90" ]; then
-    print_test "Sustained Load Handling (30s)" "PASS"
-else
-    print_test "Sustained Load Handling (30s)" "FAIL" "Success rate: ${SUCCESS_RATE}%"
-fi
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# PHASE 5: DATABASE PERSISTENCE TESTING
-# ═══════════════════════════════════════════════════════════════════════════════
-
-print_header "PHASE 5: DATABASE PERSISTENCE TESTING"
-
-# Test conversation persistence
-echo "Testing conversation persistence..."
-RESPONSE=$(curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"prompt":"Remember that my favorite number is 42"}' 2>/dev/null)
-
-if echo "$RESPONSE" | grep -q '"conversationId"'; then
-    CONV_ID=$(echo "$RESPONSE" | grep -o '"conversationId":"[^"]*"' | cut -d'"' -f4)
-    print_test "Conversation Creation" "PASS"
-    echo "  ${YELLOW}→${NC} Conversation ID: $CONV_ID"
-
-    # Verify in database
-    DB_CHECK=$(docker exec postgres psql -U postgres -d svrnty -t -c \
-        "SELECT COUNT(*) FROM agent.conversations WHERE id='$CONV_ID';" 2>/dev/null | tr -d ' ')
-
-    if [ "$DB_CHECK" = "1" ]; then
-        print_test "Conversation DB Persistence" "PASS"
-    else
-        print_test "Conversation DB Persistence" "FAIL" "Not found in database"
-    fi
-else
-    print_test "Conversation Creation" "FAIL" "No conversation ID returned"
-fi
-
-# Verify seed data
-echo ""
-echo "Verifying seed data..."
-
-REVENUE_COUNT=$(docker exec postgres psql -U postgres -d svrnty -t -c \
-    "SELECT COUNT(*) FROM agent.revenues;" 2>/dev/null | tr -d ' ')
-
-if [ "$REVENUE_COUNT" -gt 0 ]; then
-    print_test "Revenue Seed Data" "PASS"
-    echo "  ${YELLOW}→${NC} Revenue records: $REVENUE_COUNT"
-else
-    print_test "Revenue Seed Data" "FAIL" "No revenue data found"
-fi
-
-CUSTOMER_COUNT=$(docker exec postgres psql -U postgres -d svrnty -t -c \
-    "SELECT COUNT(*) FROM agent.customers;" 2>/dev/null | tr -d ' ')
-
-if [ "$CUSTOMER_COUNT" -gt 0 ]; then
-    print_test "Customer Seed Data" "PASS"
-    echo "  ${YELLOW}→${NC} Customer records: $CUSTOMER_COUNT"
-else
-    print_test "Customer Seed Data" "FAIL" "No customer data found"
-fi
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# PHASE 6: ERROR HANDLING & RECOVERY TESTING
-# ═══════════════════════════════════════════════════════════════════════════════
-
-print_header "PHASE 6: ERROR HANDLING & RECOVERY TESTING"
-
-# Test graceful error handling
-echo "Testing invalid request handling..."
-RESPONSE=$(curl -s -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"invalid":"json structure"}' 2>/dev/null)
-
-HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:6001/api/command/executeAgent \
-    -H "Content-Type: application/json" \
-    -d '{"invalid":"json structure"}' 2>/dev/null)
-
-if [ "$HTTP_CODE" = "400" ] || [ "$HTTP_CODE" = "422" ]; then
-    print_test "Invalid Request Handling" "PASS"
-else
-    print_test "Invalid Request Handling" "FAIL" "Expected 400/422, got $HTTP_CODE"
-fi
-
-# Test service restart capability
-echo ""
-echo "Testing service restart (API)..."
-docker compose restart api > /dev/null 2>&1
-sleep 10  # Wait for restart
-
-if check_http "http://localhost:6001/health" 200; then
-    print_test "Service Restart Recovery" "PASS"
-else
-    print_test "Service Restart Recovery" "FAIL" "Service did not recover"
-fi
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# FINAL REPORT
-# ═══════════════════════════════════════════════════════════════════════════════
-
-print_header "TEST SUMMARY"
-
-echo "Total Tests:  $TOTAL_TESTS"
-echo -e "${GREEN}Passed:       $PASSED_TESTS${NC}"
-echo -e "${RED}Failed:       $FAILED_TESTS${NC}"
-echo ""
-
-SUCCESS_PERCENTAGE=$(awk "BEGIN {printf \"%.1f\", ($PASSED_TESTS / $TOTAL_TESTS) * 100}")
-echo "Success Rate: ${SUCCESS_PERCENTAGE}%"
-
-echo ""
-print_header "ACCESS POINTS"
-
-echo "API Endpoints:"
-echo "  • HTTP API:     http://localhost:6001/api/command/executeAgent"
-echo "  • gRPC API:     http://localhost:6000"
-echo "  • Swagger UI:   http://localhost:6001/swagger"
-echo "  • Health:       http://localhost:6001/health"
-echo "  • Metrics:      http://localhost:6001/metrics"
-echo ""
-echo "Monitoring:"
-echo "  • Langfuse UI:  http://localhost:3000"
-echo "  • Ollama API:   http://localhost:11434"
-echo ""
-
-print_header "PRODUCTION READINESS CHECKLIST"
-
-echo "Infrastructure:"
-if [ "$PASSED_TESTS" -ge $((TOTAL_TESTS * 70 / 100)) ]; then
-    echo -e "  ${GREEN}✓${NC} Docker containerization"
-    echo -e "  ${GREEN}✓${NC} Multi-service orchestration"
-    echo -e "  ${GREEN}✓${NC} Health checks configured"
-else
-    echo -e "  ${YELLOW}⚠${NC} Some infrastructure tests failed"
-fi
-
-echo ""
-echo "Observability:"
-echo -e "  ${GREEN}✓${NC} Prometheus metrics enabled"
-echo -e "  ${GREEN}✓${NC} Langfuse tracing configured"
-echo -e "  ${GREEN}✓${NC} Health endpoints active"
-
-echo ""
-echo "Reliability:"
-echo -e "  ${GREEN}✓${NC} Database persistence"
-echo -e "  ${GREEN}✓${NC} Rate limiting active"
-echo -e "  ${GREEN}✓${NC} Error handling tested"
-
-echo ""
-echo "═══════════════════════════════════════════════════════════"
-echo ""
-
-# Exit with appropriate code
-if [ "$FAILED_TESTS" -eq 0 ]; then
-    echo -e "${GREEN}All tests passed! Stack is production-ready.${NC}"
-    exit 0
-else
-    echo -e "${YELLOW}Some tests failed. Review the report above.${NC}"
-    exit 1
-fi