ln-772-error-handler-setup

Overview

Phase 1: Receive Context

• STACK

  : .NET or Python

• FRAMEWORK

  : ASP.NET Core or FastAPI

• PROJECT_ROOT

  : Project directory path

• ENVIRONMENT

  : Development or Production

• .NET: Grep for

  GlobalExceptionMiddleware

  or

  UseExceptionHandler

• Python: Grep for

  @app.exception_handler

  or

  exception_handlers.py

• If found: Return

  { "status": "skipped" }

Phase 2: Research Error Handling Patterns

MCP ref: "ASP.NET Core global exception handling middleware"
Context7: /dotnet/aspnetcore

MCP ref: "FastAPI exception handlers custom exceptions"
Context7: /tiangolo/fastapi

1. Middleware pipeline positioning
2. Exception type mapping to HTTP status codes
3. ProblemDetails (RFC 7807) format
4. Development vs Production error details
5. Logging integration

Phase 3: Decision Points

Q1: Error Response Format

Q2: Error Detail Level

Q3: Error Taxonomy

VALIDATION_ERROR

UNAUTHORIZED

FORBIDDEN

NOT_FOUND

CONFLICT

INTERNAL_ERROR

Phase 4: Generate Configuration

.NET Output Files

Middleware/GlobalExceptionMiddleware.cs

Exceptions/AppException.cs

Exceptions/ValidationException.cs

Exceptions/NotFoundException.cs

Models/ErrorResponse.cs

1. Use MCP ref to get current ASP.NET Core exception handling patterns
2. Generate GlobalExceptionMiddleware with:
   • Exception type to HTTP status mapping
   • Logging of exceptions
   • ProblemDetails response format
   • Environment-aware detail level
3. Generate custom exception classes

app.UseMiddleware<GlobalExceptionMiddleware>();

Python Output Files

exceptions/app_exceptions.py

exceptions/handlers.py

models/error_response.py

1. Use MCP ref to get current FastAPI exception handling patterns
2. Generate exception handlers with:
   • HTTPException handling
   • Custom AppException handling
   • Validation error handling
   • Request validation error handling
3. Generate custom exception classes

app.add_exception_handler(AppException, app_exception_handler)
app.add_exception_handler(RequestValidationError, validation_exception_handler)

Phase 5: Validate

1. Syntax check:
   • .NET:

     dotnet build --no-restore

   • Python:

     python -m py_compile exceptions/handlers.py

2. Test error handling:
   • Create test endpoint that throws exception
   • Verify error response format
   • Check that stack trace hidden in Production

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "Validation Error",
  "status": 400,
  "detail": "Invalid input data",
  "instance": "/api/users",
  "errors": [
    { "field": "email", "message": "Invalid email format" }
  ],
  "traceId": "abc-123-def-456"
}

Return to Coordinator

{
  "status": "success",
  "files_created": [
    "Middleware/GlobalExceptionMiddleware.cs",
    "Exceptions/AppException.cs",
    "Models/ErrorResponse.cs"
  ],
  "packages_added": [],
  "registration_code": "app.UseMiddleware<GlobalExceptionMiddleware>();",
  "message": "Configured global exception handling"
}

Reference Links

• ASP.NET Core Error Handling
• FastAPI Handling Errors
• RFC 7807 Problem Details